Интеграция — не кнопка «отправить». Это управляемый процесс, который сохраняет связь документа с учётной операцией, проверяет формат до подписи и возвращает каждый технологический статус в систему.
Три уровня интеграции
| Подход | Подходит | Основной риск |
|---|---|---|
| Веб-интерфейс оператора | Небольшой объём, пилот, редкие документы | Повторный ввод и расхождение с учётом |
| Готовый модуль учётной системы | Типовые процессы и стандартная конфигурация | Обновления модуля и конфигурации расходятся |
| API или интеграционная шина | Большой объём, несколько систем и сложные маршруты | Организация отвечает за логику повторов, статусов и мониторинга |
Начинать полезно с минимального сквозного сценария. Автоматизируйте один вид документа и ограниченную группу контрагентов, но сразу стройте промышленную модель идентификаторов, ошибок и архива.
Что должно быть связано в данных
- внутренний идентификатор хозяйственной операции;
- организация, подразделение и контрагент с проверенными ИНН/КПП;
- тип, функция и версия формата документа;
- идентификаторы пакета, документа и сообщения у оператора;
- подписант, сертификат и применяемая МЧД;
- исходный электронный оригинал и его контрольная сумма;
- последовательность статусов, квитанций, ошибок и действий пользователей.
Исходящий поток
Входящий поток
- Сохраните полученный оригинал, подпись и транспортные сообщения до бизнес-обработки.
- Проверьте целостность, формат, подпись и полномочия; транспортная доставка не означает принятие к учёту.
- Найдите организацию, договор, заказ или поставку по устойчивому набору реквизитов.
- Не найденное соответствие направьте в очередь разбора, а не создавайте контрагента автоматически без контроля.
- Разделите техническое подтверждение получения и содержательное подписание либо отказ.
- Запишите результат в учётную систему и отправьте предусмотренное ответное сообщение.
Как не потерять и не задвоить документ
Одна операция — один ключ
Тайм-аут не доказывает, что отправка не состоялась. Сначала запрашивают результат по ключу, затем решают вопрос о повторе.
Каждый этап измерим
Контролируются возраст очереди, документы без финального статуса, ошибки формата, подписи и сопоставления.
| Ситуация | Безопасное действие |
|---|---|
| API вернул тайм-аут | Проверить состояние по ключу; не создавать новый документ автоматически |
| Формат не прошёл контроль | Сохранить ошибку и исходные данные, исправить генератор, сформировать новую версию |
| Статус давно не меняется | Сопоставить локальный и операторский журналы, проверить маршрут и эскалировать с идентификаторами |
| Пришёл повтор уведомления | Подтвердить уже обработанное событие без повторной проводки |
| Изменился формат | Версионировать генератор и валидатор, провести регрессию на архивных примерах |
Безопасный запуск
Опишите владельцев, виды документов, контрагентов, статусы и исключения.
Проверьте положительные и отрицательные сценарии, роуминг, истёкший сертификат, неверный формат и повтор.
Запустите выбранную группу, ежедневно сверяйте учёт, кабинет оператора и архив.
Зафиксируйте SLO, оповещения, поддержку, восстановление и порядок обновления форматов.
ФНС ведёт перечень утверждённых форматов и публикует XSD и сопутствующие материалы. Проверяйте именно действующую редакцию и переходные сроки: наличие поддержки формата у оператора не отменяет регрессионное тестирование вашей интеграции.
Итог
Надёжная интеграция сохраняет электронный оригинал, не создаёт дубли при повторах, различает транспортный и бизнес-статус и позволяет восстановить историю любого документа.
Официальные источники
- ФНС: перечень утверждённых форматов
- ФНС: технологии и материалы для операторов ЭДО
- ФНС: обязанности и сервисы операторов B2B
- ФНС: база знаний по электронному документообороту
- Приказ ФНС № ЕД-7-26/546@
Конкретные методы API, ограничения и способы уведомлений определяются документацией выбранного оператора. Юридические требования и версии форматов сверяйте с официальными источниками.