Инструкции, описания, доработки

h1. Как работает автоматическая обработка заказов из почты

*Последнее обновление:* 23.07.2026

Задачи: #1642, #1647

Письма, которые приходят на адрес <code>orders2onec@akmash.ru</code>, теперь обрабатываются автоматически: система сама читает письмо, определяет контрагента и менеджера и создаёт «Заказ покупателя» в 1С — без ручного ввода.

h2. Как это работает, шаг за шагом

# Письмо с заказом отправляется (или пересылается) на <code>orders2onec@akmash.ru</code>.

# Система забирает письмо, читает тему, текст и вложения.

# Определяет, от какого контрагента заказ и какой ИНН указан (при этом ИНН не путается с ОГРН, даже если оба реквизита есть в письме рядом).

# Ищет в тексте письма менеджера, на которого нужно назначить заказ — по имени/фамилии в начале письма, сверяет со списком действующих менеджеров.

# Создаёт документ «Заказ покупателя» в 1С, прикладывая к нему текст письма и все вложения с оригинальными именами файлов (в т.ч. кириллическими).

# Присылает ответ на почту — вам и ответственному администратору — с результатом.

h2. Что вы получите в ответ

*Если заказ создан успешно* — письмо с номером и датой документа в 1С, а также с тем, как система распознала контрагента (включая ИНН) и менеджера. К письму прикладывается оригинал письма целиком (файл .eml) — его можно открыть в почтовом клиенте и увидеть исходное сообщение со всеми вложениями, как оно пришло изначально.

*Если контрагента или менеджера не удалось распознать* — заказ в 1С всё равно будет создан, но с пустым полем контрагента и/или менеджера. В письме-ответе это будет видно — реквизиты нужно будет донести и заполнить в 1С вручную.

*Если заказ не создался вовсе* (техническая ошибка на стороне 1С) — придёт письмо с пояснением, что пошло не так.

*Примечание:* Ответ приходит не мгновенно — обработка занимает от нескольких секунд до пары минут (зависит от загруженности сервера с ИИ-моделью).

h2. Важно для корректной работы

* *Менеджера указывайте в начале письма*, отдельной строкой, до основного текста (например «Иванов» или «Иванова Мария») — не в подписи в конце. Так система вернее его определит.

* *Реквизиты контрагента* (наименование, ИНН) должны присутствовать в тексте письма или в теле пересылаемого письма от клиента.

* Обрабатываются только письма *с разрешённых доменов*. Если письмо пришло с незнакомого/внешнего домена — заказ автоматически не создаётся, ответственный администратор получает об этом уведомление и разбирается вручную.

* Вложения (сканы, документы, скриншоты) сохраняются вместе с заказом в 1С автоматически, с оригинальным именем файла (в т.ч. кириллическим) — прикладывать их отдельно не нужно.

h2. Если что-то пошло не так

Если письмо-результат не пришло вовсе, или заказ создался с ошибкой, или данные распознаны неверно — сообщите ответственному за автоматизацию (администратору), приложив тему письма и, по возможности, дату/время отправки. Он сможет посмотреть детальный лог обработки этого письма.

*Совет:* Система не заменяет проверку менеджером — при сомнениях в правильности распознавания контрагента, ИНН или суммы заказа стоит свериться с заказом в 1С до дальнейшей обработки.

h2. Контрагент не найден

Если при автоматическом создании заказа покупателя контрагент не найден по ИНН, система подставит вместо него служебного контрагента *«НЕ НАЙДЕН!!!!»*.

Это означает, что переданный ИНН не совпал ни с одним контрагентом в базе. Заказ всё равно создаётся (чтобы не терять данные), но требует ручной проверки: нужно найти или завести правильного контрагента и переоформить заказ на него.