Работа с ЭТрН

Порядок обмена электронными транспортными накладными (ЭТрН) описан на странице Документооборот ЭТрН. Базовый алгоритм работы с формализованными документами приведен в разделе Работа с формализованными документами. Особенности сценариев работы с документом зависит от вида документооборота для его формата.

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

Грузоотправитель:
- формирует титул грузоотправителя (Т1),
- подписывает и отправляет Т1.
Перевозчик:
- формирует титул перевозчика о приеме груза (Т2),
- подписывает и отправляет Т2,
- формирует титул переадресации (Т7) — если в процессе перевозки изменился адрес груза,
- подписывает и отправляет Т7 — если в процессе перевозки изменился адрес груза,
- формирует титул эстафеты (Т8) — если в процессе перевозки изменился водитель, прицеп или транспортное средство (ТС),
- подписывает и отправляет Т8 — если в процессе перевозки изменился водитель, прицеп или ТС.
Грузоотправитель:
- формирует титул грузополучателя (Т3),
- подписывает и отправляет Т3.
Перевозчик:
- формирует титул перевозчика о выдаче груза (Т4),
- подписывает и отправляет Т4,
- формирует титул перевозчика о стоимости (Т5) — при необходимости,
- подписывает и отправляет Т5 — при необходимости.
Грузоотправитель:
- формирует титул грузоотправителя о стоимости (Т6) — при необходимости,
- подписывает и отправляет Т6 — при необходимости.

Титул грузоотправителя (Т1)

Формирование Т1

Сформируйте XML-файл Т1 в соответствии с Приказом ФНС России от 09.12.2021 № ЕД-7−26/1065@ и XSD-схемой.
С помощью метода GetOrganization получите по ИНН или ИНН-КПП FNSId организаций-участников перевозки.
Заполните в теге Файл имя файла ИдФайл, используя полученные FNSId. Описание имени файла доступно в разделе Формат имени файла ЭТрН.

Примечание

Не заполняйте тег УИД_ТрН при формировании Т1. Идентификатор будет установлен системой после отправки ЭТрН и отразится в OuterDocflow. Подробнее об обработке перевозочных документов в разделе Информация о статусе обработки.

Пример имени файла в Т1:

<Файл ИдФайл="ON_TRNACLGROT_2BM-9637075900-963701000-202106051207026941416_2BM-9663613696-966301000-202107201044553790120_2BM-9642247008-964201000-202107220855369311399_0_20230411_ade0560b-390e-4e5d-ade6-7656f6195129" ВерсПрог="1.0" ВерсФорм="5.01">

Отправка Т1

Сформированный и подписанный Т1 можно отправить перевозчику с помощью метода PostMessage (V3), передав его в поле DocumentAttachment структуры MessageToPost. Инструкция об отправке документа приведена в разделе Отправка документа.

Обратите внимание, что в титуле должны быть заполнены данные подписанта.

В структуре DocumentAttachment укажите данные о типе документа, полученные с помощью метода GetDocumentTypes (V3):

TypeNamedId = LogisticsWaybill
Function = reception
Version = kl_trn_mt_05_01

Пример тела запроса метода PostMessage:

{
    "FromBoxId": "{{boxId_sender}}",
    "ToBoxId": "{{boxId_recipient}}",
    "DocumentAttachments": [
        {
            "SignedContent": {
                "Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0...NC50Ls+",        // содержимое XML-файла в кодировке base-64
                "Signature": "MIIN5QYJKoZIhvcNAQcCoIIN1jCCDdIA...kA9MJfsplqgW"         // содержимое файла подписи в кодировке base-64
            },
            "TypeNamedId": "LogisticsWaybill",
            "Function": "reception",
            "Version": "kl_trn_mt_05_01"
        }
    ]
}

Титул перевозчика о приеме груза (Т2)

Формирование Т2

Сформируйте XML-файл Т2 в соответствии с Приказом ФНС России от 09.12.2021 № ЕД-7−26/1065@ и XSD-схемой.
Заполните реквизиты Т2 следующими данными:
- ИдФайлИнфГО — значение атрибута ИдФайл из корня XML-файла Т1.
- ДатФайлИнфГО — значение атрибута ДатИнфГО из XML-файла Т1.
- ВрФайлИнфГО — значение атрибута ВрИнфГО из XML-файла Т1.
- ЭП — содержимое файла подписи Т1 в кодировке base64.
- УИД_ТрН — значение mt-id из OuterDocflow зарегистрированной ЭТрН. Должно совпадать для всех титулов одной ЭТрН.

Отправка Т2

Сформированный и подписанный Т2 можно отправить с помощью метода PostMessagePatch (V4). Инструкция об отправке ответного титула приведена в разделе Отправка ответного титула.

Обратите внимание, что в титуле должны быть заполнены данные подписанта.

Титул грузополучателя (Т3)

Формирование Т3

