1. Транспортный ЭДО (ЭТрН) пошаговый алгоритм действий в ERP и Контур.Логистика API

ЭТАП 1. ПОГРУЗКА (ГРУЗООТПРАВИТЕЛЬ → ПЕРЕВОЗЧИК)
Формирование и отправка Титула грузоотправителя Т1, получение подтверждения от перевозчика Т2

Данный этап является стартовым для всего документооборота ЭТрН. Без успешно подписанного Т1 перевозка не может быть начата.

ШАГ 1. ПРОВЕРКА ИСХОДНЫХ ДАННЫХ В ERP

Перед формированием Т1 ERP должна убедиться в наличии обязательных реквизитов:

1.1. Контрагенты:

Грузоотправитель (сама организация или иное лицо):
ИНН, КПП (для юрлиц)
‘DiadocBoxId’ — идентификатор ящика в Диадоке
Адрес в структурированном виде (ФИАС или детальный почтовый адрес)
Перевозчик:
ИНН, КПП
‘DiadocBoxId’
Грузополучатель:
ИНН, КПП
‘DiadocBoxId’
Адрес доставки
Лицо, осуществляющее погрузку (ЛОП) — если отличается от грузоотправителя:
Полные реквизиты (юрлицо/ИП) или ФИО + ИНН физлица

1.2. Транспорт и водитель:

Тягач: регистрационный номер, марка, VIN/СТС (опционально)
Прицеп (при наличии): регистрационный номер, марка
Водитель: ФИО, ИНН физлица, номер водительского удостоверения + серия + дата выдачи, телефон

1.3. Груз:

Отгрузочное наименование (коммерческое описание)
Количество грузовых мест
Масса брутто (кг) и/или нетто
Объем (м³) — при необходимости
Код ТН ВЭД — для импортных/экспортных грузов
Признак опасного груза (ДОПОГ) — если применимо
Объявленная стоимость (ценность) — при наличии

1.4. Документ-основание:

Номер и дата заказа (заявки) — подставляются в блок ‘<СодИнфГО>’

ШАГ 2. ПОЛУЧЕНИЕ УНИКАЛЬНОГО ИДЕНТИФИКАТОРА ДОКУМЕНТА (УИД) ОТ МИНТРАНСА

Метод API: ‘GET /v1/mintransgateway/uuid’

Действие ERP:

Выполнить HTTP-запрос с заголовком ‘x-kontur-apikey’
В ответе получить UUID — УИД_ТрН

Важно:

УИД имеет срок жизни 3 месяца
На организацию действует лимит 100 неподтвержденных УИД (подтверждение = отправка подписанного Т1 с этим УИД)
При превышении лимита метод вернет ‘404 Not Found’
Рекомендуется получать УИД непосредственно перед формированием XML, не хранить его в ERP долго

ШАГ 3. ПОЛУЧЕНИЕ FNSID УЧАСТНИКОВ ПЕРЕВОЗКИ

Метод API: ‘GET /v1/organizations/requisites?inn={ИНН}&kpp={КПП}’

Действие ERP:

Для каждого участника (Перевозчик, Грузополучатель, ЛОП) выполнить запрос
Извлечь из ответа поле ‘fnsParticipantId’
Если у организации несколько филиалов (разные КПП) — выбрать нужный по КПП

Назначение FNSId:

Формирование имени файла XML
Заполнение атрибута ‘ИдФайл’ в теге ‘<Файл>’
Идентификация участника в роуминге ФНС

ШАГ 4. ФОРМИРОВАНИЕ XML-ФАЙЛА ТИТУЛА Т1

Основание: Приказ ФНС РФ от 09.12.2021 № ЕД-7-26/1065@, XSD-схема ‘ON_TRNACLGROT’

В ERP реализуется конструктор XML со следующими блоками:

