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

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

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

Задача: #1642

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

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

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

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

# Определяет, от какого контрагента заказ и какой ИНН указан.

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

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

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

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

*Если заказ создан успешно* — письмо с номером и датой документа в 1С, а также с тем, как система распознала контрагента и менеджера.

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

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

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

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

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

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

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

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

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

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

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

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

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

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