Работа с экспедиторскими расписками
Порядок обмена экспедиторскими расписками описан на странице Документооборот экспедиторских расписок. Базовый алгоритм работы с формализованными документами приведен в разделе Работа с формализованными документами. Особенности сценариев работы с документом зависят от вида документооборота для его формата.
Экспедиторская расписка содержит один титул — титул экспедитора. Ответный титул от заказчика транспортно-экспедиционных услуг не требуется.
Сценарий работы с экспедиторской распиской включает следующие шаги:
Генерация титула
Для генерации титула используйте метод GenerateTitleXml со следующими параметрами:
documentTypeNamedId = LogisticsForwardingReceiptdocumentFunction = defaultdocumentVersion = kl_fr_05_01_02titleIndex = 0
В теле запроса передайте упрощенный XML-файл с данными титула — UserDataXml, соответствующий XSD-схеме. Схемы XSD и UserDataXsd можно скачать в разделе XSD-схемы.
Данные подписанта в UserDataXml нужно заполнить в универсальном формате. При необходимости можно изменить данные подписанта в уже сгенерированном титуле: для этого воспользуйтесь методом подготовки к подписанию.
Примечание
Значения параметров метода генерации получены с помощью метода GetDocumentTypes (V3): инструкция о получении данных для титула приведена в разделе Данные для генерации титула.
Общая инструкция о генерации титулов приведена в разделе Генерация титула отправителя.
Пример HTTP-запроса метода GenerateTitleXml:
POST /GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=LogisticsForwardingReceipt&documentFunction=default&documentVersion=kl_fr_05_01_02&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"?>
<LogisticsForwardingReceiptSenderTitle>
<ForwarderOrderInfo Number="ЭР-2026-001" Date="27.04.2026" EntryNumber="РУ-66-2026-000123" EntryDate="15.01.2026" ForwardingOrderId="a41adce4-8de0-4dad-b275-252c5eab7f90" ActualCargoReceiptDate="27.04.2026" ActualCargoReceiptTime="10:30:00" CargoPlacesTotal="11" CanSpecifyTotalCargoCost="1">
<TotalCargoWeight NetWeight="1000.000" GrossWeight="1100.000" />
<TotalDeclaredCargoCost Currency="643" CargoCost="150000.00" />
<CargoInfos>
<CargoInfo CargoBatchNumber="1" CargoBatchId="f223bf9f-6fcf-4bf5-8988-eb2f68e5e167" ShipmentCargoSpaceQuantity="11" CanSpecifyCargoBatchCost="1" TransportationIndicator="0">
<BatchWeight NetWeight="1000.000" GrossWeight="1100.000" />
<DeclaredShipmentCost Currency="643" CargoCost="150000.00" />
<CargoAcceptanceConditions ActualCargoCondition="Груз принят в исправном состоянии" ActualPackagingCondition="Упаковка не нарушена" ActualSealingCondition="Пломбы не нарушены">
<ForwarderObligations>
<ForwarderObligation>Организовать перевозку груза до пункта назначения</ForwarderObligation>
<ForwarderObligation>Обеспечить сохранность груза при перевозке</ForwarderObligation>
</ForwarderObligations>
</CargoAcceptanceConditions>
<ItemDescriptions>
<ItemDescription Name="Пряники в коробках" CargoSpaceQuantity="11" DeliveryMethod="Автомобильным транспортом" CanSpecifyVolume="1" Volume="2.500000" SpecialInformation="Отсутствует" HasDangerous="0" HasRestrictedItems="0" HasPackaging="1" IsForStateSystemRegistration="0" CanSpecifyCargoCost="1" HasCommodityCode="0">
<Marks>
<Mark>Отсутствует</Mark>
</Marks>
<CargoOriginCountryInfo>
<Country>643</Country>
</CargoOriginCountryInfo>
<CargoWeight NetWeight="1000.000" GrossWeight="1100.000" />
<CargoPackagingInfos>
<CargoPackagingInfo PackagingType="CT" PackagingWeight="100.000" PackagingCount="11">
<PackagingDimensions Height="1.200" Length="0.800" Width="1.000" />
</CargoPackagingInfo>
</CargoPackagingInfos>
<DeclaredCargoCost Currency="643" CargoCost="150000.00" />
</ItemDescription>
</ItemDescriptions>
</CargoInfo>
</CargoInfos>
<CargoAcceptanceAddress>
<Address>
<RussianAddress ZipCode="620000" Region="66" City="Екатеринбург" Street="Ленина" Building="1" OtherInfo="Складской терминал, ворота 3" />
</Address>
</CargoAcceptanceAddress>
<ClientInfo>
<OrganizationDetails OrgType="2" OrgName="ООО "Клиент"" Inn="9110689118" Kpp="667301001" FnsParticipantId="2BM-client">
<Address>
<RussianAddress ZipCode="620000" Region="66" City="Екатеринбург" Street="Ленина" Building="1" OtherInfo="Офис 210" />
</Address>
</OrganizationDetails>
</ClientInfo>
<ForwarderInfo>
<OrganizationDetails OrgType="2" OrgName="ООО "Экспедитор"" Inn="7707083893" Kpp="770701001" FnsParticipantId="2BM-forwarder">
<Address>
<RussianAddress ZipCode="101000" Region="77" City="Москва" Street="Тверская" Building="10" OtherInfo="Офис 15" />
</Address>
</OrganizationDetails>
</ForwarderInfo>
<Shipper>
<OrganizationDetails OrgType="2" OrgName="ООО "Грузоотправитель"" Inn="7708168973" Kpp="770801001" FnsParticipantId="2BM-shipper">
<Address>
<RussianAddress ZipCode="620000" Region="66" City="Екатеринбург" Street="Ленина" Building="1" OtherInfo="Склад 2" />
</Address>
</OrganizationDetails>
</Shipper>
<ForwardingContractRequisites DocumentName="Договор транспортной экспедиции" DocumentNumber="ДТЭ-2026-001" DocumentDate="01.01.2026">
<IdentificationDetails Inn="7707083893" />
</ForwardingContractRequisites>
</ForwarderOrderInfo>
<Signers BoxId="7897efeb-8334-42fc-a306-a9bcffa7888b">
<Signer SignerPowersConfirmationMethod="1">
<Fio LastName="Иванов" FirstName="Иван" MiddleName="Иванович" />
<Position PositionSource="Manual">Генеральный директор</Position>
</Signer>
</Signers>
</LogisticsForwardingReceiptSenderTitle>
Пример тела ответа метода GenerateTitleXml (титул экспедитора):
<?xml version="1.0" encoding="utf-8"?>
<Файл ИдФайл="ON_EXPRASP_2BM-client_2BM-forwarder_0_20260806_b6da4e72-72c4-48c5-b6ea-0b120553bcd5" ВерсПрог="Diadoc 1.0" ВерсФорм="5.01">
<Документ КНД="1110489" НаимДок="электронная экспедиторская расписка" ДатИнфЭксп="06.08.2026" ВрИнфЭксп="22:36:30">
<СодИнфЭксп СодОпер="груз принят во владение экспедитором" НомДок="ЭР-2026-001" ДатаДок="27.04.2026" НомРеестр="РУ-66-2026-000123" ДатаРеестр="15.01.2026" УИД_ПорЭксп="a41adce4-8de0-4dad-b275-252c5eab7f90" ФДатПол="27.04.2026" ВозмУкОбщСтГруз="1" ФВрПол="10:30:00" КолМестГрВсего="11">
<ВесГрВсего ВесНетто="1000.000" ВесБрутто="1100.000" />
<ОбъявлСтГрВсего КодОКВ="643" НаимОКВ="Российский рубль" СтГр="150000.00" />
<СвГруз ПрзПрвз="0" ВозмУкСтПарт="1" НомПартГруз="1" ИдентПартГруз="f223bf9f-6fcf-4bf5-8988-eb2f68e5e167" КолМестПарт="11">
<ВесГрузПарт ВесНетто="1000.000" ВесБрутто="1100.000" />
<ОбъявлСтГрузПарт КодОКВ="643" НаимОКВ="Российский рубль" СтГр="150000.00" />
<УслПрием ФСостГруз="Груз принят в исправном состоянии" ФСостУп="Упаковка не нарушена" ФСостПломб="Пломбы не нарушены">
<ОбязЭксп>Организовать перевозку груза до пункта назначения</ОбязЭксп>
<ОбязЭксп>Обеспечить сохранность груза при перевозке</ОбязЭксп>
</УслПрием>
<ОпГруз НаимГруз="Пряники в коробках" КолМестГр="11" СпДостГруз="Автомобильным транспортом" УказОбъем="1" Отмет="Отсутствует" ПрзОпаснГруз="0" ПрзИзъятВещ="0" НалУпак="1" УчГосСист="0" ВозмУкСтГруз="1" НалКодТовНом="0" Объем="2.500000">
<Марк>Отсутствует</Марк>
<СвСтрПроисх КодСтр="643" НаимСтран="Россия" />
<ВесГруз ВесНетто="1000.000" ВесБрутто="1100.000" />
<ИнфУпГруз ВидУпак="CT" ВесУпак="100.000" КолУп="11">
<ГабарУпак ВысЗнач="1.200" ДлЗнач="0.800" ШирЗнач="1.000" />
</ИнфУпГруз>
<ОбъявлСтГруз КодОКВ="643" НаимОКВ="Российский рубль" СтГр="150000.00" />
</ОпГруз>
</СвГруз>
<АдрПриемГруз>
<Адрес>
<АдрРФ КодРегион="66" НаимРегион="Свердловская область" Индекс="620000" Город="Екатеринбург" Улица="Ленина" Дом="1" ИныеСвед="Складской терминал, ворота 3" />
</Адрес>
</АдрПриемГруз>
<СвКлнт>
<ИдСв>
<СвЮЛУч НаимОрг="ООО "Клиент"" ИННЮЛ="9110689118" КПП="667301001" />
</ИдСв>
<Адрес>
<АдрРФ КодРегион="66" НаимРегион="Свердловская область" Индекс="620000" Город="Екатеринбург" Улица="Ленина" Дом="1" ИныеСвед="Офис 210" />
</Адрес>
</СвКлнт>
<СвЭксп>
<ИдСв>
<СвЮЛУч НаимОрг="ООО "Экспедитор"" ИННЮЛ="7707083893" КПП="770701001" />
</ИдСв>
<Адрес>
<АдрРФ КодРегион="77" НаимРегион="г. Москва" Индекс="101000" Город="Москва" Улица="Тверская" Дом="10" ИныеСвед="Офис 15" />
</Адрес>
</СвЭксп>
<СвГО>
<ИдСв>
<СвЮЛУч НаимОрг="ООО "Грузоотправитель"" ИННЮЛ="7708168973" КПП="770801001" />
</ИдСв>
<Адрес>
<АдрРФ КодРегион="66" НаимРегион="Свердловская область" Индекс="620000" Город="Екатеринбург" Улица="Ленина" Дом="1" ИныеСвед="Склад 2" />
</Адрес>
</СвГО>
<ДогТрЭксп РеквНаимДок="Договор транспортной экспедиции" РеквНомерДок="ДТЭ-2026-001" РеквДатаДок="01.01.2026">
<РеквИдРекСост>
<ИННЮЛ>7707083893</ИННЮЛ>
</РеквИдРекСост>
</ДогТрЭксп>
</СодИнфЭксп>
<ПодпИнфЭксп СпосПодтПолном="1" Должн="Генеральный директор">
<ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
</ПодпИнфЭксп>
</Документ>
</Файл>
Отправка титула
Сформированный и подписанный титул можно отправить заказчику с помощью метода PostMessage (V3), передав его в поле DocumentAttachment структуры MessageToPost. Полная инструкция об отправке документа приведена в разделе Отправка документа.
Обратите внимание, что в титуле должны быть заполнены данные подписанта.
В структуре DocumentAttachment укажите данные о типе документа, полученные с помощью метода GetDocumentTypes (V3):
TypeNamedId = LogisticsForwardingReceiptFunction = defaultVersion = kl_fr_05_01_02
Пример тела запроса метода PostMessage:
{
"FromBoxId": "{{boxId_sender}}",
"ToBoxId": "{{boxId_recipient}}",
"DocumentAttachments": [
{
"SignedContent": {
"Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0...NC50Ls+", // содержимое XML-файла в кодировке base-64
"Signature": "MIIN5QYJKoZIhvcNAQcCoIIN1jCCDdIA...kA9MJfsplqgW" // содержимое файла подписи в кодировке base-64
},
"TypeNamedId": "LogisticsForwardingReceipt",
"Function": "default",
"Version": "kl_fr_05_01_02"
}
]
}