4.1. Заголовок файла (ИдФайл)
Формируется по шаблону:
‘ON_TRNACLGROT_FNSIdПеревозчикаFNSIdГрузополучателя_FNSIdЛОП_0ГГГГММДД_УИД’
Пример:
‘ON_TRNACLGROT_2BM-1234567890-123401001-202501011200000000000_2BM-0987654321-098401001-202501011205000000000_2BM-1122334455-112401001-202501011210000000000_0_20250115_a1b2c3d4-1234-5678-90ab-cdef12345678’

4.2. Сведения о перевозке (СодИнфГО)

УИД_ТрН — UUID, полученный на шаге 2
Номер ТрН — внутренний номер накладной в ERP (опционально)
Дата ТрН — дата формирования
Номер заказа (заявки) — номер документа-основания
Дата заказа — дата документа-основания

4.3. Участники перевозки (СвУчаст)
Грузоотправитель (ГрузОтпр):

Полное наименование / ФИО
ИНН, КПП
Адрес (структурно: индекс, регион, город, улица, дом и т.д.)
Признак экспедитора (true/false)

Грузополучатель (ГрузПолуч):

Полное наименование / ФИО
ИНН, КПП
Адрес доставки

Перевозчик (Перевозчик):

Полное наименование / ФИО
ИНН, КПП
Адрес

Лицо, осуществляющее погрузку (ЛОП) — заполняется, если ≠ Грузоотправитель:

Реквизиты организации/ИП/физлица
Основание полномочий (документ)

Владелец инфраструктуры погрузки (ИнфрастрПогр) — опционально

4.4. Транспортное средство и водитель (СвТС)
Тягач:

Регистрационный номер
Марка, модель
VIN (при наличии)
Тип владения (собственность, аренда, лизинг)
Документ-основание владения (при аренде/лизинге)

Прицеп (при наличии):

Аналогичный набор полей

Водитель:

ФИО (фамилия, имя, отчество)
ИНН физлица
Водительское удостоверение: серия, номер, дата выдачи
Телефон
Сведения о путевом листе (при наличии)

4.5. Сведения о грузе (СвГруз)
По каждой позиции номенклатуры:

Отгрузочное наименование
Код ТН ВЭД
Состояние груза, способ упаковки, вид тары
Количество грузовых мест
Маркировка (список)
Габариты (длина × ширина × высота), м
Объем, м³
Масса брутто, кг
Масса нетто, кг (опционально)
Объявленная стоимость (ценность): сумма, валюта (код/наименование)

Блок опасного груза (если применимо):

Номер ООН
Надлежащее отгрузочное наименование
Класс, классификационный код
Группа упаковки
Знак опасности
Код ограничения проезда через тоннели
Иные реквизиты по ДОПОГ

4.6. Сведения о погрузке (СвПогруз)

Заявленные дата и время подачи ТС — плановые
Фактические дата и время прибытия — если уже известны
Фактические дата и время убытия
Адрес места погрузки (структурно, с возможностью указать GLN и координаты)
Фактическое состояние груза, тары, упаковки
Метод определения массы груза (код: 01 — взвешивание по общей массе, 02 — поосно, 03 — расчетная)
Основание доступа к инфраструктуре (документ или текст)

4.7. Указания грузоотправителя (УказГрузОтпр)

Запрещение перегрузки
Срок доставки (дата/время или текстовое описание)
Сведения о запорно-пломбировочных устройствах
Указания по фитосанитарным, таможенным и иным требованиям
Ограничения скорости
Маршрут (текст или GeoJSON)
Климатический режим (температура, влажность)

4.8. Сопроводительные документы (ПрилДок)

Сертификаты, паспорта качества, разрешения
Документы об отгрузке
Сопроводительная ведомость (для контейнеров)

4.9. Информационные поля (ИнфПол)

Произвольные пары «ключ-значение» для дополнительных данных

4.10. Подписант (Подписант)
Статус подписанта — один из:

‘1’ — лицо, действующее от имени грузоотправителя без доверенности
‘2’ — лицо, действующее от имени грузоотправителя на основании электронной доверенности
‘3’ — лицо, действующее от имени грузоотправителя на основании бумажной доверенности
‘4’ — лицо, действующее от имени ЛОП без доверенности
‘5’ — лицо, действующее от имени ЛОП на основании электронной доверенности
‘6’ — лицо, действующее от имени ЛОП на основании бумажной доверенности

