Работа с ЭТрН

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

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

При необходимости каждый участник документооборота может распарсить полученный титул.

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

Генерация Т1

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

  • documentTypeNamedId = LogisticsWaybill

  • documentFunction = reception

  • documentVersion = kl_trn_mt_05_01

  • titleIndex = 0

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

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

Примечание

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

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

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

POST GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=LogisticsWaybill&documentFunction=reception&documentVersion=kl_trn_mt_05_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"?>
<LogisticsWaybillConsignorTitle
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    Number="2026/04/02-ЭТРН015"
    Date="02.04.2026"
    OrderNumber="Заказ Транспорта"
    OrderDate="02.04.2026">

    <WaybillInfo>
        <!-- Сведения о грузоотправителе -->
        <ShipperInfo IsFreightForwarder="0">
            <Shipper>
                <OrganizationReference BoxId="ba36e7bb-104c-42cb-adf4-638240f86085">
                    <Phones>
                        <Phone>9005567834</Phone>
                    </Phones>
                </OrganizationReference>
            </Shipper>
        </ShipperInfo>

        <!-- Сведения о грузополучателе -->
        <ConsigneeInfo>
            <Consignee>
                <OrganizationReference BoxId="23f5c3cb-44cb-4fbc-a0f7-7f981333c1ba">
                    <Phones>
                        <Phone>9056678765</Phone>
                    </Phones>
                </OrganizationReference>
            </Consignee>
            <DeliveryAddres>
                <AddressLogisticsWaybill>
                    <RussianAddress
                        ZipCode="620050"
                        Region="66"
                        City="Екатеринбург" />
                </AddressLogisticsWaybill>
            </DeliveryAddres>
        </ConsigneeInfo>

        <!-- Сведения о грузе -->
        <CargoInfo>
            <ItemDescriptions>
                <ItemDescription
                    Name="Мармелад"
                    Condition="Отличное"
                    PackageMethod="Коробки"
                    ContainerType="00"
                    CargoSpaceQuantity="200"
                    IsForStateSystemRegistration="0">
                    <Marks>
                        <Mark>Отсутствует</Mark>
                    </Marks>
                    <PlannedMass GrossWeight="2000" />
                </ItemDescription>
                <ItemDescription
                    Name="Шоколад"
                    Condition="Целый"
                    PackageMethod="Коробки"
                    ContainerType="1W"
                    CargoSpaceQuantity="10"
                    IsForStateSystemRegistration="0">
                    <Marks>
                        <Mark>Отсутствует</Mark>
                    </Marks>
                    <PlannedMass GrossWeight="35" />
                </ItemDescription>
            </ItemDescriptions>
        </CargoInfo>

        <!-- Указания грузоотправителя -->
        <ConsignorDirectives TransportationDirectives="Отсутствует">
            <ReaddressDetails AccountableSide="Consignor">
                <Phones>
                    <Phone>9876543</Phone>
                </Phones>
            </ReaddressDetails>
        </ConsignorDirectives>

        <!-- Сведения о перевозчике -->
        <Carrier>
            <OrganizationReference BoxId="215c3743-c8cf-4b26-8558-17b6089d975a">
                <Phones>
                    <Phone>89002827262</Phone>
                </Phones>
            </OrganizationReference>
        </Carrier>

        <!-- Сведения о водителе -->
        <Drivers>
            <DriverInfo
                LastName="Кислицын"
                FirstName="Михаил"
                MiddleName="Георгиевич"
                LicenseNumber="1234567890"
                LicenseSeries="1234"
                LicenseDate="01.01.2015">
                <Phones>
                    <Phone>+79124643655</Phone>
                </Phones>
            </DriverInfo>
        </Drivers>

        <!-- Сведения о транспортном средстве -->
        <VehicleInfo>
            <Vehicle
                Number="В777УС116"
                Ownership="1"
                Type="тягач с полуприцепом"
                Model="Hyundai Xcient"
                MaxWeight="40"
                Capacity="26" />
        </VehicleInfo>

        <!-- Сведения о погрузке -->
        <LoadingInfo
            StatedArrivalDateTime="13.07.2022T14:42:19+05:00"
            StatedArrivalDateTimeEnablingTimeZone="1"
            ActualArrivalDateTime="13.07.2022T14:42:19+05:00"
            ActualArrivalDateTimeEnablingTimeZone="1"
            ActualDepartureDateTime="13.07.2022T14:42:00+05:00"
            ActualDepartureDateTimeEnablingTimeZone="1"
            GrossWeight="2035"
            WeighingMethod="01"
            NumberOfPlaces="210">
            <ActualLoadingAddress>
                <AddressLogisticsWaybill>
                    <RussianAddress
                        ZipCode="603152"
                        Region="50"
                        City="Нижний Новгород"
                        Street="Ларина"
                        Building="19" />
                </AddressLogisticsWaybill>
            </ActualLoadingAddress>
            <LoadingPartyDetails MatchingShipper="1">
                <LoadingPartyEmployee Position="Сотрудник">
                    <JobResponsibilities>Должностные обязанности</JobResponsibilities>
                    <Fio LastName="Тестовая" FirstName="Екатерина" />
                </LoadingPartyEmployee>
                <RequisitesShipper Inn="7728168971" />
            </LoadingPartyDetails>
            <LoadingOwnerDetails Type="1">
                <RequisitesShipper Inn="7728168971" />
            </LoadingOwnerDetails>
        </LoadingInfo>
    </WaybillInfo>

    <Signer SignerType="1">
        <SignerDetails
            Position="Администратор"
            LastName="Тимофеев"
            FirstName="Алексей"
            MiddleName="Оскарович" />
    </Signer>
</LogisticsWaybillConsignorTitle>

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

