API-интеграция ЭПД с TMS и ERP: архитектура без ручных разрывов
Интеграция ЭПД является событийным процессом, а не однократной выгрузкой XML. Система должна создавать, получать, подписывать, обновлять и контролировать документы на протяжении рейса.
Короткий ответ
Архитектура начинается с сквозных идентификаторов заказа, рейса, груза и документа. Затем определяются команды и события, границы подписи, обработка повторов, очередь ошибок и наблюдаемость.
Оптимальная интеграция не прячет операторский статус. Она переводит его в понятное бизнес-действие и сохраняет техническую трассировку для поддержки.
Модель данных и идентификаторы
Связь между заказом, рейсом, перевозкой и документом должна переживать повторную отправку, изменение и обмен через разных операторов.
- Внутренний идентификатор заказа
- Идентификатор рейса или плеча
- Идентификатор документа оператора
- Версия и связь исправлений
Команды и события
Разделяйте намерение системы и подтвержденный результат оператора. Отправка запроса еще не означает доставку или подписание документа.
- Создать или обновить черновик
- Отправить на подпись и передачу
- Получить новый титул или статус
- Завершить, исправить или обработать отказ
Надежность и наблюдаемость
Сеть и внешние системы дают повторы и задержки. Интеграция должна безопасно повторять операции, видеть очередь и позволять восстановить хронологию.
- Идемпотентные запросы
- Повтор с ограничением и отложенной очередью
- Корреляционные идентификаторы
- Метрики задержки, ошибок и ручных вмешательств
Чек-лист
Используйте пункты как основу для рабочей встречи. У каждого действия должны быть ответственный и срок.
- Описать доменную модель и идентификаторы
- Согласовать контракт API оператора
- Разделить команды и подтвержденные события
- Реализовать идемпотентность
- Настроить очередь ошибок и мониторинг
- Протестировать задержку, повтор и недоступность
Частые вопросы
Достаточно периодической выгрузки файлов?
Для простого потока возможно, но жизненный цикл ЭПД включает встречные титулы и статусы. При большом объеме событийная интеграция обычно надежнее.
Где выполнять электронную подпись?
Граница зависит от решения оператора, требований безопасности и ролей. Подпись не следует бездумно переносить в серверный процесс без контроля полномочий.
Как избежать дублей?
Использовать устойчивые идентификаторы, идемпотентные команды и хранить связь каждого ответа оператора с исходной операцией.
Официальные источники
Материал актуализирован 18 июля 2026 года. Перед изменением юридически значимого процесса сверяйте последние редакции документов.