Перейти к основному содержимому

Обработка в ГИС ЭПД

С 1 сентября 2025 года вступил в силу Федеральный закон от 07.06.2025 № 140-ФЗ, устанавливающий обязательный порядок передачи электронных перевозочных документов (ЭПД) в государственную информационную систему Министерства транспорта РФ (ГИС ЭПД). Все участники перевозки обязаны направлять в ГИС ЭПД через оператора ЭДО сведения об оформлении, изменении и прекращении действия перевозочных документов.

к сведению

Подробная информация о cистеме прослеживаемости приведена на сайте сервиса Логистики.

Диадок автоматически обменивается данными с ГИС ЭПД при работе со следующими документами:

Порядок работы

Сценарий работы с перевозочными документами включает следующие шаги:

  • Отправитель (грузоотправитель, перевозчик):
    • формирует титул отправителя ЭПД,
    • подписывает и отправляет его получателю.
  • Получатель (грузополучатель, заказчик):
    • получает титул отправителя,
    • при необходимости формирует, подписывает и отправляет отправителю ответный титул.
  • Наблюдатель:
    • получает титулы и подписи к ним (доступно для заказа-заявки, поручения экспедитору, экспедиторской расписки и складской расписки),
    • следит за статусом документооборота.
  • Оператор ЭДО:
    • направляет перевозочный документ в ГИС ЭПД,
    • получает от ГИС ЭПД промежуточные и конечные статусы обработки,
    • предоставляет участникам информацию о статусах и QR-коды.
  • Участники перевозки:
    • узнают статус обработки документа в ГИС ЭПД,
    • при необходимости получают QR-код, сформированный ГИС ЭПД; водители предъявляют этот QR-код при проверках ГИБДД.

Для перевозочных документов недоступно аннулирование: отправить предложение об аннулировании по ним нельзя. Такой запрос вернет ошибку 400 (Bad Request).

Статусы обработки

Статус обработки перевозочного документа можно получить с помощью методов для работы с событиями, документами и сообщениями или с помощью методов для работы с документооборотом.

Получение через методы для работы с событиями, документами и сообщениями

Информация о статусах возвращается в структуре OuterDocflowInfo.

Пример структуры OuterDocflowInfo:

"OuterDocflow": {
"DocflowNamedId": "KlMt",
"DocflowFriendlyName": "ГИС ЭПД",
"Status": {
"NamedId": "4000211000",
"FriendlyName": "Принят новый перевозочный документ",
"Type": "Success",
"Details": [
{
"Code": "mt-id",
"Text": "70fb9980-2e62-4afe-b4af-3e0dd765595e"
},
{
"Code": "mt-rid",
"Text": "2d7e3e3f-bf12-4533-acca-f3843d347d6a"
}
]
}
}

Получение через методы для работы с документооборотом

Информация о статусах возвращается в структурах:

  • OuterDocflow — содержит информацию о последнем полученном статусе,
  • OuterDocflowEntities — содержит информацию обо всех полученных статусах; в зависимости от сущности она хранится внутри других структур:
    • для документа — в структуре DocflowV4,
    • для запроса на аннулирование — в структуре RevocationDocflowV4.

Пример структуры OuterDocflows:

"OuterDocflows": [
{
"DocflowNamedId": "KlMt",
"ParentEntityId": "36dc5a6e-f9f0-4d59-93ff-0ec24ca01e37",
"OuterDocflowEntityId": "4cdabc87-1c29-4a4f-b4f0-ad95044ba5ec"
}
],

Пример структуры OuterDocflowEntities:

{
"OuterDocflowEntities": [
{
"DocflowNamedId": "KlMt",
"DocflowFriendlyName": "ГИС ЭПД",
"StatusEntities": [
{
"Attachment": {
"Attachment": {
"Entity": {
"EntityId": "c50b938b-6195-4e3e-98ad-d21192524033",
"CreationTimestamp": {
"Ticks": 639056382500691759
},
"Content": {
"Size": 218
}
},
"AttachmentFilename": "f5a23cd5-b0e7-460a-ad2a-f18ecab0f0f6.json",
"DisplayFilename": ""
},
"ContentTypeId": ""
},
"Status": {
"NamedId": "4000211000",
"FriendlyName": "Принят новый перевозочный документ",
"Type": "Success",
"Details": [
{
"Code": "mt-id",
"Text": "3099bfcb-c134-4a39-b524-0d429615d5b1"
},
{
"Code": "mt-rid",
"Text": "f5a23cd5-b0e7-460a-ad2a-f18ecab0f0f6"
}
]
}
},
{
"Attachment": {
"Attachment": {
"Entity": {
"EntityId": "9fe0d521-7dc3-401a-ab4f-2c80ec43e632",
"CreationTimestamp": {
"Ticks": 639056384220535191
},
"Content": {
"Size": 218
}
},
"AttachmentFilename": "3472763e-3aa4-42b8-a40d-907215c48040.json",
"DisplayFilename": ""
},
"ContentTypeId": ""
},
"Status": {
"NamedId": "4000211000",
"FriendlyName": "Принят новый перевозочный документ",
"Type": "Success",
"Details": [
{
"Code": "mt-id",
"Text": "3099bfcb-c134-4a39-b524-0d429615d5b1"
},
{
"Code": "mt-rid",
"Text": "3472763e-3aa4-42b8-a40d-907215c48040"
},
{
"Code": "entity-id",
"Text": "978780c4-c893-47e8-88e0-af54acf579b9"
}
]
}
},
{
"Attachment": {
"Attachment": {
"Entity": {
"EntityId": "432e1f2a-a7dd-453c-ae67-29643fb12030",
"CreationTimestamp": {
"Ticks": 639056384343916856
},
"Content": {
"Size": 33155
}
},
"AttachmentFilename": "qr-d504153d-6b27-45a4-9597-ac2aef7c766b.gif",
"DisplayFilename": ""
},
"ContentTypeId": ""
},
"Status": {
"NamedId": "QR",
"FriendlyName": "Получен QR-код",
"Type": "Normal",
"Description": "Данные QR можно скачать в виде файла с расширением .gif",
"Details": []
}
}
]
}
]
}

