Работа с поручениями экспедитору

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

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

Заказчик транспортно-экспедиционных услуг:
- генерирует титул заказчика (Т1),
- подписывает и отправляет Т1.
Экспедитор:
- генерирует титул экспедитора (Т2),
- подписывает и отправляет Т2.

Титул заказчика транспортно-экспедиционных услуг (Т1)

Генерация Т1

Для генерации Т1 используйте метод GenerateTitleXml со следующими параметрами:

documentTypeNamedId = LogisticsForwardingOrder
documentFunction = default
documentVersion = kl_porek_wt3_05_02_01
titleIndex = 0

В теле запроса передайте упрощенный XML-файл с данными титула — UserDataXml, соответствующий XSD-схеме. Схемы XSD и UserDataXsd можно скачать в разделе XSD-схемы.

Данные подписанта в UserDataXml нужно заполнить в универсальном формате. При необходимости можно изменить данные подписанта в уже сгенерированном титуле: для этого воспользуйтесь методом подготовки к подписанию.

Примечание

Значения параметров метода генерации получены с помощью метода GetDocumentTypes (V3): инструкция о получении данных для титула приведена в разделе Данные для генерации титула.

Общая инструкция о генерации титулов приведена в разделе Генерация титула отправителя.

Пример HTTP-запроса метода GenerateTitleXml:

POST /GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=LogisticsForwardingOrder&documentFunction=default&documentVersion=kl_porek_wt3_05_02_01&titleIndex=0 HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/xml; charset=utf-8

Пример тела запроса метода GenerateTitleXml (UserDataXml):

