С 1 сентября 2026 года электронная транспортная накладная (ЭТрН) обязательна по 87-ФЗ. Написали модуль, который создаёт её автоматически при подтверждении заказа на перевозку и обменивается статусами с оператором ЭДО — и успели до дедлайна, хоть и не с первой попытки.
Первая версия — по общему описанию
Публичное описание протокола формулировало обмен в общих чертах, и первая реализация строилась на разумных предположениях: свой тип документа, отдельное поле статуса, набор действий на будущее — подпись со стороны перевозчика и грузополучателя. Отправка тестового документа в песочницу оператора вернула отказ: часть предположений не подтвердилась.
Вторая — по подтверждённой схеме
Разобрали реальный протокол по официальной документации: правильный тип документа, три последовательных вызова — генерация вложения по установленному формату, запись документа, затем подготовка и выполнение действия с сертификатом подписанта, — а статус перевозки читается по коду документа, а не по выдуманному полю. Кнопка отправки оставалась заблокированной, пока новую реализацию не проверили в песочнице оператора: гадать второй раз было нельзя.
Экспедиторы
Отдельно добавили два варианта работы с экспедиторами. Если экспедитор просто участвует в перевозке по тому же заказу — он передаётся дополнительным участником в тот же документ, второй не создаётся. Если по факту перевозку выполняет субподрядчик — на заказе можно создать связанный заказ на закупку фактическому перевозчику: он синхронизируется с оператором независимо, а связь между заказами используется для расчёта себестоимости и маржи.
Итог
Модуль подключён к боевому обмену: автосоздание — по флагу категории товара, статусы — по расписанию. Первая версия оказалась рабочим черновиком, а не готовым решением, но так бывает, когда документация неполна, — важно проверить предположения в песочнице прежде, чем документ реально уезжает контрагенту.