<?xml version="1.0" encoding="windows-1251"?>
<Файл
    ИдФайл="ON_TRNACLGROT_2BM-5077563809-149845330-202405291058200404443_2BM-6638714825-902743835-202405291101053237625_2BM-2401878942-917245625-202405291049409629948_0_20260423_efae3c03-094c-4904-914f-99da5561334d"
    ВерсФорм="5.01" ВерсПрог="Diadoc 1.0">
    <Документ КНД="1110339" ПоФактХЖ="Транспортная накладная, информация грузоотправителя"
        ДатИнфГО="23.04.2026" ВрИнфГО="09:10:42">
        <СодИнфГО
            СодОпер="Лицом, осуществляющим погрузку груза, при указанных обстоятельствах передан водителю груз с указанными характеристиками"
            НомерТрН="2026/04/02-ЭТРН015" ДатаТрН="02.04.2026" НомЗак="Заказ Транспорта"
            ДатаЗак="02.04.2026">
            <СвГО ГОЭксп="0">
                <РекИдентГО>
                    <ИдСв>
                        <СвЮЛУч НаимОрг="ЗАО &quot;Логистика Грузоотправитель&quot;"
                            ИННЮЛ="2401878942" КПП="917245625" />
                    </ИдСв>
                    <Адрес>
                        <АдрРФ Индекс="620102" КодРегион="66" Город="Екатеринбург" Улица="Ленина"
                            Дом="1" />
                    </Адрес>
                    <Контакт>
                        <Тлф>9005567834</Тлф>
                    </Контакт>
                </РекИдентГО>
            </СвГО>
            <СвГП>
                <РекИдентГП>
                    <ИдСв>
                        <СвЮЛУч НаимОрг="ЗАО &quot;Логистика Грузополучатель&quot;"
                            ИННЮЛ="6638714825" КПП="902743835" />
                    </ИдСв>
                    <Контакт>
                        <Тлф>9056678765</Тлф>
                    </Контакт>
                </РекИдентГП>
                <АдресДостГр>
                    <АдресРФ Индекс="620050" КодРегион="66" Город="Екатеринбург" />
                </АдресДостГр>
            </СвГП>
            <СвГруз>
                <ОпГруз НаимГруз="Мармелад" СостГруз="Отличное" СпУпак="Коробки" ВидТар="00"
                    КолМестГр="200" УчГосСист="0">
                    <Марк>Отсутствует</Марк>
                    <ПлМасГруз МасБрутЗнач="2000" />
                </ОпГруз>
                <ОпГруз НаимГруз="Шоколад" СостГруз="Целый" СпУпак="Коробки" ВидТар="1W"
                    КолМестГр="10" УчГосСист="0">
                    <Марк>Отсутствует
                    </Марк>
                    <ПлМасГруз МасБрутЗнач="35" />
                </ОпГруз>
            </СвГруз>
            <УказГО УкНормПрвз="Отсутствует">
                <СвПА СпосПерУкПА="Электронное уведомление перевозчика о переадресовке"
                    ЛицоПА="Грузоотправитель">
                    <КонтПА>
                        <Тлф>9876543</Тлф>
                    </КонтПА>
                </СвПА>
            </УказГО>
            <СвПер>
                <ИдСв>
                    <СвЮЛУч НаимОрг="ЗАО &quot;Логистика Перевозчик&quot;" ИННЮЛ="5077563809"
                        КПП="149845330" />
                </ИдСв>
                <Адрес>
                    <АдрРФ Индекс="450098" КодРегион="78" Район="Приморский"
                        Город="город Санкт-Петербург" />
                </Адрес>
                <Контакт>
                    <Тлф>89002827262</Тлф>
                </Контакт>
            </СвПер>
            <СвВодит НомВУ="1234567890" СерВУ="1234" ДатаВыдВУ="01.01.2015">
                <Тлф>+79124643655</Тлф>
                <ФИО Фамилия="Кислицын" Имя="Михаил" Отчество="Георгиевич" />
            </СвВодит>
            <СвТС>
                <ТС РегНомер="В777УС116" ТипВлад="1">
                    <ПарТС Тип="тягач с полуприцепом" Марка="Hyundai Xcient" Грузопод="40"
                        Вместим="26" />
                </ТС>
            </СвТС>
            <СвПогруз ЗаявПогр="13.07.2022T14:42:19+05:00" НалКоорТочВрЗаяв="1"
                ФДатВрПриб="13.07.2022T14:42:19+05:00" НалКоорТочВрФПогр="1"
                ФДатВрУбыт="13.07.2022T14:42:00+05:00" НалКоорТочВрФУбыт="1" МасБрутОтгр="2035"
                МетОпрМасс="01" КолМестПрием="210">
                <ФАдресПогр>
                    <АдресРФ Индекс="603152" КодРегион="50" Город="Нижний Новгород" Улица="Ларина"
                        Дом="19" />
                </ФАдресПогр>
                <СвЛицПогрГр СовпГОП="1">
                    <РабЛицПогрГр Должность="Сотрудник">
                        <ОДолжОб>Должностные обязанности
                        </ОДолжОб>
                        <ФИО Фамилия="Тестовая" Имя="Екатерина" />
                    </РабЛицПогрГр>
                    <ИдентРекГО>
                        <ИННЮЛ>7728168971</ИННЮЛ>
                    </ИдентРекГО>
                </СвЛицПогрГр>
                <ВладИнфр СовпГОВ="1">
                    <ИдентРекГО>
                        <ИННЮЛ>7728168971</ИННЮЛ>
                    </ИдентРекГО>
                </ВладИнфр>
            </СвПогруз>
        </СодИнфГО>
        <Подписант СтатПодп="1" Должн="Администратор">
            <ФИО Фамилия="Тимофеев" Имя="Алексей" Отчество="Оскарович" />
        </Подписант>
    </Документ>
</Файл>

Отправка Т1

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

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

  • TypeNamedId = LogisticsWaybill

  • Function = reception

  • Version = kl_trn_mt_05_01

  • titleIndex = 1

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

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

Идентификатор ГИС ЭПД будет установлен системой после отправки Т1 и отразится в OuterDocflow. Подробнее об обработке перевозочных документов в разделе Информация о статусе обработки.

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

Генерация Т2

Для генерации Т2 используйте метод GenerateTitleXml с теми же параметрами, что и для Т1, но номер титула будет другой:

  • documentTypeNamedId = LogisticsWaybill

  • documentFunction = reception

  • documentVersion = kl_trn_mt_05_01

  • titleIndex = 1

  • letterId = {{letterId}} (значение из идентификатора Т1)

  • documentId = {{documentId}} (значение из идентификатора Т1)

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

Данные подписанта в UserDataXml нужно заполнить в универсальном формате.

Кроме этого для подготовки Т2 необходимо получить идентификатор Минтранса mt-id из OuterDocflow отправленного Т1. Это значение необходимо внести в поле MintransId UserDataXml Т2.

Примечание

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

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

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

POST GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=LogisticsWaybill&documentFunction=reception&documentVersion=kl_trn_mt_05_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"?>
<LogisticsWaybillCarrierTitle>
    <MintransId>cdad6a0c-9211-45fa-af83-2fff2b4a4e0f</MintransId>
    <Signer SignerType="1">
        <SignerDetails
            LastName="Тимофеев"
            FirstName="Алексей"
            MiddleName="Оскарович"
            Position="Администратор"/>
    </Signer>
</LogisticsWaybillCarrierTitle>

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