Информация о статусе обработки

В поле StatusDetails хранятся дополнительные данные об ЭПД в виде пользовательских данных:

  • mt-id — уникальный идентификатор (УИД) документа, который присваивается при успешной регистрации (MintransId).
  • mt-rid — идентификатор запроса в ГИС ЭПД, предназначенный для отслеживания документа (RequestId).
  • kl-id — внутренний идентификатор перевозки Диадок.Логистики.

Обратите внимание, что структуры OuterDocflowInfo, OuterDocflow и OuterDocflowEntities могут содержать информацию не только об обработке ГИС ЭПД, но и о других внешних документооборотах. Отличить статусы ГИС ЭПД можно по идентификатору DocflowNamedId = KIMt. Другие значения статусов описаны в таблицах ниже и сгруппированы по этапам обработки.

Статусы входного шлюза (1000xxxxxxxx)

КодStatus.TypeStatus.NamedIdStatus.FriendlyName
1000211050InfoSaveFilesSuccessУспешное сохранение файлов
1000411000ErrorEqualNamesЭПД и подпись имеют одинаковые имена
1000411050ErrorFileIsEmptyПустой файл
1000411100ErrorFileTooLargeРазмер файла превышает 1 МБ
1000411150ErrorFileExtensionNotXmlФайл должен иметь расширение .xml
1000411200ErrorSignatureFileTooLargeРазмер подписи превышает 300 КБ
1000411250ErrorOperatorNotFoundОператор отсутствует в БД
1000411300ErrorOperatorIsNotActiveНеактивный оператор
1000411400ErrorUnknownTitleTypeНеизвестный тип документа
1000411405ErrorFileNotXmlФайл не соответствует формату XML
1000411410ErrorFileNameNotMatchMaskИмя файла не соответствует формату
1000411450ErrorUidIsNotInPoolУИД отсутствует в пуле УИД
1000411500ErrorUidIsUsedУИД уже использован
1000411550ErrorUidParsingFailedНеверный формат УИД в XML
1000411600ErrorMissingUidInXmlНевозможно определить УИД из XML
1000411650SuccessDuplicateФайл является дубликатом
1000411700ErrorFileCreationErrorНарушение правил формирования файла

Статусы сервиса валидации (2000xxxxxxxx)

КодStatus.TypeStatus.NamedIdStatus.FriendlyName
2000211100SuccessValidationPassedВалидация пройдена успешно
2000411000ErrorXmlNotValidXML не соответствует XSD схеме
2000411050ErrorSignatureNotValidНевалидная подпись

Статусы сервиса агрегации (4000xxxxxxxx)

КодStatus.TypeStatus.NamedIdStatus.FriendlyName
4000211000SuccessTitleReceivedПринят новый документ
4000211050SuccessAggregationSuccessАгрегация пройдена успешно
4000211101ErrorFileCameOutOfOrderНарушена последовательность файлов
4000211110ErrorWrongReferencesНеверные ссылки в титулах
4000211150WarningWrongChainНеверная цепочка
4000211170ErrorWrongEpidReferencesНеверная связь между документами
4000411200ErrorFixDifferenceValidationFailedНедопустимые исправления
4000411160ErrorWrongDataНеверные данные в файле

QR-коды перевозочных документов

QR-код перевозочного документа — двумерный штрихкод, который содержит ссылку на зарегистрированный в ГИС ЭПД электронный перевозочный документ. Этот штрих-код предоставляется системой ГИС ЭПД и используется для:

  • быстрой проверки документов сотрудниками ГИБДД без ручного ввода УИД,
  • подтверждения подлинности: QR-код генерируется только для действующих документов в ГИС ЭПД,
  • получения оперативной информации о статусе перевозки и документе.

Сценарий использования QR-кода:

  • Водитель:
    • предъявляет распечатанную ЭТрН с QR-кодом или QR-код на экране мобильного устройства.
  • Сотрудник ГИБДД:
    • сканирует QR-код через служебное мобильное приложение и получает информацию о документе из ГИС ЭПД,
    • проверяет соответствие данных в системе и фактического груза, данные о водителе и транспортном средстве, статус документа — он должен быть не отозван и не аннулирован.

Чтобы получить QR-код через API Диадока, используйте метод GetEntityContent (V4): в качестве параметра EntityId передайте значение из вложения Attachment события с NamedId = QR. QR-код хранится как бинарное содержимое GIF-файла, привязанное к сущности статуса. Обратите внимание, что QR-код будет доступен для получения только после присвоения документу статуса QR.

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года