Реквизиты подписанта:

Фамилия, Имя, Отчество
Должность
Идентификатор информационной системы хранения доверенности (для МЧД)
Сведения о доверенности (номер, дата, идентификатор файла)

ШАГ 5. ПОДПИСАНИЕ XML-ФАЙЛА КЭП

Действие ERP:

Передать сформированный XML-файл в криптомодуль (CryptoPro CSP, VipNet CSP, 1С:ЭП и др.)
Получить отсоединенную электронную подпись в формате PKCS7
Сохранить подпись как отдельный файл (обычно расширение ‘.sig’)

Требования к подписи:

Сертификат: КЭП руководителя или уполномоченного сотрудника
Действие доверенности (МЧД) должно быть подтверждено на момент подписания
Алгоритм: ГОСТ Р 34.10-2012

Важно:

Без файла подписи титул считается черновиком
Черновик не имеет юридической силы и не отправляется контрагенту автоматически

ШАГ 6. ОТПРАВКА ТИТУЛА Т1 В КОНТУР.ЛОГИСТИКА

Метод API: ‘POST /v1/transportations/documents’

Параметры запроса:

‘transportationId’ — НЕ ПЕРЕДАЕТСЯ (при первой отправке создается новая перевозка)
‘diadocBoxId’ — идентификатор ящика отправителя (из справочника ERP)
‘replaceAttachments’ — ‘false’ (обычно)

Тело запроса: ‘multipart/form-data’

‘formFiles[0]’ — XML-файл Т1
‘formFiles[1]’ — файл подписи (.sig)

Ответ API (200 OK):
‘json
{
«transportationId»: «b61f1e8e-509a-4610-a040-feca00de46f7»,
«titleId»: «a7c2d3e4-5678-90ab-cdef-1234567890ab»,
«warnings»: null
}
‘

Действие ERP:

Сохранить полученный ‘transportationId’ в регистре обмена
Связать ‘transportationId’ с документом-основанием (заказ, реализация)
Запомнить ‘titleId’ отправленного Т1

ШАГ 7. КОНТРОЛЬ СТАТУСА И ПОЛУЧЕНИЕ ПОДТВЕРЖДЕНИЯ ОТ ПЕРЕВОЗЧИКА (Т2)

7.1. Опрос ленты событий
Метод API: ‘GET /v1/transportations/events’

Параметры:

‘FromId’ — идентификатор последнего обработанного события
‘DiadocBoxId’ — ящик организации

Действие ERP (фоновое задание, периодичность 5-10 минут):

Выполнять запрос к API
Искать события с ‘transportationId’, соответствующим сохраненным в ERP 7.2. Обработка события DocumentSignedByRecipient
Когда перевозчик подписывает Титул Т2, в ленте появляется событие:

‘json
{
«id»: «evt_98765»,
«transportationId»: «b61f1e8e-509a-4610-a040-feca00de46f7»,
«dateTimeUtc»: «2026-02-12T10:30:00Z»,
«eventType»: «DocumentSignedByRecipient»,
«details»: {
«detailsExtended»: {
«documentSignedByRecipientEventDetails»: {
«documentId»: «d4e5f6a7-8901-bc23-def4-567890abcdef»,
«documentType»: «CarrierReceptionTitle»,
«signedBy»: «…»,
«isSignatureValid»: true
}
}
}
}
‘

Действие ERP:

Найти заказ/реализацию по ‘transportationId’
Обновить статус ЭТрН: «Принято перевозчиком», «Груз передан», «В пути»
Зафиксировать дату и время подписания
При необходимости — сохранить ‘titleId’ Т2 для последующих этапов (Т3, Т4) 7.3. Обработка отказа (SignatureRejectByRecipient)
Если перевозчик отказался подписывать:
ERP получает событие с ‘documentType: «RejectTitle»‘
Статус документа в ERP: «Отказ в приеме груза»
Инициируется бизнес-процесс разбирательства (вне интеграции)