<?xml version="1.0" encoding="windows-1251"?>
<Файл
    ИдФайл="ON_TRNACLPPRIN_2BM-6638714825-902743835-202405291101053237625_2BM-2401878942-917245625-202405291049409629948_2BM-5077563809-149845330-202405291058200404443_0_20260423_c7bee5bb-d3cb-4781-b22b-8c48617080d1"
    ВерсПрог="Diadoc 1.0" ВерсФорм="5.01">
    <Документ КНД="1110340" ПоФактХЖ="Транспортная накладная, информация перевозчика о приеме груза"
        ДатИнфПрвПрием="23.04.2026" ВрИнфПрвПрием="10:06:21">
        <ИдИнфГО
            ИдФайлИнфГО="ON_TRNACLGROT_2BM-5077563809-149845330-202405291058200404443_2BM-6638714825-902743835-202405291101053237625_2BM-2401878942-917245625-202405291049409629948_0_20260423_efae3c03-094c-4904-914f-99da5561334d"
            ДатФайлИнфГО="23.04.2026" ВрФайлИнфГО="09:10:42"
            ЭП="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" />
        <СодИнфПрвПрием
            СодОпер="Груз принят к перевозке водителем, уполномоченным перевозчиком на перевозку груза, от Лица, осуществившего погрузку груза в транспортное средство"
            УИД_ТрН="cdad6a0c-9211-45fa-af83-2fff2b4a4e0f" />
        <Подписант СтатПодп="1" Должн="Администратор">
            <ФИО Фамилия="Тимофеев" Имя="Алексей" Отчество="Оскарович" />
        </Подписант>
    </Документ>
</Файл>

Отправка Т2

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

Генерация и отправка отказа в подписи Т2

