Работа с авианакладной

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

Примечание

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

Примечание

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

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

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

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

  1. Сформируйте XML-файл Т1 в соответствии с Приказом ФНС России от 27.04.2026 № ЕД-1-26/276@ и XSD-схемой.

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

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

Отправка Т1

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

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

  • TypeNamedId = LogisticsAirWaybill

  • Function = reception_consignor

  • Version = kl_awb_05_02_01

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

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

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

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

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

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

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

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

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

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

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

    • УИД_АвиаГН — значение mt-id из пользовательских данных (CustomData) зарегистрированной авианакладной. Должно совпадать для всех титулов одной авианакладной.

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

Отправка Т2

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

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

  • TypeNamedId = LogisticsAirWaybill

  • Function = reception_carrier

  • Version = kl_awb_05_02_01

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

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

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

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

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

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

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

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

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

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

    • УИД_АвиаГН — значение mt-id из пользовательских данных (CustomData) зарегистрированной авианакладной. Должно совпадать для всех титулов одной авианакладной.

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

Отправка Т3

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

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

  • TypeNamedId = LogisticsAirWaybill

  • Function = delivery_consignee

  • Version = kl_awb_05_02_01

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

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

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

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

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

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

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

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

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

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

    • УИД_АвиаГН — значение mt-id из пользовательских данных (CustomData) зарегистрированной авианакладной. Должно совпадать для всех титулов одной авианакладной.

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

Отправка Т4

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

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

  • TypeNamedId = LogisticsAirWaybill

  • Function = delivery_carrier

  • Version = kl_awb_05_02_01

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

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

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

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

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

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

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

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

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

Титул

Имя файла

Функция

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

ON_AWBPRV

reception_consignor

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

ON_AWBGO

reception_carrier

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

ON_AWBGP

delivery_consignee

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

ON_AWBVYD

delivery_carrier

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

ON_AWBPUDPER

cost_carrier

Титул подтверждения изменения финансового состояния (Т6)

ON_AWBPUDGO

cost_consignor

Титул изменения сведений о грузополучателе (Т7)

ON_AWBIZMGP

readdress_consignor

Титул подтверждения изменения грузополучателя (Т8)

ON_AWBPERPTD

readdress_carrier

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

  • в mt-id хранится УИД Минтранса.

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