<?xml version="1.0" encoding="utf-8"?>
<LogisticsForwardingOrderClientTitle ForwardingOrderId="a41adce4-8de0-4dad-b275-252c5eab7f90" Number="ПЭ-2026-001" Date="22.04.2026" HasCargoDocs="0">
    <ClientForwarderOrder>
        <TotalDeclaredCargoCost Currency="643" CargoCost="100.00" />
        <CargoInfos>
            <CargoInfo NotifyReq="1" ReadyFromDate="25.04.2026" ReadyToDate="30.04.2026" TransportationIndicator="1" CargoBatchId="f223bf9f-6fcf-4bf5-8988-eb2f68e5e167" ShipmentCargoSpaceQuantity="11">
                <PartyNotificationInfos>
                    <PartyNotificationInfo NotifyForwardingParty="1" NotificationMethod="По электронной почте" />
                </PartyNotificationInfos>
                <Consignee>
                    <OrganizationDetails OrgType="2" OrgName="ООО &quot;Грузополучатель&quot;" Inn="9110689118" Kpp="667301001" FnsParticipantId="2BM-consignee">
                        <Address>
                            <RussianAddress ZipCode="620000" Region="66" City="Екатеринбург" Street="Ленина" Building="1" />
                        </Address>
                    </OrganizationDetails>
                </Consignee>
                <Shipper>
                    <OrganizationDetails OrgType="2" OrgName="ООО &quot;Грузоотправитель&quot;" Inn="7708168971" Kpp="770801001" FnsParticipantId="2BM-shipper">
                        <Address>
                            <RussianAddress ZipCode="620000" Region="66" City="Екатеринбург" Street="Ленина" Building="1" />
                        </Address>
                    </OrganizationDetails>
                </Shipper>
                <TransportInfos>
                    <TransportInfo TransportType="1" BodyType="Тентованный" />
                </TransportInfos>
                <ClientDirectives TransportationDirectives="Соблюдать нормы перевозки" SpeedLimit="80 км/ч" SpecialInformation="Хрупкий груз">
                    <ClimateTransportRegime TemperatureLowerLimit="-5.00" TemperatureUpperLimit="10.00" />
                </ClientDirectives>
                <BatchWeight NetWeight="100.000" GrossWeight="110.000" />
                <ActualShipmentCost Currency="643" CargoCost="250.00" />
                <ItemDescriptions>
                    <ItemDescription Name="Промышленное оборудование" CargoSpaceQuantity="10" HasDangerous="0" HasRestrictedItems="0" CanSpecifyVolume="1" Volume="2.500000" IsForStateSystemRegistration="0" HasPackaging="1" HasCommodityCode="0">
                        <GNGCargoCodes>
                            <GNGCargoCode>12345678</GNGCargoCode>
                        </GNGCargoCodes>
                        <ETSNGCargoCodes>
                            <ETSNGCargoCode>123456</ETSNGCargoCode>
                        </ETSNGCargoCodes>
                        <Marks>
                            <Mark>МК-001</Mark>
                        </Marks>
                        <CargoNumbers>
                            <CargoNumber>1</CargoNumber>
                        </CargoNumbers>
                        <CargoOriginCountryInfo>
                            <Country>643</Country>
                        </CargoOriginCountryInfo>
                        <CargoWeight NetWeight="100.000" GrossWeight="110.000" />
                        <CargoPackagingInfos>
                            <CargoPackagingInfo PackagingType="BX" PackagingWeight="10.000">
                                <PackagingDimensions Height="1.000" Length="2.000" Width="1.500" />
                            </CargoPackagingInfo>
                        </CargoPackagingInfos>
                        <ActualCargoCost Currency="643" CargoCost="50.00" />
                    </ItemDescription>
                </ItemDescriptions>
                <CargoLocationAddress CargoPickupLocation="1">
                    <CargoDeliveryAddress Comment="Склад 5">
                        <Address>
                            <RussianAddress ZipCode="620000" Region="66" City="Екатеринбург" Street="Ленина" Building="1" />
                        </Address>
                    </CargoDeliveryAddress>
                </CargoLocationAddress>
                <DestinationAddress CargoDeliveryPoint="1">
                    <CargoDeliveryAddress>
                        <Address>
                            <RussianAddress ZipCode="101000" Region="77" City="Москва" Street="Тверская" Building="10" />
                        </Address>
                    </CargoDeliveryAddress>
                </DestinationAddress>
            </CargoInfo>
        </CargoInfos>
        <ClientInfo>
            <OrganizationDetails OrgType="2" OrgName="ООО &quot;Клиент&quot;" Inn="9110689118" Kpp="667301001" FnsParticipantId="2BM-client">
                <Address>
                    <RussianAddress ZipCode="620000" Region="66" City="Екатеринбург" Street="Ленина" Building="1" />
                </Address>
            </OrganizationDetails>
        </ClientInfo>
        <ForwarderInfo>
            <OrganizationDetails OrgType="2" OrgName="ООО &quot;Экспедитор&quot;" Inn="7707083893" Kpp="770701001" FnsParticipantId="2BM-forwarder">
                <Address>
                    <RussianAddress ZipCode="101000" Region="77" City="Москва" Street="Тверская" Building="10" />
                </Address>
            </OrganizationDetails>
        </ForwarderInfo>
        <ForwardingContractRequisites DocumentName="Договор транспортной экспедиции" DocumentNumber="ДТЭ-2026-001" DocumentDate="01.01.2026">
            <IdentificationDetails Inn="7707083893" />
        </ForwardingContractRequisites>
    </ClientForwarderOrder>
    <Signers BoxId="7897efeb-8334-42fc-a306-a9bcffa7888b">
        <Signer SignerPowersConfirmationMethod="1">
            <Fio LastName="Иванов" FirstName="Иван" MiddleName="Иванович" />
            <Position PositionSource="Manual">Генеральный директор</Position>
        </Signer>
    </Signers>
</LogisticsForwardingOrderClientTitle>

Пример тела ответа метода GenerateTitleXml (Т1):

