Обработка в ГИС ЭПД
С 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.Type | Status.NamedId | Status.FriendlyName |
|---|---|---|---|
| 1000211050 | Info | SaveFilesSuccess | Успешное сохранение файлов |
| 1000411000 | Error | EqualNames | ЭПД и подпись имеют одинаковые имена |
| 1000411050 | Error | FileIsEmpty | Пустой файл |
| 1000411100 | Error | FileTooLarge | Размер файла превышает 1 МБ |
| 1000411150 | Error | FileExtensionNotXml | Файл должен иметь расширение .xml |
| 1000411200 | Error | SignatureFileTooLarge | Размер подписи превышает 300 КБ |
| 1000411250 | Error | OperatorNotFound | Оператор отсутствует в БД |
| 1000411300 | Error | OperatorIsNotActive | Неактивный оператор |
| 1000411400 | Error | UnknownTitleType | Неизвестный тип документа |
| 1000411405 | Error | FileNotXml | Файл не соответствует формату XML |
| 1000411410 | Error | FileNameNotMatchMask | Имя файла не соответствует формату |
| 1000411450 | Error | UidIsNotInPool | УИД отсутствует в пуле УИД |
| 1000411500 | Error | UidIsUsed | УИД уже использован |
| 1000411550 | Error | UidParsingFailed | Неверный формат УИД в XML |
| 1000411600 | Error | MissingUidInXml | Невозможно определить УИД из XML |
| 1000411650 | Success | Duplicate | Файл является дубликатом |
| 1000411700 | Error | FileCreationError | Нарушение правил формирования файла |
Статусы сервиса валидации (2000xxxxxxxx)
| Код | Status.Type | Status.NamedId | Status.FriendlyName |
|---|---|---|---|
| 2000211100 | Success | ValidationPassed | Валидация пройдена успешно |
| 2000411000 | Error | XmlNotValid | XML не соответствует XSD схеме |
| 2000411050 | Error | SignatureNotValid | Невалидная подпись |
Статусы сервиса агрегации (4000xxxxxxxx)
| Код | Status.Type | Status.NamedId | Status.FriendlyName |
|---|---|---|---|
| 4000211000 | Success | TitleReceived | Принят новый документ |
| 4000211050 | Success | AggregationSuccess | Агрегация пройдена успешно |
| 4000211101 | Error | FileCameOutOfOrder | Нарушена последовательность файлов |
| 4000211110 | Error | WrongReferences | Неверные ссылки в титулах |
| 4000211150 | Warning | WrongChain | Неверная цепочка |
| 4000211170 | Error | WrongEpidReferences | Неверная связь между документами |
| 4000411200 | Error | FixDifferenceValidationFailed | Недопустимые исправления |
| 4000411160 | Error | WrongData | Неверные данные в файле |
QR-коды перевозочных документов
QR-код перевозочного документа — двумерный штрихкод, который содержит ссылку на зарегистрированный в ГИС ЭПД электронный перевозочный документ. Этот штрих-код предоставляется системой ГИС ЭПД и используется для:
- быстрой проверки документов сотрудниками ГИБДД без ручного ввода УИД,
- подтверждения подлинности: QR-код генерируется только для действующих документов в ГИС ЭПД,
- получения оперативной информации о статусе перевозки и документе.
Сценарий использования QR-кода:
- Водитель:
- предъявляет распечатанную ЭТрН с QR-кодом или QR-код на экране мобильного устройства.
- Сотрудник ГИБДД:
- сканирует QR-код через служебное мобильное приложение и получает информацию о документе из ГИС ЭПД,
- проверяет соответствие данных в системе и фактического груза, данные о водителе и транспортном средстве, статус документа — он должен быть не отозван и не аннулирован.
Чтобы получить QR-код через API Диадока, используйте метод GetEntityContent (V4): в качестве параметра EntityId передайте значение из вложения Attachment события с NamedId = QR. QR-код хранится как бинарное содержимое GIF-файла, привязанное к сущности статуса. Обратите внимание, что QR-код будет доступен для получения только после присвоения документу статуса QR.