Работа с заказами-заявками

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

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

Грузоотправитель:
- формирует титул грузоотправителя (Т1),
- подписывает и отправляет Т1.
Перевозчик:
- формирует титул перевозчика (Т2),
- подписывает и отправляет Т2.

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

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

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

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

<Файл ИдФайл="ON_ZAKZVGO_2BM-7277523557-408214305-202511180644010884203_2BM-8836084248-306223863-202511190616128255404_0_20250618_106645e7-6b0d-4ad9-b122-86bb8656d5a3" ВерсПрог="1.0" ВерсФорм="5.01">

Примечание

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

Отправка Т1

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

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

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

TypeNamedId = LogisticsOrderRequest
Function = default
Version = zakzvper_05_01_01

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

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

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

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

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

Отправка Т2

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

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