<?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="ON_POREXPKLT_2BM-forwarder_2BM-client_0_20260422_a41adce4-8de0-4dad-b275-252c5eab7f90" ВерсПрог="Diadoc 1.0" ВерсФорм="5.01">
    <Документ КНД="1110486" НаимДок="электронное поручение экспедитору, информация клиента" ДатИнфКлнт="22.04.2026" ВрИнфКлнт="12.00.00" НаимЭкСубСост="ООО &quot;Клиент&quot;">
        <СодИнфКлнт УИД_ПорЭксп="a41adce4-8de0-4dad-b275-252c5eab7f90" СодОпер="представление электронного поручения экспедитору" НомДок="ПЭ-2026-001" ДатаДок="22.04.2026" ДокГруз="0">
            <ОбщОбъявлСтГруз КодОКВ="643" НаимОКВ="Российский рубль" СтГр="100.00" />
            <СвГруз ПрзПрвз="0" ИдентПартГруз="f223bf9f-6fcf-4bf5-8988-eb2f68e5e167" НомПартГруз="1" КолМестПарт="11" УИГП="2BM-consignee" УИГО="2BM-shipper">
                <СвУведСторон Сторона="1" СпосУвед="По электронной почте" />
                <СвГП>
                    <ИдСв>
                        <СвЮЛУч НаимОрг="ООО &quot;Грузополучатель&quot;" ИННЮЛ="9110689118" КПП="667301001" />
                    </ИдСв>
                </СвГП>
                <СвГО>
                    <ИдСв>
                        <СвЮЛУч НаимОрг="ООО &quot;Грузоотправитель&quot;" ИННЮЛ="7708168971" КПП="770801001" />
                    </ИдСв>
                </СвГО>
                <СвТС ВидТС="1" ТипКузов="Тентованный" />
                <УказКлнт УкНормПрвз="Соблюдать нормы перевозки" ОгрСкор="80 км/ч" Отмет="Хрупкий груз">
                    <КлимРеж ТемпНеНиже="-5.00" ТемпНеВыше="10.00" />
                </УказКлнт>
                <ВесГрузПарт ВесНетто="100.000" ВесБрутто="110.000" />
                <ОбъявлСтГрузПарт КодОКВ="643" НаимОКВ="Российский рубль" СтГр="250.00" />
                <ОпГруз НаимГруз="Промышленное оборудование" КолМест="10" ЕдИзм="шт">
                    <КодГрузГНГ>12345678</КодГрузГНГ>
                    <КодГрузЕТСНГ>123456</КодГрузЕТСНГ>
                    <Марк>МК-001</Марк>
                </ОпГруз>
            </СвГруз>
            <СвКлнт>
                <ИдСв>
                    <СвЮЛУч НаимОрг="ООО &quot;Клиент&quot;" ИННЮЛ="9110689118" КПП="667301001" />
                </ИдСв>
            </СвКлнт>
            <СвЭксп>
                <ИдСв>
                    <СвЮЛУч НаимОрг="ООО &quot;Экспедитор&quot;" ИННЮЛ="7707083893" КПП="770701001" />
                </ИдСв>
            </СвЭксп>
            <ДогТрЭксп РеквНаимДок="Договор транспортной экспедиции" РеквНомерДок="ДТЭ-2026-001" РеквДатаДок="01.01.2026">
                <РеквИдРекСост>
                    <ИННЮЛ>7707083893</ИННЮЛ>
                </РеквИдРекСост>
            </ДогТрЭксп>
        </СодИнфКлнт>
        <ПодпИнфКлнт СпосПодтПолном="1" Должн="Генеральный директор">
            <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
        </ПодпИнфКлнт>
    </Документ>
</Файл>

Отправка Т1

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

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

TypeNamedId = LogisticsForwardingOrder
Function = default
Version = kl_porek_wt3_05_02_01

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

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

Титул экспедитора (Т2)

Генерация Т2

Для генерации Т2 используйте метод GenerateTitleXml со следующими параметрами:

documentTypeNamedId = LogisticsForwardingOrder
documentFunction = default
documentVersion = kl_porek_wt3_05_02_01
titleIndex = 1
letterId = {{letterId}} (значение из идентификатора Т1)
documentId = {{documentId}} (значение из идентификатора Т1)

В теле запроса передайте упрощенный XML-файл с данными титула — UserDataXml, соответствующий XSD-схеме. Схемы XSD и UserDataXsd можно скачать в разделе XSD-схемы.

Данные подписанта в UserDataXml нужно заполнить в универсальном формате. При необходимости можно изменить данные подписанта в уже сгенерированном титуле: для этого воспользуйтесь методом подготовки к подписанию.

Примечание

Значения параметров метода генерации получены с помощью метода GetDocumentTypes (V3): инструкция о получении данных для титула приведена в разделе Данные для генерации титула.

Общая инструкция о генерации титулов приведена в разделе Генерация титула отправителя.

Пример HTTP-запроса метода GenerateTitleXml:

