Работа с железнодорожной накладной

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

Примечание

Этот тип документа недоступен по умолчанию. Чтобы начать работать с железнодорожной накладной, обратитесь к вашему менеджеру.

Примечание

На текущий момент в Диадоке реализована работа только с обязательными титулами железнодорожной накладной (Т1−Т5).

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

Титул информации грузоотправителя (Т1)

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

  1. Сформируйте XML-файл Т1 в соответствии с Приказом ФНС России от 07.05.2026 № КЧ-1-26/297@ и XSD-схемой.

  2. С помощью метода GetOrganization получите по ИНН или ИНН-КПП FNSId организаций, участвующих в формировании ЭТЖН.

  3. Заполните в теге Файл имя файла ИдФайл, используя полученные FNSId. Описание имени файла доступно в разделе Формат имени файла.

  4. Если титул направляет перевозчик по соглашению с грузоотправителем, заполните ЛицоГО = 2, а также НомСоглГО и ДатСоглГО.

Отправка Т1

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

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

  • TypeNamedId = LogisticsRailwayWaybill

  • Function = reception_consignor

  • Version = kl_rw_05_01_02

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

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

После отправки Т1 ГИС ЭПД присвоит документу значение атрибута УИД_ТрНЖд: это значение будет отражено в структуре OuterDocflow. Оно должно совпадать для всех титулов одной ЭТЖН. Подробнее об обработке перевозочных документов в разделе Информация о статусе обработки.

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

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

  1. Сформируйте XML-файл Т2 в соответствии с Приказом ФНС России от 07.05.2026 № КЧ-1-26/297@ и XSD-схемой.

  2. Заполните реквизиты Т2 следующими данными:

    • ИдФайлИнфГО — значение атрибута ИдФайл из корня XML-файла Т1.

    • ДатФайлИнфГО — значение атрибута ДатИнфГО из XML-файла Т1.

    • ВрФайлИнфГО — значение атрибута ВрИнфГО из XML-файла Т1.

    • ЭП — содержимое файла подписи Т1 в кодировке base64.

    • УИД_ТрНЖд — значение mt-id из OuterDocflow зарегистрированной ЭТЖН. Должно совпадать для всех титулов одной ЭТЖН.

  3. Заполните в теге Файл имя файла ИдФайл. Описание имени файла доступно в разделе Формат имени файла.

Отправка Т2

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

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

  • TypeNamedId = LogisticsRailwayWaybill

  • Function = reception_carrier

  • Version = kl_rw_05_01_02

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

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

Титул уведомления о прибытии (Т3)

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

  1. Сформируйте XML-файл Т3 в соответствии с Приказом ФНС России от 07.05.2026 № КЧ-1-26/297@ и XSD-схемой.

  2. Заполните реквизиты Т3 следующими данными:

    • ИдФайлИнфГО — значение атрибута ИдФайл из корня XML-файла Т1.

    • ДатФайлИнфГО — значение атрибута ДатИнфГО из XML-файла Т1.

    • ВрФайлИнфГО — значение атрибута ВрИнфГО из XML-файла Т1.

    • ЭП — содержимое файла подписи Т1 в кодировке base64.

    • УИД_ТрНЖд — значение mt-id из OuterDocflow зарегистрированной ЭТЖН. Должно совпадать для всех титулов одной ЭТЖН.

  3. Заполните в теге Файл имя файла ИдФайл. Описание имени файла доступно в разделе Формат имени файла.

Отправка Т3

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

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

  • TypeNamedId = LogisticsRailwayWaybill

  • Function = delivery_carrier

  • Version = kl_rw_05_01_02

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

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

Титул дорожной ведомости (Т4)

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

  1. Сформируйте XML-файл Т4 в соответствии с Приказом ФНС России от 07.05.2026 № КЧ-1-26/297@ и XSD-схемой.

  2. Заполните реквизиты Т4 следующими данными:

    • ИдФайлИнфУвГП — значение атрибута ИдФайл из корня XML-файла Т3.

    • ДатФайлИнфУвГП — значение атрибута ДатИнфУвГП из XML-файла Т3.

    • ВрФайлИнфУвГП — значение атрибута ВрИнфУвГП из XML-файла Т3.

    • ЭП — содержимое файла подписи Т3 в кодировке base64.

    • УИД_ТрНЖд — значение mt-id из OuterDocflow зарегистрированной ЭТЖН. Должно совпадать для всех титулов одной ЭТЖН.

  3. Если титул направляет перевозчик по соглашению с грузополучателем, заполните ЛицоГП = 2, а также НомСоглГП и ДатСоглГП.

  4. Заполните в теге Файл имя файла ИдФайл. Описание имени файла доступно в разделе Формат имени файла.

Отправка Т4

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

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

  • TypeNamedId = LogisticsRailwayWaybill

  • Function = delivery_consignee

  • Version = kl_rw_05_01_02

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

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

Титул изменения финансового состояния (Т5)

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

  1. Сформируйте XML-файл Т5 в соответствии с Приказом ФНС России от 07.05.2026 № КЧ-1-26/297@ и XSD-схемой.

  2. Заполните реквизиты Т5 следующими данными:

    • ИдФайлИнфГО — значение атрибута ИдФайл из корня XML-файла Т1.

    • ДатФайлИнфГО — значение атрибута ДатИнфГО из XML-файла Т1.

    • ВрФайлИнфГО — значение атрибута ВрИнфГО из XML-файла Т1.

    • ЭП — содержимое файла подписи Т1 в кодировке base64.

    • УИД_ТрНЖд — значение mt-id из OuterDocflow зарегистрированной ЭТЖН. Должно совпадать для всех титулов одной ЭТЖН.

  3. Заполните в теге Файл имя файла ИдФайл. Описание имени файла доступно в разделе Формат имени файла.

Отправка Т5

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

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

  • TypeNamedId = LogisticsRailwayWaybill

  • Function = cost_carrier

  • Version = kl_rw_05_01_02

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

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

Получение титулов

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

Обратите внимание, что одна перевозка представлена в Диадоке набором однотитульных документов. Каждый титул отправляется отдельным сообщением со своей функцией документооборота.

Ниже приведена таблица с информацией о титулах ЭТЖН. Для каждого титула:

  • тип документа имеет значение LogisticsRailwayWaybill,

  • версия документа имеет значение kl_rw_05_01_02.

Информация о титулах железнодорожной накладной

Титул

Имя файла

Функция

Титул информации грузоотправителя (Т1)

ON_TRNZDGO

reception_consignor

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

ON_TRNZDPRVKP

reception_carrier

Титул уведомления о прибытии (Т3)

ON_TRNZDUVEDGP

delivery_carrier

Титул дорожной ведомости (Т4)

ON_TRNZDGPDORV

delivery_consignee

Титул изменения финансового состояния (Т5)

ON_TRNZDFINSPER

cost_carrier

Найти все документы, относящиеся к одной перевозке, можно с помощью пользовательских данных:

  • в mt-id хранится УИД: также он фиксируется системой в статусе OuterDocflow KlMt.

  • в kl-id хранится единый внутренний идентификатор перевозки.