Перевозчик может отказаться от подписи Т2. В таком случае необходимо сгенерировать и отправить отказ в подписи титула. Для этого:

  1. Вызовите метод GenerateSignatureRejectionXml (V2), чтобы сгенерировать отказ. В теле запроса укажите причину отказа в подписи.

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

    POST V2/GenerateSignatureRejectionXml?boxid={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json charset=utf-8

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

    {
    "ErrorMessage": "Текстовый комментарий",
    "MessageId": "bbcedb0d-ce34-4e0d-b321-3f600c920935",
    "AttachmentId": "30cf2c07-7297-4d48-bc6f-ca7a80e2cf95",
    "SignerContent": "PD94bWwgdmVyc2l...LDQudC7Pg=="        // содержимое XML-файла с данными подписанта в кодировке Base-64
}

    Пример тела ответа метода GenerateSignatureRejectionXml:

    <?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="DP_UVUTOCH_2BM-9017770974-757645784-202407101104400484330_2BM-5242989368-732644841-202407101103418496883_20250416_6a0d86e6-f052-455d-a62b-7e684a3906ad" ВерсПрог="Diadoc 1.0" ВерсФорм="1.03">
    <Документ КНД="1115113">
        <УчастЭДО ИдУчастЭДО="2BM-5242989368-732644841-202407101103418496883">
            <ЮЛ НаимОрг="Продавец" ИННЮЛ="5242989368" КПП="732644841"/>
        </УчастЭДО>
        <СвУведУточ ДатаПол="16.04.2025" ВремяПол="10.05.46">
            <СведПолФайл ИмяПолФайла="Group12">
                <ЭППолФайл>MIIMiQYJKoZIhv...UNp8A
</ЭППолФайл>
            </СведПолФайл>
            <ТекстУведУточ>Текстовый комментарий
</ТекстУведУточ>
        </СвУведУточ>
        <ОтпрДок ИдУчастЭДО="2BM-9017770974-757645784-202407101104400484330">
            <ЮЛ НаимОрг="Покупатель" ИННЮЛ="9017770974" КПП="757645784"/>
        </ОтпрДок>
        <Подписант ТипПодпис="1" СтатПодп="2" Должн="Не указана">
            <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович"/>
            <СвДоверЭл СпособПредставл="1" НомДовер="4a743152-e772-4249-9a47-e2e290258e79" ДатаВыдДовер="17.09.2018" ВнНомДовер="123" ДатаВнРегДовер="18.09.2018" СвСистХран="СвДоверЭл-ИдСистХран"/>
        </Подписант>
    </Документ>
</Файл>

  2. Вызовите метод PostMessagePatch (V4), чтобы отправить отказ.

    Пример тела запроса метода PostMessagePatch с отказом в подписи:

    {
    "BoxId": "{{boxId}}",
    "MessageId": "3815fb36-aabe-4588-8fe7-a1a33154278c",
    "XmlSignatureRejections": [
        {
            "ParentEntityId": "33ba16c68-cc54-4b25-b81c-0e79134e219d",
            "SignedContent":
            {
                "Content": "PD94bWwgdmVyc2l...LDQudC7Pg==",      // содержимое XML-файла в кодировке base-64
                "Signature": "MIIN5QYJKoZIhvc...KsTM6zixgz"      // содержимое файла подписи в кодировке base-64
            }
        }
    ]
}

После отказа в подписи титула Т2 документооборот ЭТрН считается завершенным. Для возобновления работы нужно создать новую ЭТрН.

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

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

Генерация Т3

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

  • documentTypeNamedId = LogisticsWaybill

  • documentFunction = delivery

  • documentVersion = kl_trn_mt_05_01

  • titleIndex = 2

  • letterId = {{letterId}} (значение из идентификатора Т1 или Т2)

  • documentId = {{documentId}} (значение из идентификатора Т1 или Т2)

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

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

Примечание

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

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

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

POST GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=LogisticsWaybill&documentFunction=delivery&documentVersion=kl_trn_mt_05_01&titleIndex=2&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"?>
<LogisticsWaybillConsigneeTitle
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    DocumentCreator="ООО Грузополучатель"    >
    
<ConsigneeInfo ReceivingOperation="0">
        <CargoAcceptance
            ActualArrivalDateTime="13.07.2022T14:42:19+05:00"
            ActualArrivalDateTimeEnablingTimeZone="1"
            ActualDepartureDateTime="13.07.2022T14:42:19+05:00"
            ActualDepartureDateTimeEnablingTimeZone="1"
            StatedArrivalDateTime="13.07.2022T14:42:19+05:00"
            StatedArrivalDateTimeEnablingTimeZone="1"
            PlaceCount="10"
            CargoActualStatus="Груз принят без замечаний"
            GrossWeightReceived="1500.000">
            
            <DeliveryAddress>
                <AddressLogisticsWaybill>
                    <RussianAddress
                        ZipCode="123456"
                        Region="77"
                        Territory="Район"
                        City="Москва"
                        Locality="Москва"
                        Street="Тверская"
                        Building="1"
                        Block="2"
                        Apartment="3" />
                </AddressLogisticsWaybill>
            </DeliveryAddress>
        </CargoAcceptance>
    </ConsigneeInfo>
    
    <Signer SignerType="1">
        <SignerDetails
            LastName="Тимофеев"
            FirstName="Алексей"
            MiddleName="Оскарович"
            Position="Администратор"/>
    </Signer>
</LogisticsWaybillConsigneeTitle>

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

<?xml version="1.0" encoding="windows-1251"?>
<Файл
    ИдФайл="ON_TRNACLGRPO_2BM-5077563809-149845330-202405291058200404443_2BM-2401878942-917245625-202405291049409629948_2BM-6638714825-902743835-202405291101053237625_0_20260423_4ca46d11-1cb1-4464-a564-99b3ad6608bb"
    ВерсФорм="5.01" ВерсПрог="Diadoc 1.0">
    <Документ КНД="1110341"
        ПоФактХЖ="Транспортная накладная, информация грузополучателя о приеме груза"
        ДатИнфГП="23.04.2026" ВрИнфГП="19:56:03" НаимЭконСубСост="ООО Грузополучатель">
        <ИдИнфПрвПрием
            ИдФайлИнфПрвПрием="ON_TRNACLPPRIN_2BM-6638714825-902743835-202405291101053237625_2BM-2401878942-917245625-202405291049409629948_2BM-5077563809-149845330-202405291058200404443_0_20260423_c7bee5bb-d3cb-4781-b22b-8c48617080d1"
            ДатФайлПрвПрием="23.04.2026" ВрФайлПрвПрием="10:06:21"
            ЭП="MIINWgYJKoZIhvcNAQcCoIINSzCCDUcCAQExDjAMBggqhQMHAQECAgUAMAsGCSqGSIb3DQEHAaCCCa4wggmqMIIJV6ADAgECAhEB8mrBAHay6qJKMzqi+DvGXzAKBggqhQMHAQEDAjCCAQoxHjAcBgkqhkiG9w0BCQEWD25vcmVwbHlAdGVzdC5ydTEYMBYGBSqFA2QBEg0wMDAwMDAwMDAwMDAwMRowGAYIKoUDA4EDAQESDDAwMDAwMDAwMDAwMDELMAkGA1UEBhMCUlUxMzAxBgNVBAgMKjY2INCh0LLQtdGA0LTQu9C+0LLRgdC60LDRjyDQvtCx0LvQsNGB0YLRjDEhMB8GA1UEBwwY0JXQutCw0YLQtdGA0LjQvdCx0YPRgNCzMSIwIAYDVQQJDBnQnNCw0LvQvtC/0YDRg9C00L3QsNGPLCA1MREwDwYDVQQKDAhFYXN5Q2VydDEWMBQGA1UEAwwN0KPQpiBFYXN5Q2VydDAeFw0yNTAxMzExMTM0MTNaFw0zNjA2MTEwOTEwMzdaMIICHjEVMBMGBSqFA2QEEgo2NjI2ODY0MDA4MT4wPAYJKoZIhvcNAQkBFi84MjJjZjBlZS0yMWRiLTQ5N2MtYTRmNy0yZWMxMzJhMmY0YzNAZG9tYWluLmNvbTEaMBgGCCqFAwOBAwEBEgwwMDY2MjY4NjQwMDgxFjAUBgUqhQNkAxILODc3MDY4MzkyNjYxGDAWBgUqhQNkARINMTA3MTkxNzM3NDkzNTEjMCEGA1UEDAwa0JDQtNC80LjQvdC40YHRgtGA0LDRgtC+0YAxGzAZBgNVBAsMEtCU0J/Qny4g0KPQoC4g0J7QoDE2MDQGA1UECgwt0J7QntCeINCQ0LTQvNC40L0g0JLRgdC10Lkg0JvQvtCz0LjRgdGC0LjQutC4MR8wHQYDVQQJDBbRg9C7LiDQndC+0LLQsNGPLCDQtC4xMRswGQYDVQQHDBLQpdCw0LHQsNGA0L7QstGB0LoxMzAxBgNVBAgMKjY2INCh0LLQtdGA0LTQu9C+0LLRgdC60LDRjyDQvtCx0LvQsNGB0YLRjDELMAkGA1UEBhMCUlUxKjAoBgNVBCoMIdCQ0LvQtdC60YHQtdC5INCe0YHQutCw0YDQvtCy0LjRhzEZMBcGA1UEBAwQ0KLQuNC80L7RhNC10LXQsjE2MDQGA1UEAwwt0J7QntCeINCQ0LTQvNC40L0g0JLRgdC10Lkg0JvQvtCz0LjRgdGC0LjQutC4MGYwHwYIKoUDBwEBAQEwEwYHKoUDAgIkAAYIKoUDBwEBAgIDQwAEQFJ/raruGe+xCrCZOsFFspCVGcsya5/Q1oo7BRborx2aTZU6q9GDdhUvf4AUjhFjWPaCaTXsyCxrnvXJqUPizJmjggV3MIIFczAMBgUqhQNkcgQDAgEAMA4GA1UdDwEB/wQEAwIE8DA6BgNVHREEMzAxgS84MjJjZjBlZS0yMWRiLTQ5N2MtYTRmNy0yZWMxMzJhMmY0YzNAZG9tYWluLmNvbTATBgNVHSAEDDAKMAgGBiqFA2RxATAvBgNVHSUEKDAmBggrBgEFBQcDAgYHKoUDAgIiBgYIKwYBBQUHAwQGByqFAwMHCAEwgb8GCCsGAQUFBwEBBIGyMIGvMFwGCCsGAQUFBzAChlBodHRwOi8vZXh0ZXJuLWFwaS50ZXN0a29udHVyLnJ1L2FpYS81ZDQ1NzlhZmI1NGUxOGMzZjkxY2U3OGEwZjUyNDUwNGNhMjg3MTE4LmNydDBPBggrBgEFBQcwAoZDaHR0cDovL3VjLWVhc3ljZXJ0L2FpYS81ZDQ1NzlhZmI1NGUxOGMzZjkxY2U3OGEwZjUyNDUwNGNhMjg3MTE4LmNydDArBgNVHRAEJDAigA8yMDI1MDEzMTExMzQxMlqBDzIwNDAwMTMxMTEzNDEyWjCCATMGBSqFA2RwBIIBKDCCASQMKyLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkMUyLQo9C00L7RgdGC0L7QstC10YDRj9GO0YnQuNC5INGG0LXQvdGC0YAgItCa0YDQuNC/0YLQvtCf0YDQviDQo9CmIiDQstC10YDRgdC40LggMi4wDE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI0LTM1NzAg0L7RgiAxNC4xMi4yMDE4DE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI4LTM1OTIg0L7RgiAxNy4xMC4yMDE4MDYGBSqFA2RvBC0MKyLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkwga4GA1UdHwSBpjCBozBWoFSgUoZQaHR0cDovL2V4dGVybi1hcGkudGVzdGtvbnR1ci5ydS9jZHAvNWQ0NTc5YWZiNTRlMThjM2Y5MWNlNzhhMGY1MjQ1MDRjYTI4NzExOC5jcmwwSaBHoEWGQ2h0dHA6Ly91Yy1lYXN5Y2VydC9jZHAvNWQ0NTc5YWZiNTRlMThjM2Y5MWNlNzhhMGY1MjQ1MDRjYTI4NzExOC5jcmwwUwYHKoUDAgIxAgRIMEYwNhYPaHR0cDovL3Rlc3QudXJpDB/QotC10YHRgtC+0LLQsNGPINGB0LjRgdGC0LXQvNCwAwIF4AQMIA7hs4PCiw1VCf6rMIIBTAYDVR0jBIIBQzCCAT+AFF1Fea+1ThjD+Rznig9SRQTKKHEYoYIBEqSCAQ4wggEKMR4wHAYJKoZIhvcNAQkBFg9ub3JlcGx5QHRlc3QucnUxGDAWBgUqhQNkARINMDAwMDAwMDAwMDAwMDEaMBgGCCqFAwOBAwEBEgwwMDAwMDAwMDAwMDAxCzAJBgNVBAYTAlJVMTMwMQYDVQQIDCo2NiDQodCy0LXRgNC00LvQvtCy0YHQutCw0Y8g0L7QsdC70LDRgdGC0YwxITAfBgNVBAcMGNCV0LrQsNGC0LXRgNC40L3QsdGD0YDQszEiMCAGA1UECQwZ0JzQsNC70L7Qv9GA0YPQtNC90LDRjywgNTERMA8GA1UECgwIRWFzeUNlcnQxFjAUBgNVBAMMDdCj0KYgRWFzeUNlcnSCEQGo+ZkARK2Tlkv2aabS4gNyMB0GA1UdDgQWBBQW55Fwhyvx+gPFyodZ2PhxLEg0PjAKBggqhQMHAQEDAgNBAJcoDaSqrJp2P0O+70VX886XOrFP1ZCYAg7C/NxDUyfRL9aCW+U/fwuzS9EG03GHhNOmwcgIGahiXd+4tvfwkNcxggNxMIIDbQIBATCCASEwggEKMR4wHAYJKoZIhvcNAQkBFg9ub3JlcGx5QHRlc3QucnUxGDAWBgUqhQNkARINMDAwMDAwMDAwMDAwMDEaMBgGCCqFAwOBAwEBEgwwMDAwMDAwMDAwMDAxCzAJBgNVBAYTAlJVMTMwMQYDVQQIDCo2NiDQodCy0LXRgNC00LvQvtCy0YHQutCw0Y8g0L7QsdC70LDRgdGC0YwxITAfBgNVBAcMGNCV0LrQsNGC0LXRgNC40L3QsdGD0YDQszEiMCAGA1UECQwZ0JzQsNC70L7Qv9GA0YPQtNC90LDRjywgNTERMA8GA1UECgwIRWFzeUNlcnQxFjAUBgNVBAMMDdCj0KYgRWFzeUNlcnQCEQHyasEAdrLqokozOqL4O8ZfMAwGCCqFAwcBAQICBQCgggHlMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTI2MDQyMzA3MDgwMFowLwYJKoZIhvcNAQkEMSIEIJTnsyyF7azr/57Vf/EiHE6Wts0vzTwzLIN8NectJC5aMIIBeAYLKoZIhvcNAQkQAi8xggFnMIIBYzCCAV8wggFbMAoGCCqFAwcBAQICBCAf3msDQZNDQYv6jnYlp9+C2aryfVRv4IuwLaEW+Pgh3TCCASkwggESpIIBDjCCAQoxHjAcBgkqhkiG9w0BCQEWD25vcmVwbHlAdGVzdC5ydTEYMBYGBSqFA2QBEg0wMDAwMDAwMDAwMDAwMRowGAYIKoUDA4EDAQESDDAwMDAwMDAwMDAwMDELMAkGA1UEBhMCUlUxMzAxBgNVBAgMKjY2INCh0LLQtdGA0LTQu9C+0LLRgdC60LDRjyDQvtCx0LvQsNGB0YLRjDEhMB8GA1UEBwwY0JXQutCw0YLQtdGA0LjQvdCx0YPRgNCzMSIwIAYDVQQJDBnQnNCw0LvQvtC/0YDRg9C00L3QsNGPLCA1MREwDwYDVQQKDAhFYXN5Q2VydDEWMBQGA1UEAwwN0KPQpiBFYXN5Q2VydAIRAfJqwQB2suqiSjM6ovg7xl8wCgYIKoUDBwEBAQEEQKSNPnm5TJj2hj7+ttg5Mr5Or3Xq6RhLu7fPIPphZp46XQrfZPidNkHThi8InRq+LKUpPIYp1Kg6tVkjqTZZiGQ=" />
        <СодИнфГП УИД_ТрН="cdad6a0c-9211-45fa-af83-2fff2b4a4e0f"
            СодОпПр="Лицом, управомоченным на получение груза, при указанных обстоятельствах принят от перевозчика груз с указанными характеристиками">
            <ПриемГрузГП ФДатВрПриб="13.07.2022T14:42:19+05:00" НалКоорТочВрФПр="1"
                ФДатВрУбыт="13.07.2022T14:42:19+05:00" НалКоорТочВрФУб="1"
                ЗаявДатВрПриб="13.07.2022T14:42:19+05:00" НалКоорТочВрЗПр="1" КолМестПриемЧ="10"
                ОбщСвСост="Груз принят без замечаний" МасБрутЗначПрием="1500.000">
                <АдрВыгруз>
                    <АдресРФ Индекс="123456" КодРегион="77" Район="Район" Город="Москва"
                        НаселПункт="Москва" Улица="Тверская" Дом="1" Корпус="2" Кварт="3" />
                </АдрВыгруз>
            </ПриемГрузГП>
        </СодИнфГП>
        <Подписант СтатПодп="1" Должн="Администратор">
            <ФИО Фамилия="Тимофеев" Имя="Алексей" Отчество="Оскарович" />
        </Подписант>
    </Документ>
</Файл>

Отправка Т3

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

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

  • TypeNamedId = LogisticsWaybill

  • Function = delivery

  • Version = kl_trn_mt_05_01

  • titleIndex = 1

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

Генерация Т4

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

  • documentTypeNamedId = LogisticsWaybill

  • documentFunction = delivery

  • documentVersion = kl_trn_mt_05_01

  • titleIndex = 3

  • letterId = {{letterId}} (значение из идентификатора Т1, Т2 или Т3)

  • documentId = {{documentId}} (значение из идентификатора Т1, Т2 или Т3)

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

Данные подписанта в UserDataXml нужно заполнить в универсальном формате.

Примечание

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

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

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

POST GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=LogisticsWaybill&documentFunction=delivery&documentVersion=kl_trn_mt_05_01&titleIndex=3&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"?>
<LogisticsWaybillCarrierTitle
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

    <Signer SignerType="1">
        <SignerDetails
            LastName="Тимофеев"
            FirstName="Алексей"
            MiddleName="Оскарович"
            Position="Администратор"/>
    </Signer>
</LogisticsWaybillCarrierTitle>

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

<?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="ON_TRNACLPVYN_2BM-5077563809-149845330-202405291058200404443_2BM-2401878942-917245625-202405291049409629948_2BM-6638714825-902743835-202405291101053237625_0_20260423_3fd65021-4a94-4b3c-8653-259b6b2e8bec"
    ВерсПрог="Diadoc 1.0" ВерсФорм="5.01">
    <Документ КНД="1110342"
        ПоФактХЖ="Транспортная накладная, информация перевозчика о выдаче груза грузополучателю"
        ДатИнфПрвВыд="23.04.2026" ВрИнфПрвВыд="20:09:26">
        <ИдИнфГП
            ИдФайлИнфГП="ON_TRNACLGROT_2BM-5077563809-149845330-202405291058200404443_2BM-6638714825-902743835-202405291101053237625_2BM-2401878942-917245625-202405291049409629948_0_20260423_efae3c03-094c-4904-914f-99da5561334d"
            ДатФайлИнфГП="" ВрФайлИнфГП=""
            ЭП="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" />
        <СодПрвВыд
            СодОпер="Груз с указанными характеристиками сдан водителем, уполномоченным перевозчиком на перевозку груза, лицу управомоченному на получение груза"
            УИД_ТрН="" />
        <Подписант СтатПодп="1" Должн="Администратор">
            <ФИО Фамилия="Тимофеев" Имя="Алексей" Отчество="Оскарович" />
        </Подписант>
    </Документ>
</Файл>

Отправка Т4

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

Титул перевозчика о стоимости (Т5)

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

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

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

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

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

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

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

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

Данные подписанта в UserDataXml нужно заполнить в универсальном формате.

Отправка Т5

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

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

  • TypeNamedId = LogisticsWaybill

  • Function = cost

  • Version = kl_trn_mt_05_01

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

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

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

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

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

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

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

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

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

Данные подписанта в UserDataXml нужно заполнить в универсальном формате.

Отправка Т6

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

Генерация и отправка отказа в подписи Т6

Грузоотправитель может отказаться от подписи Т6. В таком случае необходимо сгенерировать и отправить отказ в подписи титула. Для этого:

  1. Вызовите метод GenerateSignatureRejectionXml (V2), чтобы сгенерировать отказ. В теле запроса укажите причину отказа в подписи.

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

    POST V2/GenerateSignatureRejectionXml?boxid={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json charset=utf-8

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

    {
    "ErrorMessage": "Текстовый комментарий",
    "MessageId": "bbcedb0d-ce34-4e0d-b321-3f600c920935",
    "AttachmentId": "30cf2c07-7297-4d48-bc6f-ca7a80e2cf95",
    "SignerContent": "PD94bWwgdmVyc2l...LDQudC7Pg=="        // содержимое XML-файла с данными подписанта в кодировке Base-64
}

    Пример тела ответа метода GenerateSignatureRejectionXml:

    <?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="DP_UVUTOCH_2BM-9017770974-757645784-202407101104400484330_2BM-5242989368-732644841-202407101103418496883_20250416_6a0d86e6-f052-455d-a62b-7e684a3906ad" ВерсПрог="Diadoc 1.0" ВерсФорм="1.03">
    <Документ КНД="1115113">
        <УчастЭДО ИдУчастЭДО="2BM-5242989368-732644841-202407101103418496883">
            <ЮЛ НаимОрг="Продавец" ИННЮЛ="5242989368" КПП="732644841"/>
        </УчастЭДО>
        <СвУведУточ ДатаПол="16.04.2025" ВремяПол="10.05.46">
            <СведПолФайл ИмяПолФайла="Group12">
                <ЭППолФайл>MIIMiQYJKoZIhv...UNp8A
</ЭППолФайл>
            </СведПолФайл>
            <ТекстУведУточ>Текстовый комментарий
</ТекстУведУточ>
        </СвУведУточ>
        <ОтпрДок ИдУчастЭДО="2BM-9017770974-757645784-202407101104400484330">
            <ЮЛ НаимОрг="Покупатель" ИННЮЛ="9017770974" КПП="757645784"/>
        </ОтпрДок>
        <Подписант ТипПодпис="1" СтатПодп="2" Должн="Не указана">
            <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович"/>
            <СвДоверЭл СпособПредставл="1" НомДовер="4a743152-e772-4249-9a47-e2e290258e79" ДатаВыдДовер="17.09.2018" ВнНомДовер="123" ДатаВнРегДовер="18.09.2018" СвСистХран="СвДоверЭл-ИдСистХран"/>
        </Подписант>
    </Документ>
</Файл>

  2. Вызовите метод PostMessagePatch (V4), чтобы отправить отказ.

    Пример тела запроса метода PostMessagePatch с отказом в подписи:

    {
    "BoxId": "{{boxId}}",
    "MessageId": "3815fb36-aabe-4588-8fe7-a1a33154278c",
    "XmlSignatureRejections": [
        {
            "ParentEntityId": "33ba16c68-cc54-4b25-b81c-0e79134e219d",
            "SignedContent":
            {
                "Content": "PD94bWwgdmVyc2l...LDQudC7Pg==",      // содержимое XML-файла в кодировке base-64
                "Signature": "MIIN5QYJKoZIhvc...KsTM6zixgz"      // содержимое файла подписи в кодировке base-64
            }
        }
    ]
}

Отказ в подписи титула Т6 не завершит документооборот по ЭТрН. Для продолжения работы нужно снова отправить Т5 на подпись.

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

Титул переадресации (Т7)

Перевозчик отправляет грузоотправителю Т7 при изменении адреса выгрузки или грузополучателя. Сделать это необходимо после отправки Т2 и до поступления Т3. После подписания Т7 Государственная информационная система электронных перевозочных документов (ГИС ЭПД) направляет новый QR-код перевозочного документа.

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

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

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

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

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

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

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

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

  3. Обязательно заполните следующие атрибуты и элементы:

    • ДатВрНовВыгрПА — новые дата и время подачи транспортного средства под выгрузку.

    • НалКоорТочВрВгрПА — признак применения координации точного времени (UTC).

    • АдрВыгруз — новый адрес выгрузки. Внутри него обязательно должен быть заполнен один из элементов: АдресРФ, АдресИнф или КодГАР.

    • ОснПА — причина смены адреса. Внутри него обязательно должен быть заполнен один из элементов: НаимДок, НомерДок, ДатаДок или ИдДок.

  4. При замене грузополучателя на другое юридическое лицо в файле титула дополнительно укажите:

    • ИдПолИной — fnsParticipantId новой организации-грузополучателя.

    • СодИнфПА.НовГрузПол — реквизиты новой организации-грузополучателя.

Данные подписанта в UserDataXml нужно заполнить в универсальном формате.

Отправка Т7

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

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

  • TypeNamedId = LogisticsWaybill

  • Function = readdress

  • Version = kl_trn_mt_05_01

Титул эстафеты (Т8)

Перевозчик отправляет грузоотправителю Т8 при изменении водителя, транспортного средства, тягача или прицепа. Сделать это необходимо после отправки Т2 и до поступления Т3. После подписания Т8 ГИС ЭПД направляет новый QR-код перевозочного документа.

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

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

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

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

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

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

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

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

Данные подписанта в UserDataXml нужно заполнить в универсальном формате.

Отправка Т8

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

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

  • TypeNamedId = LogisticsWaybill

  • Function = relay

  • Version = kl_trn_mt_05_01

Парсинг титулов

Чтобы получить данные из полученного титула ЭТрН, используйте метод ParseTitleXml. Инструкция о парсинге приведена на странице Парсинг формализованного документа.

В теле запроса метода ParseTitleXml нужно передать XML-файл полученного титула.

Пример HTTP-запроса метода ParseTitleXml для Т1:

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

Пример тела запроса метода ParseTitleXml для Т1:

<?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="ON_TRNACLGROT_2BM-8461749043-340301528-202407101104400484330_2BM-8461749043-340301528-202407101104400484330_2BM-8461749043-340301528-202407101104400484330_1_20260417_b8224200-65fb-4be2-90be-83d176fc17d5" ВерсФорм="5.01" ВерсПрог="Diadoc 1.0">
  <ИдПолИной>1f208d03-2a60-4f64-91b1-b7aad54cfaf3</ИдПолИной>
  <Документ КНД="1110339" ПоФактХЖ="Транспортная накладная, информация грузоотправителя" ДатИнфГО="17.04.2026" ВрИнфГО="10:43:53">
    <СодИнфГО СодОпер="Лицом, осуществляющим погрузку груза, при указанных обстоятельствах передан водителю груз с указанными характеристиками" НомерТрН="2026/04/02-KMG-13" ДатаТрН="02.04.2026" НомЗак="Заказ Транспорта" ДатаЗак="02.04.2026">
      <СвГО ГОЭксп="0">
        <РекИдентГО>
          <ИдСв>
            <СвЮЛУч НаимОрг="Организация-получатель" ИННЮЛ="8461749043" КПП="340301528" />
          </ИдСв>
          <Адрес>
            <АдрРФ Индекс="620142" КодРегион="66" Город="Екатеринбург" Улица="Сажинская" Дом="11" />
          </Адрес>
          <Контакт>
            <Тлф>9005567834</Тлф>
          </Контакт>
        </РекИдентГО>
      </СвГО>
      <СвГП>
        <РекИдентГП>
          <ИдСв>
            <СвЮЛУч НаимОрг="Организация-получатель" ИННЮЛ="8461749043" КПП="340301528" />
          </ИдСв>
          <Адрес>
            <АдрРФ Индекс="620142" КодРегион="66" Город="Екатеринбург" Улица="Сажинская" Дом="11" />
          </Адрес>
          <Контакт>
            <Тлф>9056678765</Тлф>
          </Контакт>
        </РекИдентГП>
        <АдресДостГр>
          <АдресРФ Индекс="620050" КодРегион="66" Город="Екатеринбург" />
        </АдресДостГр>
      </СвГП>
      <СвГруз>
        <ОпГруз НаимГруз="Мармелад" СостГруз="Отличное" СпУпак="Коробки" ВидТар="00" КолМестГр="200" УчГосСист="0">
          <Марк>Отсутствует</Марк>
          <ПлМасГруз МасБрутЗнач="2000" />
        </ОпГруз>
        <ОпГруз НаимГруз="Шоколад" СостГруз="Целый" СпУпак="Коробки" ВидТар="1W" КолМестГр="10" УчГосСист="0">
          <Марк>Отсутствует</Марк>
          <ПлМасГруз МасБрутЗнач="35" />
        </ОпГруз>
      </СвГруз>
      <УказГО УкНормПрвз="Отсутствует">
        <СвПА СпосПерУкПА="Электронное уведомление перевозчика о переадресовке" ЛицоПА="Грузоотправитель">
          <КонтПА>
            <Тлф>9876543</Тлф>
          </КонтПА>
        </СвПА>
      </УказГО>
      <СвПер>
        <ИдСв>
          <СвЮЛУч НаимОрг="Организация-получатель" ИННЮЛ="8461749043" КПП="340301528" />
        </ИдСв>
        <Адрес>
          <АдрРФ Индекс="620142" КодРегион="66" Город="Екатеринбург" Улица="Сажинская" Дом="11" />
        </Адрес>
        <Контакт>
          <Тлф>89002827262</Тлф>
        </Контакт>
      </СвПер>
      <СвВодит НомВУ="1234567890" СерВУ="1234" ДатаВыдВУ="01.01.2015">
        <Тлф>+79124643655</Тлф>
        <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
      </СвВодит>
      <СвТС>
        <ТС РегНомер="3333" ТипВлад="1">
          <ПарТС Тип="тягач с прицепом" Марка="Хендай" Грузопод="3333" Вместим="3333" />
        </ТС>
      </СвТС>
      <СвПогруз ЗаявПогр="13.07.2022T14:42:19+05:00" НалКоорТочВрЗаяв="1" ФДатВрПриб="13.07.2022T14:42:19+05:00" НалКоорТочВрФПогр="1" ФДатВрУбыт="13.07.2022T14:42:00+05:00" НалКоорТочВрФУбыт="1" МасБрутОтгр="2035" МетОпрМасс="01" КолМестПрием="210">
        <ФАдресПогр>
          <АдресРФ Индекс="603152" КодРегион="50" Город="Нижний Новгород" Улица="Ларина" Дом="19" />
        </ФАдресПогр>
        <СвЛицПогрГр СовпГОП="1">
          <РабЛицПогрГр Должность="Сотрудник">
            <ОДолжОб>Должностные обязанности</ОДолжОб>
            <ФИО Фамилия="Сидорова" Имя="Екатерина" />
          </РабЛицПогрГр>
          <ИдентРекГО>
            <ИННЮЛ>3967297970</ИННЮЛ>
          </ИдентРекГО>
        </СвЛицПогрГр>
        <ВладИнфр СовпГОВ="1">
          <ИдентРекГО>
            <ИННЮЛ>3967297970</ИННЮЛ>
          </ИдентРекГО>
        </ВладИнфр>
      </СвПогруз>
    </СодИнфГО>
    <Подписант СтатПодп="1" Должн="Администратор">
      <ФИО Фамилия="Петров" Имя="Петр" Отчество="Петрович" />
    </Подписант>
  </Документ>
</Файл>

Пример тела ответа метода ParseTitleXml для Т1:

<?xml version="1.0" encoding="utf-8"?>
<LogisticsWaybillConsignorTitle Number="2026/04/02-KMG-13" Date="02.04.2026" OrderNumber="Заказ Транспорта" OrderDate="02.04.2026">
  <OtherRecipientIds>
    <OtherRecipientId>1f208d03-2a60-4f64-91b1-b7aad54cfaf3</OtherRecipientId>
  </OtherRecipientIds>
  <WaybillInfo>
    <ShipperInfo IsFreightForwarder="0">
      <Shipper>
        <OrganizationDetails FnsParticipantId="2BM-8461749043-340301528-202407101104400484330" OrgType="2" OrgName="Организация-получатель" Inn="8461749043" Kpp="340301528">
          <Phones>
            <Phone>9005567834</Phone>
          </Phones>
          <Address>
            <RussianAddress Region="66" ZipCode="620142" City="Екатеринбург" Street="Сажинская" Building="11" />
          </Address>
        </OrganizationDetails>
      </Shipper>
    </ShipperInfo>
    <ConsigneeInfo>
      <Consignee>
        <OrganizationDetails FnsParticipantId="2BM-8461749043-340301528-202407101104400484330" OrgType="2" OrgName="Организация-получатель" Inn="8461749043" Kpp="340301528">
          <Phones>
            <Phone>9056678765</Phone>
          </Phones>
          <Address>
            <RussianAddress Region="66" ZipCode="620142" City="Екатеринбург" Street="Сажинская" Building="11" />
          </Address>
        </OrganizationDetails>
      </Consignee>
      <DeliveryAddres>
        <AddressLogisticsWaybill>
          <RussianAddress Region="66" ZipCode="620050" City="Екатеринбург" />
        </AddressLogisticsWaybill>
      </DeliveryAddres>
    </ConsigneeInfo>
    <CargoInfo>
      <ItemDescriptions>
        <ItemDescription Name="Мармелад" Condition="Отличное" PackageMethod="Коробки" ContainerType="00" CargoSpaceQuantity="200" IsForStateSystemRegistration="0">
          <Marks>
            <Mark>Отсутствует</Mark>
          </Marks>
          <PlannedMass GrossWeight="2000" />
        </ItemDescription>
        <ItemDescription Name="Шоколад" Condition="Целый" PackageMethod="Коробки" ContainerType="1W" CargoSpaceQuantity="10" IsForStateSystemRegistration="0">
          <Marks>
            <Mark>Отсутствует</Mark>
          </Marks>
          <PlannedMass GrossWeight="35" />
        </ItemDescription>
      </ItemDescriptions>
    </CargoInfo>
    <ConsignorDirectives TransportationDirectives="Отсутствует">
      <ReaddressDetails AccountableSide="Consignor">
        <Phones>
          <Phone>9876543</Phone>
        </Phones>
      </ReaddressDetails>
    </ConsignorDirectives>
    <Carrier>
      <OrganizationDetails FnsParticipantId="2BM-8461749043-340301528-202407101104400484330" OrgType="2" OrgName="Организация-получатель" Inn="8461749043" Kpp="340301528">
        <Phones>
          <Phone>89002827262</Phone>
        </Phones>
        <Address>
          <RussianAddress Region="66" ZipCode="620142" City="Екатеринбург" Street="Сажинская" Building="11" />
        </Address>
      </OrganizationDetails>
    </Carrier>
    <Drivers>
      <DriverInfo LastName="Иванов" FirstName="Иван" MiddleName="Иванович" LicenseNumber="1234567890" LicenseSeries="1234" LicenseDate="01.01.2015">
        <Phones>
          <Phone>+79124643655</Phone>
        </Phones>
      </DriverInfo>
    </Drivers>
    <VehicleInfo>
      <Vehicle Number="3333" Type="тягач с прицепом" Model="Хендай" MaxWeight="3333" Capacity="3333" Ownership="1" />
    </VehicleInfo>
    <LoadingInfo StatedArrivalDateTime="13.07.2022T14:42:19+05:00" StatedArrivalDateTimeEnablingTimeZone="1" ActualArrivalDateTime="13.07.2022T14:42:19+05:00" ActualArrivalDateTimeEnablingTimeZone="1" ActualDepartureDateTime="13.07.2022T14:42:00+05:00" ActualDepartureDateTimeEnablingTimeZone="1" GrossWeight="2035" WeighingMethod="01" NumberOfPlaces="210">
      <ActualLoadingAddress>
        <AddressLogisticsWaybill>
          <RussianAddress Region="50" ZipCode="603152" City="Нижний Новгород" Street="Ларина" Building="19" />
        </AddressLogisticsWaybill>
      </ActualLoadingAddress>
      <LoadingPartyDetails MatchingShipper="1">
        <LoadingPartyEmployee Position="Сотрудник">
          <JobResponsibilities>Должностные обязанности</JobResponsibilities>
          <Fio LastName="Сидорова" FirstName="Екатерина" />
        </LoadingPartyEmployee>
        <RequisitesShipper Inn="3967297970" />
      </LoadingPartyDetails>
      <LoadingOwnerDetails Type="1">
        <RequisitesShipper Inn="3967297970" />
      </LoadingOwnerDetails>
    </LoadingInfo>
  </WaybillInfo>
  <Signers>
    <Signer SignerStatus="1">
      <Fio FirstName="Петр" LastName="Петров" MiddleName="Петрович" />
      <Position PositionSource="Manual">Администратор</Position>
    </Signer>
  </Signers>
</LogisticsWaybillConsignorTitle>

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

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

Обратите внимание, что одна перевозка ЭТрН представлена в Диадоке набором однотитульных или двухтитульных документов:

  • Т1 и Т2 — титулы одного двухтитульного документа,

  • Т3 и Т4 — титулы одного двухтитульного документа,

  • Т5 и Т6 — титулы одного двухтитульного документа,

  • Т7, Т8 — однотитульные документы.

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

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

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

Информация о титулах ЭТрН

Титул

Имя файла

Функция

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

ON_TRNACLGROT

reception

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

ON_TRNACLPPRIN

reception

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

ON_TRNACLGRPO

delivery

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

ON_TRNACLPVYN

delivery

Титул перевозчика о стоимости (Т5)

ON_TRNPUDPER

cost

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

ON_TRNPUDGO

cost

Титул переадресовки (Т7)

ON_TRNPEREADR

readdress

Титул эстафеты (Т8)

ON_TRNZAMEN

relay

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

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

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

Получение титулов методом GetDocuments

Чтобы найти ЭТрН с помощью метода GetDocuments (V4), передайте в теле запроса значение типа документа DocumentTypeNamedIds = LogisticsWaybill. Метод также позволяет фильтровать документы по идентификаторам Минтранса и перевозки.

Пример тела запроса метода GetDocuments с идентификатором Минтранса:

{
    "CustomData": [
        {
            "Key": "mt-id",
            "Value": "<УИД Минтранса>"
        }
    ]
}

Пример тела запроса метода GetDocuments с идентификатором перевозки:

{
    "CustomData": [
        {
            "Key": "kl-id",
            "Value": "<Идентификатор перевозки>"
        }
    ]
}

Из полученного в ответе метода списка DocumentList можно получить информацию о каждом документе. Инструкция приведена в разделе Получение сведений о документах.

Получение титулов методом SearchDocflows

Чтобы найти ЭТрН с помощью метода SearchDocflows (V4), передайте в теле запроса строку с идентификатором Минтранса или перевозки и ограничьте область поиска входящими документами.

Пример тела запроса метода SearchDocflows с идентификатором перевозки:

{
    "QueryString": "kl-id:xxxxxxx",
    "Scope": "SearchScopeInbound"
}

Получение документооборота

Для получения всего документооборота по ЭТрН используйте метод GenerateDocumentZip. Инструкция о получении архива документов приведена на странице Генерация архива документооборота.

Соответствие титулов и префиксов имени файла описано в разделе Формат имени файла.