Сформируйте XML-файл Т3 в соответствии с Приказом ФНС России от 09.12.2021 № ЕД-7−26/1065@ и XSD-схемой.
Заполните реквизиты Т3 следующими данными:
- ИдФайлИнфПрвПрием — значение атрибута ИдФайл из корня XML-файла Т2.
- ДатФайлПрвПрием — значение атрибута ДатИнфПрвПрием из XML-файла Т2.
- ВрФайлПрвПрием — значение атрибута ВрИнфПрвПрием из XML-файла Т2.
- ЭП — содержимое файла подписи Т2 в кодировке base64.
- УИД_ТрН — значение mt-id из OuterDocflow зарегистрированной ЭТрН. Должно совпадать для всех титулов одной ЭТрН.
Обязательно заполните следующие атрибуты:
- НаимГруз — отгрузочное наименование принятого груза.
- СостГруз — состояние груза, тары, упаковки, маркировки и опломбирования.

Отправка Т3

Сформированный и подписанный Т3 можно отправить перевозчику с помощью метода PostMessage (V3), передав его в поле DocumentAttachment структуры MessageToPost. Инструкция об отправке документа приведена в разделе Отправка документа.

Обратите внимание, что в титуле должны быть заполнены данные подписанта.

В структуре DocumentAttachment укажите данные о типе документа, полученные с помощью метода GetDocumentTypes (V3):

TypeNamedId = LogisticsWaybill
Function = delivery
Version = kl_trn_mt_05_01

Титул перевозчика о выдаче груза (Т4)

Формирование Т4

Сформируйте XML-файл Т4 в соответствии с Приказом ФНС России от 09.12.2021 № ЕД-7−26/1065@ и XSD-схемой.
Заполните реквизиты Т4 следующими данными:
- ИдФайлИнфГО — значение атрибута ИдФайл из корня XML-файла Т3.
- ДатФайлИнфГО — значение атрибута ДатИнфГО из XML-файла Т3.
- ВрФайлИнфГО — значение атрибута ВрИнфГО из XML-файла Т3.
- ЭП — содержимое файла подписи Т3 в кодировке base64.
- УИД_ТрН — значение mt-id из OuterDocflow зарегистрированной ЭТрН. Должно совпадать для всех титулов одной ЭТрН.

Отправка Т4

Сформированный и подписанный Т4 можно отправить с помощью метода PostMessagePatch (V4). Инструкция об отправке ответного титула приведена в разделе Отправка ответного титула.

Обратите внимание, что в титуле должны быть заполнены данные подписанта.

Титул перевозчика о стоимости (Т5)

Формирование Т5

Сформируйте XML-файл Т5 в соответствии с Приказом ФНС России от 09.12.2021 № ЕД-7−26/1065@ и XSD-схемой.
Заполните реквизиты Т5 следующими данными:
- ИдФайлПрвВыд — значение атрибута ИдФайл из корня XML-файла Т4.
- ДатФайлПрвВыд — значение атрибута ДатИнфПрвВыд из XML-файла Т4.
- ВрФайлПрвВыд — значение атрибута ВрИнфПрвВыд из XML-файла Т4.
- ЭП — содержимое файла подписи Т4 в кодировке base64.
- УИД_ТрН — значение mt-id из OuterDocflow зарегистрированной ЭТрН. Должно совпадать для всех титулов одной ЭТрН.

Отправка Т5

Сформированный и подписанный Т5 можно отправить грузоотправителю с помощью метода PostMessage (V3), передав его в поле DocumentAttachment структуры MessageToPost. Инструкция об отправке документа приведена в разделе Отправка документа.

Обратите внимание, что в титуле должны быть заполнены данные подписанта.

В структуре DocumentAttachment укажите данные о типе документа, полученные с помощью метода GetDocumentTypes (V3):

TypeNamedId = LogisticsWaybill
Function = cost
Version = kl_trn_mt_05_01

Титул грузоотправителя о стоимости (Т6)

Формирование Т6

Сформируйте XML-файл Т6 в соответствии с Приказом ФНС России от 09.12.2021 № ЕД-7−26/1065@ и XSD-схемой.
Заполните реквизиты Т6 следующими данными:
- ИдФайлПУДИнфПрв — значение атрибута ИдФайл из корня XML-файла Т5.
- ДатФайлПУДИнфПрв — значение атрибута ДатПУДИнфПрв из XML-файла Т5.
- ВрФайлПУДИнфПрв — значение атрибута ВрПУДИнфПрв из XML-файла Т5.
- ЭП — содержимое файла подписи Т5 в кодировке base64.
- УИД_ТрН — значение mt-id из OuterDocflow зарегистрированной ЭТрН. Должно совпадать для всех титулов одной ЭТрН.

Отправка Т6

Сформированный и подписанный Т6 можно отправить с помощью метода PostMessagePatch (V4). Инструкция об отправке ответного титула приведена в разделе Отправка ответного титула.

Обратите внимание, что в титуле должны быть заполнены данные подписанта.

Титул переадресации (Т7)

Перевозчик отправляет грузоотправителю Т7 при изменении адреса выгрузки или грузополучателя. Сделать это необходимо после отправки Т2 и до поступления Т3. После подписания Т7 Государственная информационная система электронных перевозочных документов (ГИС ЭПД) направляет новый QR-код перевозочного документа.

Формирование Т7