POST /GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=LogisticsForwardingOrder&documentFunction=default&documentVersion=kl_porek_wt3_05_02_01&titleIndex=1&letterId={{letterId}}&documentId={{documentId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/xml; charset=utf-8

Пример тела запроса метода GenerateTitleXml (UserDataXml):

<?xml version="1.0" encoding="utf-8"?>
<LogisticsForwardingOrderForwarderTitle ForwardingOrderId="a41adce4-8de0-4dad-b275-252c5eab7f90" EntryNumber="ЭПЭ-2026-001" EntryDate="24.04.2026">
    <ForwarderOrderInfo>
        <ForwarderAdditionalInfos>
            <ForwarderAdditionalInfo ExecutionStatus="1" ServiceName="Организация перевозки груза" ServiceCode="ТЭУ-01">
                <PaymentInfo TotalServiceCost="5000.00" TaxRate="20%" CurrencyCode="643" />
                <CargoTransportInfos>
                    <CargoTransportInfo CargoRoute="Екатеринбург — Москва">
                        <DeliveryTransportInfos>
                            <DeliveryTransportInfo TransportType="1" BodyType="Тентованный" Brand="КамАЗ" Number="В789УХ77">
                                <Drivers>
                                    <DriverInfo LastName="Петров" FirstName="Петр" MiddleName="Петрович" Inn="500100732259" LicenseNumber="1234567" LicenseSeries="7720" LicenseDate="15.06.2024">
                                        <Phones>
                                            <Phone>+7 (903) 456-78-90</Phone>
                                        </Phones>
                                    </DriverInfo>
                                </Drivers>
                            </DeliveryTransportInfo>
                        </DeliveryTransportInfos>
                    </CargoTransportInfo>
                </CargoTransportInfos>
            </ForwarderAdditionalInfo>
        </ForwarderAdditionalInfos>
    </ForwarderOrderInfo>
    <Signers BoxId="d9243b8c-5304-4d7c-998a-9a157ec74686">
        <Signer SignerPowersConfirmationMethod="1">
            <Fio LastName="Сидоров" FirstName="Алексей" MiddleName="Владимирович" />
            <Position PositionSource="Manual">Генеральный директор</Position>
        </Signer>
    </Signers>
</LogisticsForwardingOrderForwarderTitle>

Пример тела ответа метода GenerateTitleXml (Т2):

<?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="ON_POREXPEXP_2BM-forwarder_2BM-client_0_20260424_b52bdcf5-9ef1-5ebe-c386-363d6fbc8a01" ВерсПрог="Diadoc 1.0" ВерсФорм="5.01">
    <Документ КНД="1110487" НаимДок="электронное поручение экспедитору, информация экспедитора" ДатИнфЭксп="24.04.2026" ВрИнфЭксп="14.30.00">
        <ИдИнфКлнт ИдФайлИнфКлнт="ON_POREXPKLT_2BM-forwarder_2BM-client_0_20260422_a41adce4-8de0-4dad-b275-252c5eab7f90" ДатФайлИнфКлнт="22.04.2026" ВрФайлИнфКлнт="12.00.00">
            <ЭП>MIINawYJKoZIhvcNAQcCoIINXDCCDVgCAQExDDAKBggqhQMHAQECAjALBgkqhkiG9w0BBwGgggmuMII...</ЭП>
        </ИдИнфКлнт>
        <СодИнфЭксп УИД_ПорЭксп="a41adce4-8de0-4dad-b275-252c5eab7f90" НомРеестр="ЭПЭ-2026-001" ДатаРеестр="24.04.2026" СодОпер="согласование подлежащих оказанию транспортно-экспедиционных услуг и условий">
            <ДопИнфЭксп ПризнИсп="1" НаимУсл="Организация перевозки груза" КодУсл="ТЭУ-01">
                <ИдентПартГруз>f223bf9f-6fcf-4bf5-8988-eb2f68e5e167</ИдентПартГруз>
                <НомПартГруз>1</НомПартГруз>
                <СвОплата ОбщСтУсл="5000.00" НалСт="20%" />
            </ДопИнфЭксп>
        </СодИнфЭксп>
        <ПодпИнфЭксп СпосПодтПолном="1" Должн="Генеральный директор">
            <ФИО Фамилия="Сидоров" Имя="Алексей" Отчество="Владимирович" />
        </ПодпИнфЭксп>
    </Документ>
</Файл>

Отправка Т2

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

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