Перевозочные документы

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

Примечание

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

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

ЭТрН — электронная транспортная накладная,
ЭПЛ — электронный путевой лист,
Э33 — заказ-заявка.

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

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

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

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

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

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

Методы работы с сообщениями и событиями возвращают все полученные статусы:
Методы работы с документами возвращают последний полученный статус:

Информация о статусах возвращается в структуре 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 — содержит информацию обо всех полученных статусах; в зависимости от сущности она хранится внутри других структур:
- для документа — в структуре DocflowV3 или DocflowV4,
- для запроса на аннулирование — в структуре RevocationDocflowV3 или 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.

Перевозочные документы

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

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

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

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

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

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