Сформируйте XML-файл Т7 в соответствии с Приказом ФНС России от 09.12.2021 № ЕД-7−26/1065@ и XSD-схемой.
Заполните реквизиты Т7 следующими данными:
- ИдФайлПрвПрием — значение атрибута ИдФайл из корня XML-файла Т2.
- ДатФайлПрвПрием — значение атрибута ДатИнфПрвПрием из XML-файла Т2.
- ВрФайлПрвПрием — значение атрибута ВрИнфПрвПрием из XML-файла Т2.
- ЭП — содержимое файла подписи Т2 в кодировке base64.
- УИД_ТрН — значение mt-id из OuterDocflow зарегистрированной ЭТрН. Должно совпадать для всех титулов одной ЭТрН.
Обязательно заполните следующие атрибуты и элементы:
- ДатВрНовВыгрПА — новые дата и время подачи транспортного средства под выгрузку.
- НалКоорТочВрВгрПА — признак применения координации точного времени (UTC).
- АдрВыгруз — новый адрес выгрузки. Внутри него обязательно должен быть заполнен один из элементов: АдресРФ, АдресИнф или КодГАР.
- ОснПА — причина смены адреса. Внутри него обязательно должен быть заполнен один из элементов: НаимДок, НомерДок, ДатаДок или ИдДок.

Отправка Т7

Сформированный и подписанный Т7 можно отправить с помощью метода PostMessage (V3), передав его в поле DocumentAttachment структуры MessageToPost. Инструкция об отправке документа приведена в разделе Отправка документа.

Обратите внимание, что в титуле должны быть заполнены данные подписанта.

В структуре DocumentAttachment укажите данные о типе документа, полученные с помощью метода GetDocumentTypes (V3):

TypeNamedId = LogisticsWaybill
Function = readdress
Version = kl_trn_mt_05_01

Титул эстафеты (Т8)

Перевозчик отправляет грузоотправителю Т8 при изменении водителя, транспортного средства, тягача или прицепа. Сделать это необходимо после отправки Т2 и до поступления Т3. После подписания Т8 ГИС ЭПД направляет новый QR-код перевозочного документа.

Формирование Т8

Сформируйте XML-файл Т8 в соответствии с Приказом ФНС России от 09.12.2021 № ЕД-7−26/1065@ и XSD-схемой.
Заполните реквизиты Т8 следующими данными:
- ИдФайлПрвПрием — значение атрибута ИдФайл из корня XML-файла Т2.
- ДатФайлПрвПрием — значение атрибута ДатИнфПрвПрием из XML-файла Т2.
- ВрФайлПрвПрием — значение атрибута ВрИнфПрвПрием из XML-файла Т2.
- ЭП — содержимое файла подписи Т2 в кодировке base64.
- УИД_ТрН — значение mt-id из OuterDocflow зарегистрированной ЭТрН. Должно совпадать для всех титулов одной ЭТрН.

Отправка Т8

Сформированный и подписанный Т8 можно отправить с помощью метода PostMessage (V3), передав его в поле DocumentAttachment структуры MessageToPost. Инструкция об отправке документа приведена в разделе Отправка документа.

Обратите внимание, что в титуле должны быть заполнены данные подписанта.

В структуре DocumentAttachment укажите данные о типе документа, полученные с помощью метода GetDocumentTypes (V3):

TypeNamedId = LogisticsWaybill
Function = relay
Version = kl_trn_mt_05_01

Получение титулов ЭТрН 

Перевозчик может найти входящие титулы ЭТрН в своем ящике с помощью чтения ленты событий или с помощью поиска. Инструкция о получении документов приведена на странице Получение документов.

Получение титулов методом GetDocuments

Чтобы найти ЭТрН с помощью метода GetDocuments (V4), передайте в теле запроса значение типа документа DocumentTypeNamedIds = LogisticsWaybill. Метод также позволяет фильтровать документы по идентификаторам Минтранса и перевозки.

Пример тела запроса метода GetDocuments с идентификатором Минтранса:

{
    "CustomData": [
        {
            "Key": "mt-id",
            "Value": "<УИД Минтранса>"
        }
    ]
}

Пример тела запроса метода GetDocuments с идентификатором перевозки:

{
    "CustomData": [
        {
            "Key": "kl-id",
            "Value": "<Идентификатор перевозки>"
        }
    ]
}

Из полученного в ответе метода списка DocumentList можно получить информацию о каждом документе. Инструкция приведена в разделе Получение сведений о документах.

Получение титулов методом SearchDocflows

Чтобы найти ЭТрН с помощью метода SearchDocflows (V4), передайте в теле запроса строку с идентификатором Минтранса или перевозки и ограничьте область поиска входящими документами.

Пример тела запроса метода SearchDocflows с идентификатором перевозки:

{
    "QueryString": "kl-id:xxxxxxx",
    "Scope": "SearchScopeInbound"
}

Получение документооборота ЭТрН 

Для получения всего документооборота по ЭТрН используйте метод GenerateDocumentZip. Инструкция о получении архива документов приведена на странице Генерация архива документооборота.

Соответствие титулов и префиксов имени файла описано в разделе Формат имени файла ЭТрН.