Работа с УПД

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

Примечание

Методы и подходы, описанные ниже, можно использовать для работы с УПД, накладными, актами и счетами-фактурами, а также с универсальными корректировочными документами (УКД), исправлениями УПД (ИУПД) и исправлениями УКД (ИУКД).

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

• Продавец:

  • генерирует титул продавца,

  • подписывает и отправляет его покупателю.

• Покупатель:

  • получает титул продавца,

  • генерирует и отправляет продавцу извещение о получении — обязательно или по запросу продавца, в зависимости от вида документооборота,

  • парсит полученный титул — при необходимости,

  • генерирует титул покупателя — если это предусмотрено видом документооборота,

  • подписывает и отправляет его продавцу,

  • отправляет продавцу уведомление об уточнении — при необходимости, если это предусмотрено видом документооборота.

Генерация титула продавца

Для генерации титула продавца используйте метод GenerateTitleXml. Инструкция о генерации приведена в разделе Генерация титула отправителя.

Чтобы сгенерировать титул продавца, нужно получить необходимую информацию из метода GetDocumentTypes (V2). Инструкция о получении данных для титула из метода GetDocumentTypes приведена в разделе Данные для генерации титула.

Из ответа метода GetDocumentTypes для титула продавца возьмем следующие значения для параметров метода GenerateTitleXml:

• documentTypeNamedId = UniversalTransferDocument

• documentFunction = СЧФДОП

• documentVersion = utd970_05_03_01

• titleIndex = 0 (титул продавца)

Кроме этого нужно подготовить содержимое титула — упрощенный XML-файл UserDataXml. Схемы XSD и UserDataXSD можно скачать в разделе XSD-схемы.

С помощью полученных данных можно сгенерировать титул продавца методом GenerateTitleXml.

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

POST /GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=UniversalTransferDocument&documentFunction=СЧФДОП&documentVersion=utd970_05_03_01&titleIndex=0 HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/xml; charset=utf-8

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

<UniversalTransferDocument Function="СЧФДОП" DocumentDate="01.02.2023" DocumentNumber="123" Currency="643" Uid="UID" ApprovedStructureAdditionalInfoFields="1111.2222.0000" DocumentName="Документ о передаче товаров (работ, услуг, имущественных прав)" SenderFnsParticipantId="2BM-9681265956-968101000-202207281000014689156" RecipientFnsParticipantId="2BM-9677800047-967701000-202207281004154081709" FileIdSeller="СвСчФакт-ИмяФайлИспрПрод" FileIdBuyer="СвСчФакт-ИмяФайлИспрПок" CurrencyRate="12" GovernmentContractInfo="1234567890123456789012345" DocumentCreator="Документ-НаимЭконСубСост" CircumFormat="12345" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <Sellers>
        <Seller>
            <OrganizationDetails Okpo="0166273597" Okopf="12200" FullNameOkopf="СвПрод-ПолнНаимОПФ" Department="СвПрод-СтруктПодр" OrganizationAdditionalInfo="СвПрод-ИнфДляУчаст" ShortOrgName="СвПрод-СокрНаим" OtherContactInfo="Контакт-ИнКонт" CorrespondentAccount="30101810500000000641" BankAccountNumber="49634485849155" BankName="СИБИРСКИЙ БАНК ПАО СБЕРБАНК" BankId="045004641" OrgType="2" OrgName="СвЮЛУч-НаимОрг" Inn="9103624367" Kpp="187245452">
                <Phones>
                    <Phone>8-343-123-4567</Phone>
                </Phones>
                <Emails>
                    <Email>email@sample.com</Email>
                </Emails>
                <Address>
                    <RussianAddress Region="72" ZipCode="344249" Territory="Тюмень" City="Тюмень" Locality="АдрРФ-НаселПункт" Street="АдрРФ-Улица" Building="АдрРФ-Дом" Block="АдрРФ-Корпус" Apartment="АдрРФ-Кварт" OtherInfo="АдрРФ-ИныеСвед"/>
                </Address>
            </OrganizationDetails>
        </Seller>
    </Sellers>
    <Shippers>
        <Shipper>
            <OrganizationDetails Okpo="76098674" Okopf="12000" FullNameOkopf="ГрузОтпр-ПолнНаимОПФ" Department="ГрузОтпр-СтруктПодр" OrganizationAdditionalInfo="ГрузОтпр-ИнфДляУчаст" ShortOrgName="ГрузОтпр-СокрНаим" OrgType="1" OrgName="Иванов Иван Иванович" Inn="753381367749" Ogrn="421319982803452" OgrnDate="12.12.2012" IndividualEntityRegistrationCertificate="СвИП-СвГосРегИП" OrganizationOrPersonInfo="СвИП-ИныеСвед">
                <Address>
                    <GarAddress AddressCode="03510210-e5f3-4bc6-bbd2-24d7fe25b3ed" Region="72" ZipCode="450133" LandPlot="ЗемелУчасток">
                        <MunicipalTerritory Type="1" NameOrNumber="МуниципРайон-Наим"/>
                        <UrbanSettlement Type="1" NameOrNumber="ГородСелПоселен-Наим"/>
                        <Locality Type="НаселенПункт" NameOrNumber="НаселенПункт-Наим"/>
                        <ElementPlanningStructure Type="ЭлПланСтруктур" NameOrNumber="ЭлПланСтруктур-Наим"/>
                        <ElementRoadNetwork Type="ЭлУлДорСети" NameOrNumber="ЭлУлДорСети-Наим"/>
                        <Buildings>
                            <Building Type="Здание" NameOrNumber="Здание-Номер"/>
                        </Buildings>
                        <RoomBuilding Type="ПомещЗдания" NameOrNumber="ПомещЗдания-Номер"/>
                        <RoomApartment Type="ПомещКвартиры" NameOrNumber="ПомещКвартиры-Номер"/>
                    </GarAddress>
                </Address>
            </OrganizationDetails>
        </Shipper>
    </Shippers>
    <Consignees>
        <Consignee>
            <OrganizationDetails Okpo="18989253" Okopf="12000" FullNameOkopf="ГрузПолуч-ПолнНаимОПФ" Department="ГрузПолуч-СтруктПодр" OrganizationAdditionalInfo="ГрузПолуч-ИнфДляУчаст" ShortOrgName="ГрузПолуч-СокрНаим" BankAccountNumber="569712456874" BankName="ЗАО Сбербанк России, отделение на Московской 11" BankId="012345671" OrgType="3" OrgName="Петров Петр Петрович" Inn="518191632595" PersonStatusId="1" OrganizationOrPersonInfo="СвФЛУч-ИныеСвед">
                <Address>
                    <ForeignAddress Country="112" Address="АдрИнф-АдрТекст"/>
                </Address>
            </OrganizationDetails>
        </Consignee>
    </Consignees>
    <PaymentDocuments>
        <Document Number="СЧФ/123/456" Date="01.02.2023" Total="1000"/>
    </PaymentDocuments>
    <DocumentShipments>
        <DocumentShipment DocumentName="Документ о передаче товаров (работ, услуг, имущественных прав)" DocumentNumber="123" DocumentDate="01.02.2023">
            <IdentificationDetails Inn="1978337389"/>
        </DocumentShipment>
    </DocumentShipments>
    <Buyers>
        <Buyer>
            <OrganizationDetails Okpo="74047744" Okopf="12200" FullNameOkopf="СвПокуп-ПолнНаимОПФ" Department="СвПокуп-СтруктПодр" OrganizationAdditionalInfo="СвПокуп-ИнфДляУчаст" ShortOrgName="СвПокуп-СокрНаим" OrgType="2" OrgName="СвЮЛУч-НаимОрг" Inn="1234567894" Kpp="667301001">
                <Address>
                    <ForeignAddress Country="112" Address="АдрИнф-АдрТекст"/>
                </Address>
            </OrganizationDetails>
        </Buyer>
    </Buyers>
    <CommitmentTypes>
        <CommitmentType CommitmentTypeCode="1" CommitmentTypeName="ВидОбяз-НаимВидОбяз"/>
    </CommitmentTypes>
    <SellerInfoCircumPublicProc DateStateContract="02.02.2022" NumberStateContract="5" SellerTreasuryCode="0160"/>
    <FactorInfo>
        <OrganizationDetails Okpo="74047744" Okopf="12000" FullNameOkopf="СвФактор-ПолнНаимОПФ" Department="СвФактор-СтруктПодр" OrganizationAdditionalInfo="СвФактор-ИнфДляУчаст" ShortOrgName="СвФактор-СокрНаим" OrgType="1" OrgName="ФИО-Фамилия ФИО-Имя ФИО-Отчество" Inn="916363626153" Ogrn="421032906553286" OgrnDate="21.08.2019" OrganizationOrPersonInfo="СвИП-ИныеСвед">
            <Address>
                <RussianAddress Region="72" ZipCode="344249" Territory="Тюмень" City="Тюмень" Locality="АдрРФ-НаселПункт" Street="АдрРФ-Улица" Building="АдрРФ-Дом" Block="АдрРФ-Корпус" Apartment="АдрРФ-Кварт" OtherInfo="АдрРФ-ИныеСвед"/>
            </Address>
        </OrganizationDetails>
    </FactorInfo>
    <MainAssignMonetaryClaim DocumentName="ОснУстДенТреб-РеквНаимДок" DocumentNumber="144" DocumentDate="04.04.2004">
        <IdentificationDetails Inn="342265432525"/>
    </MainAssignMonetaryClaim>
    <AccompanyingDocuments>
        <AccompanyingDocument DocumentName="СопрДокФХЖ-РеквНаимДок" DocumentNumber="876" DocumentDate="05.05.2005">
            <IdentificationDetails StatusId="PhysicalPerson" Country="112" OrgName="ДаннИно-Наим" LegalEntityId="ДаннИно-Идентиф" OrganizationOrPersonInfo="ДаннИно-ИныеСвед"/>
        </AccompanyingDocument>
    </AccompanyingDocuments>
    <AdditionalInfoId InfoFileId="5b0a8e80-1a7b-4194-a64d-60ca9f10dd82">
        <AdditionalInfo Id="ТекстИнф-Идентиф" Value="ТекстИнф-Идентиф"/>
    </AdditionalInfoId>
    <Table TotalWithVatExcluded="8965" Vat="456.00" Total="10000">
        <Item TaxRate="TwentyPercent" Product="СведТов-НаимТов" Unit="113" UnitName="м" Quantity="16" Price="200" SubtotalWithVatExcluded="654" Vat="1000.000000000000000" RestoredVat="550" Subtotal="784.8" ItemMark="5" AdditionalProperty="Приз" ItemToRelease="102" ItemKind="СортТов" ItemSeries="ДопСведТов-СерияТов" Gtin="10000057074365" ItemTypeCode="1111111111" ProductTypeCode="676">
            <CustomsDeclarations>
                <CustomsDeclaration Country="980" DeclarationNumber="123456"/>
            </CustomsDeclarations>
            <AccompanyingDocuments>
                <AccompanyingDocument DocumentName="СопрДокТов-РеквНаимДок" DocumentNumber="144" DocumentDate="04.04.2004">
                    <IdentificationDetails Inn="342265432525"/>
                </AccompanyingDocument>
            </AccompanyingDocuments>
            <DepreciationInfo DepreciationGroup="13" Okof="165" UsefulPeriod="23" ActualPeriod="100"/>
            <ItemTracingInfos>
                <ItemTracingInfo RegNumberUnit="10001000/010123/1234567/001" Unit="778" Quantity="30" PriceWithVatExcluded="100"/>
            </ItemTracingInfos>
            <ItemIdentificationNumbers>
                <ItemIdentificationNumber TransPackageId="НомСредИдентТов-ИдентТрансУпак" QuantityMark="100" BatchMarkCode="111">
                    <Unit>НомСредИдентТов-КИЗ</Unit>
                </ItemIdentificationNumber>
            </ItemIdentificationNumbers>
        </Item>
        <Item TaxRate="TwentyPercent" Product="Product2 &gt; 2.0 мм" Unit="778" UnitName="уп" Quantity="114.100" Price="516.67" SubtotalWithVatExcluded="58951.67" Vat="1000" RestoredVat="1345" Subtotal="70742.00" ItemMark="5" AdditionalProperty="ДопП" ItemVendorCode="ДопСведТов-КодТов" ItemToRelease="505" ItemCharact="ДопСведТов-ХарактерТов" ItemArticle="ДопСведТов-АртикулТов" ItemKind="СортТов" ItemSeries="ДопСведТов-СерияТов" Gtin="10000057074365" ItemTypeCode="1111111111">
            <CustomsDeclarations>
                <CustomsDeclaration Country="178" DeclarationNumber="555555"/>
            </CustomsDeclarations>
            <DepreciationInfo DepreciationGroup="12" Okof="165" UsefulPeriod="234" ActualPeriod="100"/>
        </Item>
    </Table>
    <TransferInfo OperationInfo="СвПер-СодОпер" OperationType="СвПер-ВидОпер" TransferDate="15.02.2024" TransferStartDate="16.02.2024" TransferEndDate="16.02.2024">
        <CreatedThingTransferDocument DocumentName="ДокПерВещ-РеквНаимДок" DocumentNumber="098" DocumentDate="03.02.2024">
            <IdentificationDetails Inn="4620212891"/>
        </CreatedThingTransferDocument>
        <TransferBases>
            <TransferBase DocumentName="ОснПер-РеквНаимДок" DocumentNumber="567" DocumentDate="14.02.2024">
                <IdentificationDetails Inn="144647873819"/>
            </TransferBase>
        </TransferBases>
        <OtherIssuer LastName="Иванов" FirstName="Иван" MiddleName="Иванович" Position="ПредОргПер-Должность" EmployeeInfo="ПредОргПер-ИныеСвед" OrganizationName="ПредОргПер-НаимОргПер">
            <EmployeeBase DocumentName="ОснПолнПредПер-РеквНаимДок" DocumentNumber="098" DocumentDate="03.02.2024">
                <IdentificationDetails Inn="4620212891"/>
            </EmployeeBase>
            <OrganizationBase DocumentName="ОснДоверОргПер-РеквНаимДок" DocumentNumber="098" DocumentDate="03.02.2024">
                <IdentificationDetails Inn="4620212891"/>
            </OrganizationBase>
        </OtherIssuer>
        <AdditionalInfoId InfoFileId="9c3adc2b-a085-4acd-af8c-3494290d782c">
            <AdditionalInfo Id="Идентиф1в" Value="Значен1в"/>
            <AdditionalInfo Id="Идентиф2в" Value="Значен2в"/>
        </AdditionalInfoId>
    </TransferInfo>
    <Signers>
        <Signer SignerPowersConfirmationMethod="6">
            <Fio FirstName="Иван" LastName="Иванов" MiddleName="Иванович"/>
            <Position PositionSource="Manual">Должность</Position>
        </Signer>
    </Signers>
    <DocumentCreatorBase DocumentName="ОснДоверОргСост-РеквНаимДок" DocumentNumber="123" DocumentDate="01.02.2023">
        <IdentificationDetails StatusId="PhysicalPerson" Country="112" OrgName="ДаннИно-Наим" LegalEntityId="ДаннИно-Идентиф" OrganizationOrPersonInfo="ДаннИно-ИныеСвед"/>
    </DocumentCreatorBase>
</UniversalTransferDocument>

Пример тела ответа метода GenerateTitleXml (титул продавца):

<?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="ON_NSCHFDOPPR_2BM-9677800047-967701000-202207281004154081709_2BM-9681265956-968101000-202207281000014689156_20250116_8c703486-75df-46f8-8f0a-959b09f807a9_1_1_0_0_1_00" ВерсФорм="5.03" ВерсПрог="Diadoc 1.0">
  <Документ КНД="1115131" ВремИнфПр="18.13.16" ДатаИнфПр="16.01.2025" Функция="СЧФДОП" ПоФактХЖ="Документ об отгрузке товаров (выполнении работ), передаче имущественных прав (документ об оказании услуг)" НаимДокОпр="Документ о передаче товаров (работ, услуг, имущественных прав)" УИД="UID" НаимЭконСубСост="Документ-НаимЭконСубСост" СоглСтрДопИнф="1111.2222.0000">
    <СвСчФакт НомерДок="123" ДатаДок="01.02.2023" ИмяФайлИспрПрод="СвСчФакт-ИмяФайлИспрПрод" ИмяФайлИспрПок="СвСчФакт-ИмяФайлИспрПок">
      <СвПрод ОКПО="0166273597" КодОПФ="12200" ПолнНаимОПФ="СвПрод-ПолнНаимОПФ" СтруктПодр="СвПрод-СтруктПодр" ИнфДляУчаст="СвПрод-ИнфДляУчаст" СокрНаим="СвПрод-СокрНаим">
        <ИдСв>
          <СвЮЛУч НаимОрг="СвЮЛУч-НаимОрг" ИННЮЛ="9103624367" КПП="187245452" />
        </ИдСв>
        <Адрес>
          <АдрРФ КодРегион="72" НаимРегион="Тюменская область" Индекс="344249" Район="Тюмень" Город="Тюмень" НаселПункт="АдрРФ-НаселПункт" Улица="АдрРФ-Улица" Дом="АдрРФ-Дом" Корпус="АдрРФ-Корпус" Кварт="АдрРФ-Кварт" ИныеСвед="АдрРФ-ИныеСвед" />
        </Адрес>
        <БанкРекв НомерСчета="49634485849155">
          <СвБанк НаимБанк="СИБИРСКИЙ БАНК ПАО СБЕРБАНК" БИК="045004641" КорСчет="30101810500000000641" />
        </БанкРекв>
        <Контакт ИнКонт="Контакт-ИнКонт">
          <Тлф>8-343-123-4567</Тлф>
          <ЭлПочта>email@google.com</ЭлПочта>
        </Контакт>
      </СвПрод>
      <ГрузОт>
        <ГрузОтпр ОКПО="76098674" КодОПФ="12000" ПолнНаимОПФ="ГрузОтпр-ПолнНаимОПФ" СтруктПодр="ГрузОтпр-СтруктПодр" ИнфДляУчаст="ГрузОтпр-ИнфДляУчаст" СокрНаим="ГрузОтпр-СокрНаим">
          <ИдСв>
            <СвИП ИННФЛ="753381367749" СвГосРегИП="СвИП-СвГосРегИП" ОГРНИП="421319982803452" ДатаОГРНИП="12.12.2012" ИныеСвед="СвИП-ИныеСвед">
              <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
            </СвИП>
          </ИдСв>
          <Адрес>
            <АдрГАР ИдНом="03510210-e5f3-4bc6-bbd2-24d7fe25b3ed" Индекс="450133">
              <Регион>72</Регион>
              <НаимРегион>Тюменская область</НаимРегион>
              <МуниципРайон ВидКод="1" Наим="МуниципРайон-Наим" />
              <ГородСелПоселен ВидКод="1" Наим="ГородСелПоселен-Наим" />
              <НаселенПункт Вид="НаселенПункт" Наим="НаселенПункт-Наим" />
              <ЭлПланСтруктур Тип="ЭлПланСтруктур" Наим="ЭлПланСтруктур-Наим" />
              <ЭлУлДорСети Тип="ЭлУлДорСети" Наим="ЭлУлДорСети-Наим" />
              <ЗемелУчасток>ЗемелУчасток</ЗемелУчасток>
              <Здание Тип="Здание" Номер="Здание-Номер" />
              <ПомещЗдания Тип="ПомещЗдания" Номер="ПомещЗдания-Номер" />
              <ПомещКвартиры Тип="ПомещКвартиры" Номер="ПомещКвартиры-Номер" />
            </АдрГАР>
          </Адрес>
        </ГрузОтпр>
      </ГрузОт>
      <ГрузПолуч ОКПО="18989253" КодОПФ="12000" ПолнНаимОПФ="ГрузПолуч-ПолнНаимОПФ" СтруктПодр="ГрузПолуч-СтруктПодр" ИнфДляУчаст="ГрузПолуч-ИнфДляУчаст" СокрНаим="ГрузПолуч-СокрНаим">
        <ИдСв>
          <СвФЛУч ИННФЛ="518191632595" ИдСтатЛ="1" ИныеСвед="СвФЛУч-ИныеСвед">
            <ФИО Фамилия="Петров" Имя="Петр" Отчество="Петрович" />
          </СвФЛУч>
        </ИдСв>
        <Адрес>
          <АдрИнф КодСтр="112" НаимСтран="Беларусь" АдрТекст="АдрИнф-АдрТекст" />
        </Адрес>
        <БанкРекв НомерСчета="569712456874">
          <СвБанк НаимБанк="ЗАО Сбербанк России, отделение на Московской 11" БИК="012345671" />
        </БанкРекв>
      </ГрузПолуч>
      <СвПРД НомерПРД="СЧФ/123/456" ДатаПРД="01.02.2023" СуммаПРД="1000.00" />
      <ДокПодтвОтгрНом РеквНаимДок="Документ о передаче товаров (работ, услуг, имущественных прав)" РеквНомерДок="123" РеквДатаДок="01.02.2023">
        <РеквИдРекСост>
          <ИННЮЛ>1978337389</ИННЮЛ>
        </РеквИдРекСост>
      </ДокПодтвОтгрНом>
      <СвПокуп ОКПО="74047744" КодОПФ="12200" ПолнНаимОПФ="СвПокуп-ПолнНаимОПФ" СтруктПодр="СвПокуп-СтруктПодр" ИнфДляУчаст="СвПокуп-ИнфДляУчаст" СокрНаим="СвПокуп-СокрНаим">
        <ИдСв>
          <СвЮЛУч НаимОрг="СвЮЛУч-НаимОрг" ИННЮЛ="1234567894" КПП="667301001" />
        </ИдСв>
        <Адрес>
          <АдрИнф КодСтр="112" НаимСтран="Беларусь" АдрТекст="АдрИнф-АдрТекст" />
        </Адрес>
      </СвПокуп>
      <ДенИзм КодОКВ="643" НаимОКВ="Российский рубль" КурсВал="12" />
      <ДопСвФХЖ1 ИдГосКон="1234567890123456789012345" СпОбстФСЧФДОП="12345">
        <ВидОбяз КодВидОбяз="1" НаимВидОбяз="ВидОбяз-НаимВидОбяз" />
        <ИнфПродЗаГоскКазн ДатаГосКонт="02.02.2022" НомерГосКонт="5" КодКазначПрод="0160" />
        <СвФактор ОКПО="74047744" КодОПФ="12000" ПолнНаимОПФ="СвФактор-ПолнНаимОПФ" СтруктПодр="СвФактор-СтруктПодр" ИнфДляУчаст="СвФактор-ИнфДляУчаст" СокрНаим="СвФактор-СокрНаим">
          <ИдСв>
            <СвИП ИННФЛ="916363626153" ОГРНИП="421032906553286" ДатаОГРНИП="21.08.2019" ИныеСвед="СвИП-ИныеСвед">
              <ФИО Фамилия="ФИО-Фамилия" Имя="ФИО-Имя" Отчество="ФИО-Отчество" />
            </СвИП>
          </ИдСв>
          <Адрес>
            <АдрРФ КодРегион="72" НаимРегион="Тюменская область" Индекс="344249" Район="Тюмень" Город="Тюмень" НаселПункт="АдрРФ-НаселПункт" Улица="АдрРФ-Улица" Дом="АдрРФ-Дом" Корпус="АдрРФ-Корпус" Кварт="АдрРФ-Кварт" ИныеСвед="АдрРФ-ИныеСвед" />
          </Адрес>
        </СвФактор>
        <ОснУстДенТреб РеквНаимДок="ОснУстДенТреб-РеквНаимДок" РеквНомерДок="144" РеквДатаДок="04.04.2004">
          <РеквИдРекСост>
            <ИННФЛ>342265432525</ИННФЛ>
          </РеквИдРекСост>
        </ОснУстДенТреб>
        <СопрДокФХЖ РеквНаимДок="СопрДокФХЖ-РеквНаимДок" РеквНомерДок="876" РеквДатаДок="05.05.2005">
          <РеквИдРекСост>
            <ДаннИно КодСтр="112" НаимСтран="Беларусь" Наим="ДаннИно-Наим" ИдСтат="ИГ" ИныеСвед="ДаннИно-ИныеСвед" Идентиф="ДаннИно-Идентиф" />
          </РеквИдРекСост>
        </СопрДокФХЖ>
      </ДопСвФХЖ1>
      <ИнфПолФХЖ1 ИдФайлИнфПол="5b0a8e80-1a7b-4194-a64d-60ca9f10dd82">
        <ТекстИнф Идентиф="ТекстИнф-Идентиф" Значен="ТекстИнф-Идентиф" />
      </ИнфПолФХЖ1>
    </СвСчФакт>
    <ТаблСчФакт>
      <СведТов НомСтр="1" НалСт="20%" НаимТов="СведТов-НаимТов" ОКЕИ_Тов="113" НаимЕдИзм="м3" КолТов="16" ЦенаТов="200.00" СтТовБезНДС="654.00" СтТовУчНал="784.80">
        <СвДТ КодПроисх="980" НомерДТ="123456" />
        <ДопСведТов ПрТовРаб="5" ДопПризн="Приз" НадлОтп="102" СортТов="СортТов" СерияТов="ДопСведТов-СерияТов" ГТИН="10000057074365" КодВидТов="1111111111" КодВидПр="676">
          <КрНаимСтрПр>Евросоюз</КрНаимСтрПр>
          <СопрДокТов РеквНаимДок="СопрДокТов-РеквНаимДок" РеквНомерДок="144" РеквДатаДок="04.04.2004">
            <РеквИдРекСост>
              <ИННФЛ>342265432525</ИННФЛ>
            </РеквИдРекСост>
          </СопрДокТов>
          <НалУчАморт АмГруппа="13" КодОКОФ="165" СрПолИспОС="23" ФактСрокИсп="100" />
          <СумНалВосст>
            <СумНал>550.00</СумНал>
          </СумНалВосст>
          <СведПрослеж НомТовПрослеж="10001000/010123/1234567/001" ЕдИзмПрослеж="778" КолВЕдПрослеж="30" СтТовБезНДСПрослеж="100" НаимЕдИзмПрослеж="упак" />
          <НомСредИдентТов ИдентТрансУпак="НомСредИдентТов-ИдентТрансУпак" КолВедМарк="100" ПрПартМарк="111">
            <КИЗ>НомСредИдентТов-КИЗ</КИЗ>
          </НомСредИдентТов>
        </ДопСведТов>
        <Акциз>
          <БезАкциз>без акциза</БезАкциз>
        </Акциз>
        <СумНал>
          <СумНал>1000.00</СумНал>
        </СумНал>
      </СведТов>
      <СведТов НомСтр="2" НалСт="20%" НаимТов="Product2 &gt; 2.0 мм" ОКЕИ_Тов="778" НаимЕдИзм="упак" КолТов="114.100" ЦенаТов="516.67" СтТовБезНДС="58951.67" СтТовУчНал="70742.00">
        <СвДТ КодПроисх="178" НомерДТ="555555" />
        <ДопСведТов ПрТовРаб="5" ДопПризн="ДопП" НадлОтп="505" ХарактерТов="ДопСведТов-ХарактерТов" СортТов="СортТов" СерияТов="ДопСведТов-СерияТов" АртикулТов="ДопСведТов-АртикулТов" КодТов="ДопСведТов-КодТов" ГТИН="10000057074365" КодВидТов="1111111111">
          <КрНаимСтрПр>Конго</КрНаимСтрПр>
          <НалУчАморт АмГруппа="12" КодОКОФ="165" СрПолИспОС="234" ФактСрокИсп="100" />
          <СумНалВосст>
            <СумНал>1345.00</СумНал>
          </СумНалВосст>
        </ДопСведТов>
        <Акциз>
          <БезАкциз>без акциза</БезАкциз>
        </Акциз>
        <СумНал>
          <СумНал>1000.00</СумНал>
        </СумНал>
      </СведТов>
      <ВсегоОпл СтТовБезНДСВсего="8965.00" СтТовУчНалВсего="10000.00">
        <СумНалВсего>
          <СумНал>456.00</СумНал>
        </СумНалВсего>
      </ВсегоОпл>
    </ТаблСчФакт>
    <СвПродПер>
      <СвПер СодОпер="СвПер-СодОпер" ВидОпер="СвПер-ВидОпер" ДатаПер="15.02.2024" ДатаНачПер="16.02.2024" ДатаОконПер="16.02.2024">
        <ОснПер РеквНаимДок="ОснПер-РеквНаимДок" РеквНомерДок="567" РеквДатаДок="14.02.2024">
          <РеквИдРекСост>
            <ИННФЛ>144647873819</ИННФЛ>
          </РеквИдРекСост>
        </ОснПер>
        <СвЛицПер>
          <ИнЛицо>
            <ПредОргПер Должность="ПредОргПер-Должность" НаимОргПер="ПредОргПер-НаимОргПер" ИныеСвед="ПредОргПер-ИныеСвед">
              <ОснДоверОргПер РеквНаимДок="ОснДоверОргПер-РеквНаимДок" РеквНомерДок="098" РеквДатаДок="03.02.2024">
                <РеквИдРекСост>
                  <ИННЮЛ>4620212891</ИННЮЛ>
                </РеквИдРекСост>
              </ОснДоверОргПер>
              <ОснПолнПредПер РеквНаимДок="ОснПолнПредПер-РеквНаимДок" РеквНомерДок="098" РеквДатаДок="03.02.2024">
                <РеквИдРекСост>
                  <ИННЮЛ>4620212891</ИННЮЛ>
                </РеквИдРекСост>
              </ОснПолнПредПер>
              <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
            </ПредОргПер>
          </ИнЛицо>
        </СвЛицПер>
        <СвПерВещи>
          <ДокПерВещ РеквНаимДок="ДокПерВещ-РеквНаимДок" РеквНомерДок="098" РеквДатаДок="03.02.2024">
            <РеквИдРекСост>
              <ИННЮЛ>4620212891</ИННЮЛ>
            </РеквИдРекСост>
          </ДокПерВещ>
        </СвПерВещи>
      </СвПер>
      <ИнфПолФХЖ3 ИдФайлИнфПол="9c3adc2b-a085-4acd-af8c-3494290d782c">
        <ТекстИнф Идентиф="Идентиф1в" Значен="Значен1в" />
        <ТекстИнф Идентиф="Идентиф2в" Значен="Значен2в" />
      </ИнфПолФХЖ3>
    </СвПродПер>
    <Подписант СпосПодтПолном="6" Должн="Должность">
      <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
    </Подписант>
    <ОснДоверОргСост РеквНаимДок="ОснДоверОргСост-РеквНаимДок" РеквНомерДок="123" РеквДатаДок="01.02.2023">
      <РеквИдРекСост>
        <ДаннИно КодСтр="112" НаимСтран="Беларусь" Наим="ДаннИно-Наим" ИдСтат="ИГ" ИныеСвед="ДаннИно-ИныеСвед" Идентиф="ДаннИно-Идентиф" />
      </РеквИдРекСост>
    </ОснДоверОргСост>
  </Документ>
</Файл>

Отправка титула продавца

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

Обратите внимание, что в титуле должны быть заполнены данные подписанта. Указать их можно либо сразу при генерации титула продавца, либо с помощью процедуры подготовки к подписанию.

Примечание

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

В структуре DocumentAttachment укажите значения, которые были получены для генерации методом GetDocumentTypes (V2):

• TypeNamedId = UniversalTransferDocument

• Function = СЧФДОП

• Version = utd970_05_03_01

Для некоторых видов документооборота извещение о получении титула покупателем является обязательным (например, УПД с функциями СЧФ, СЧФДОП, СвРК и СвЗК), а для некоторых — требует запроса от продавца (например, УПД с функцией ДОП). Если документооборотом не предусмотрено обязательное извещение о получении титула покупателем, но продавец хочет его запросить, то в структуре DocumentAttachment нужно выставить значение NeedRecipientSignature = true.

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

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

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

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

• Если продавец запросил извещение о получении документа покупателем, то покупатель должен сформировать извещение о получении документа и отправить его продавцу. Получить его можно по инструкции Получение извещения о получении.

Получение титула продавца в ящике покупателя

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

Чтобы найти УПД в ящике покупателя через поиск, передайте в метод GetDocuments (V3) значения параметров:

• boxId — идентификатор ящика покупателя,

• filterCategory = UniversalTransferDocument.InboundNotFinished.

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

GET /V3/GetDocuments?filterCategory=UniversalTransferDocument.InboundNotFinished&boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json
Content-Type: application/json charset=utf-8

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

Генерация и отправка извещения о получении УПД

Для УПД с функциями СЧФ, СЧФДОП, СвРК и СвЗК, а также для документов, по которым было запрошено извещение о получении (ИоП), покупатель должен отправить продавцу ИоП на титул продавца.

Сгенерировать ИоП можно с помощью метода GenerateReceiptXml (V2), а отправить с помощью метода PostMessagePatch (V3) или PostMessagePatch (V4). Инструкция о генерации и отправке ИоП приведена в разделе Генерация и отправка извещения о получении.

После того как покупатель отправит ИоП, для УПД с функциями СЧФ, СЧФДОП, СвРК и СвЗК Диадок автоматически сформирует подтверждение оператора о дате получения ИоП и отправит его продавцу и покупателю. О том, как получить подтверждение оператора, написано в разделе Получение подтверждения оператора.

После этого документооборот УПД с функциями СЧФ, СвРК и СвЗК считается завершенным, никакие действия по документу больше не требуются.

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

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

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

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

УПД 5.03УПД 5.02УПД 5.01

POST /ParseTitleXml?boxId={{boxId}}&documentTypeNamedId=UniversalTransferDocument&documentFunction=СЧФДОП&documentVersion=utd970_05_03_01&titleIndex=0 HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/xml; charset=utf-8

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

УПД 5.03УПД 5.02УПД 5.01

<Файл ИдФайл="ON_NSCHFDOPPR_2BM-9677800047-967701000-202207281004154081709_2BM-9681265956-968101000-202207281000014689156_20250116_8c703486-75df-46f8-8f0a-959b09f807a9_1_1_0_0_1_00" ВерсФорм="5.03" ВерсПрог="Diadoc 1.0">
  <Документ КНД="1115131" ВремИнфПр="18.13.16" ДатаИнфПр="16.01.2025" Функция="СЧФДОП" ПоФактХЖ="Документ об отгрузке товаров (выполнении работ), передаче имущественных прав (документ об оказании услуг)" НаимДокОпр="Документ о передаче товаров (работ, услуг, имущественных прав)" УИД="UID" НаимЭконСубСост="Документ-НаимЭконСубСост" СоглСтрДопИнф="1111.2222.0000">
    <СвСчФакт НомерДок="123" ДатаДок="01.02.2023" ИмяФайлИспрПрод="СвСчФакт-ИмяФайлИспрПрод" ИмяФайлИспрПок="СвСчФакт-ИмяФайлИспрПок">
      <СвПрод ОКПО="0166273597" КодОПФ="12200" ПолнНаимОПФ="СвПрод-ПолнНаимОПФ" СтруктПодр="СвПрод-СтруктПодр" ИнфДляУчаст="СвПрод-ИнфДляУчаст" СокрНаим="СвПрод-СокрНаим">
        <ИдСв>
          <СвЮЛУч НаимОрг="СвЮЛУч-НаимОрг" ИННЮЛ="9103624367" КПП="187245452" />
        </ИдСв>
        <Адрес>
          <АдрРФ КодРегион="72" НаимРегион="Тюменская область" Индекс="344249" Район="Тюмень" Город="Тюмень" НаселПункт="АдрРФ-НаселПункт" Улица="АдрРФ-Улица" Дом="АдрРФ-Дом" Корпус="АдрРФ-Корпус" Кварт="АдрРФ-Кварт" ИныеСвед="АдрРФ-ИныеСвед" />
        </Адрес>
        <БанкРекв НомерСчета="49634485849155">
          <СвБанк НаимБанк="СИБИРСКИЙ БАНК ПАО СБЕРБАНК" БИК="045004641" КорСчет="30101810500000000641" />
        </БанкРекв>
        <Контакт ИнКонт="Контакт-ИнКонт">
          <Тлф>8-343-123-4567</Тлф>
          <ЭлПочта>email@google.com</ЭлПочта>
        </Контакт>
      </СвПрод>
      <ГрузОт>
        <ГрузОтпр ОКПО="76098674" КодОПФ="12000" ПолнНаимОПФ="ГрузОтпр-ПолнНаимОПФ" СтруктПодр="ГрузОтпр-СтруктПодр" ИнфДляУчаст="ГрузОтпр-ИнфДляУчаст" СокрНаим="ГрузОтпр-СокрНаим">
          <ИдСв>
            <СвИП ИННФЛ="753381367749" СвГосРегИП="СвИП-СвГосРегИП" ОГРНИП="421319982803452" ДатаОГРНИП="12.12.2012" ИныеСвед="СвИП-ИныеСвед">
              <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
            </СвИП>
          </ИдСв>
          <Адрес>
            <АдрГАР ИдНом="03510210-e5f3-4bc6-bbd2-24d7fe25b3ed" Индекс="450133">
              <Регион>72</Регион>
              <НаимРегион>Тюменская область</НаимРегион>
              <МуниципРайон ВидКод="1" Наим="МуниципРайон-Наим" />
              <ГородСелПоселен ВидКод="1" Наим="ГородСелПоселен-Наим" />
              <НаселенПункт Вид="НаселенПункт" Наим="НаселенПункт-Наим" />
              <ЭлПланСтруктур Тип="ЭлПланСтруктур" Наим="ЭлПланСтруктур-Наим" />
              <ЭлУлДорСети Тип="ЭлУлДорСети" Наим="ЭлУлДорСети-Наим" />
              <ЗемелУчасток>ЗемелУчасток</ЗемелУчасток>
              <Здание Тип="Здание" Номер="Здание-Номер" />
              <ПомещЗдания Тип="ПомещЗдания" Номер="ПомещЗдания-Номер" />
              <ПомещКвартиры Тип="ПомещКвартиры" Номер="ПомещКвартиры-Номер" />
            </АдрГАР>
          </Адрес>
        </ГрузОтпр>
      </ГрузОт>
      <ГрузПолуч ОКПО="18989253" КодОПФ="12000" ПолнНаимОПФ="ГрузПолуч-ПолнНаимОПФ" СтруктПодр="ГрузПолуч-СтруктПодр" ИнфДляУчаст="ГрузПолуч-ИнфДляУчаст" СокрНаим="ГрузПолуч-СокрНаим">
        <ИдСв>
          <СвФЛУч ИННФЛ="518191632595" ИдСтатЛ="1" ИныеСвед="СвФЛУч-ИныеСвед">
            <ФИО Фамилия="Петров" Имя="Петр" Отчество="Петрович" />
          </СвФЛУч>
        </ИдСв>
        <Адрес>
          <АдрИнф КодСтр="112" НаимСтран="Беларусь" АдрТекст="АдрИнф-АдрТекст" />
        </Адрес>
        <БанкРекв НомерСчета="569712456874">
          <СвБанк НаимБанк="ЗАО Сбербанк России, отделение на Московской 11" БИК="012345671" />
        </БанкРекв>
      </ГрузПолуч>
      <СвПРД НомерПРД="СЧФ/123/456" ДатаПРД="01.02.2023" СуммаПРД="1000.00" />
      <ДокПодтвОтгрНом РеквНаимДок="Документ о передаче товаров (работ, услуг, имущественных прав)" РеквНомерДок="123" РеквДатаДок="01.02.2023">
        <РеквИдРекСост>
          <ИННЮЛ>1978337389</ИННЮЛ>
        </РеквИдРекСост>
      </ДокПодтвОтгрНом>
      <СвПокуп ОКПО="74047744" КодОПФ="12200" ПолнНаимОПФ="СвПокуп-ПолнНаимОПФ" СтруктПодр="СвПокуп-СтруктПодр" ИнфДляУчаст="СвПокуп-ИнфДляУчаст" СокрНаим="СвПокуп-СокрНаим">
        <ИдСв>
          <СвЮЛУч НаимОрг="СвЮЛУч-НаимОрг" ИННЮЛ="1234567894" КПП="667301001" />
        </ИдСв>
        <Адрес>
          <АдрИнф КодСтр="112" НаимСтран="Беларусь" АдрТекст="АдрИнф-АдрТекст" />
        </Адрес>
      </СвПокуп>
      <ДенИзм КодОКВ="643" НаимОКВ="Российский рубль" КурсВал="12" />
      <ДопСвФХЖ1 ИдГосКон="1234567890123456789012345" СпОбстФСЧФДОП="12345">
        <ВидОбяз КодВидОбяз="1" НаимВидОбяз="ВидОбяз-НаимВидОбяз" />
        <ИнфПродЗаГоскКазн ДатаГосКонт="02.02.2022" НомерГосКонт="5" КодКазначПрод="0160" />
        <СвФактор ОКПО="74047744" КодОПФ="12000" ПолнНаимОПФ="СвФактор-ПолнНаимОПФ" СтруктПодр="СвФактор-СтруктПодр" ИнфДляУчаст="СвФактор-ИнфДляУчаст" СокрНаим="СвФактор-СокрНаим">
          <ИдСв>
            <СвИП ИННФЛ="916363626153" ОГРНИП="421032906553286" ДатаОГРНИП="21.08.2019" ИныеСвед="СвИП-ИныеСвед">
              <ФИО Фамилия="ФИО-Фамилия" Имя="ФИО-Имя" Отчество="ФИО-Отчество" />
            </СвИП>
          </ИдСв>
          <Адрес>
            <АдрРФ КодРегион="72" НаимРегион="Тюменская область" Индекс="344249" Район="Тюмень" Город="Тюмень" НаселПункт="АдрРФ-НаселПункт" Улица="АдрРФ-Улица" Дом="АдрРФ-Дом" Корпус="АдрРФ-Корпус" Кварт="АдрРФ-Кварт" ИныеСвед="АдрРФ-ИныеСвед" />
          </Адрес>
        </СвФактор>
        <ОснУстДенТреб РеквНаимДок="ОснУстДенТреб-РеквНаимДок" РеквНомерДок="144" РеквДатаДок="04.04.2004">
          <РеквИдРекСост>
            <ИННФЛ>342265432525</ИННФЛ>
          </РеквИдРекСост>
        </ОснУстДенТреб>
        <СопрДокФХЖ РеквНаимДок="СопрДокФХЖ-РеквНаимДок" РеквНомерДок="876" РеквДатаДок="05.05.2005">
          <РеквИдРекСост>
            <ДаннИно КодСтр="112" НаимСтран="Беларусь" Наим="ДаннИно-Наим" ИдСтат="ИГ" ИныеСвед="ДаннИно-ИныеСвед" Идентиф="ДаннИно-Идентиф" />
          </РеквИдРекСост>
        </СопрДокФХЖ>
      </ДопСвФХЖ1>
      <ИнфПолФХЖ1 ИдФайлИнфПол="5b0a8e80-1a7b-4194-a64d-60ca9f10dd82">
        <ТекстИнф Идентиф="ТекстИнф-Идентиф" Значен="ТекстИнф-Идентиф" />
      </ИнфПолФХЖ1>
    </СвСчФакт>
    <ТаблСчФакт>
      <СведТов НомСтр="1" НалСт="20%" НаимТов="СведТов-НаимТов" ОКЕИ_Тов="113" НаимЕдИзм="м3" КолТов="16" ЦенаТов="200.00" СтТовБезНДС="654.00" СтТовУчНал="784.80">
        <СвДТ КодПроисх="980" НомерДТ="123456" />
        <ДопСведТов ПрТовРаб="5" ДопПризн="Приз" НадлОтп="102" СортТов="СортТов" СерияТов="ДопСведТов-СерияТов" ГТИН="10000057074365" КодВидТов="1111111111" КодВидПр="676">
          <КрНаимСтрПр>Евросоюз</КрНаимСтрПр>
          <СопрДокТов РеквНаимДок="СопрДокТов-РеквНаимДок" РеквНомерДок="144" РеквДатаДок="04.04.2004">
            <РеквИдРекСост>
              <ИННФЛ>342265432525</ИННФЛ>
            </РеквИдРекСост>
          </СопрДокТов>
          <НалУчАморт АмГруппа="13" КодОКОФ="165" СрПолИспОС="23" ФактСрокИсп="100" />
          <СумНалВосст>
            <СумНал>550.00</СумНал>
          </СумНалВосст>
          <СведПрослеж НомТовПрослеж="10001000/010123/1234567/001" ЕдИзмПрослеж="778" КолВЕдПрослеж="30" СтТовБезНДСПрослеж="100" НаимЕдИзмПрослеж="упак" />
          <НомСредИдентТов ИдентТрансУпак="НомСредИдентТов-ИдентТрансУпак" КолВедМарк="100" ПрПартМарк="111">
            <КИЗ>НомСредИдентТов-КИЗ</КИЗ>
          </НомСредИдентТов>
        </ДопСведТов>
        <Акциз>
          <БезАкциз>без акциза</БезАкциз>
        </Акциз>
        <СумНал>
          <СумНал>1000.00</СумНал>
        </СумНал>
      </СведТов>
      <СведТов НомСтр="2" НалСт="20%" НаимТов="Product2 &gt; 2.0 мм" ОКЕИ_Тов="778" НаимЕдИзм="упак" КолТов="114.100" ЦенаТов="516.67" СтТовБезНДС="58951.67" СтТовУчНал="70742.00">
        <СвДТ КодПроисх="178" НомерДТ="555555" />
        <ДопСведТов ПрТовРаб="5" ДопПризн="ДопП" НадлОтп="505" ХарактерТов="ДопСведТов-ХарактерТов" СортТов="СортТов" СерияТов="ДопСведТов-СерияТов" АртикулТов="ДопСведТов-АртикулТов" КодТов="ДопСведТов-КодТов" ГТИН="10000057074365" КодВидТов="1111111111">
          <КрНаимСтрПр>Конго</КрНаимСтрПр>
          <НалУчАморт АмГруппа="12" КодОКОФ="165" СрПолИспОС="234" ФактСрокИсп="100" />
          <СумНалВосст>
            <СумНал>1345.00</СумНал>
          </СумНалВосст>
        </ДопСведТов>
        <Акциз>
          <БезАкциз>без акциза</БезАкциз>
        </Акциз>
        <СумНал>
          <СумНал>1000.00</СумНал>
        </СумНал>
      </СведТов>
      <ВсегоОпл СтТовБезНДСВсего="8965.00" СтТовУчНалВсего="10000.00">
        <СумНалВсего>
          <СумНал>456.00</СумНал>
        </СумНалВсего>
      </ВсегоОпл>
    </ТаблСчФакт>
    <СвПродПер>
      <СвПер СодОпер="СвПер-СодОпер" ВидОпер="СвПер-ВидОпер" ДатаПер="15.02.2024" ДатаНачПер="16.02.2024" ДатаОконПер="16.02.2024">
        <ОснПер РеквНаимДок="ОснПер-РеквНаимДок" РеквНомерДок="567" РеквДатаДок="14.02.2024">
          <РеквИдРекСост>
            <ИННФЛ>144647873819</ИННФЛ>
          </РеквИдРекСост>
        </ОснПер>
        <СвЛицПер>
          <ИнЛицо>
            <ПредОргПер Должность="ПредОргПер-Должность" НаимОргПер="ПредОргПер-НаимОргПер" ИныеСвед="ПредОргПер-ИныеСвед">
              <ОснДоверОргПер РеквНаимДок="ОснДоверОргПер-РеквНаимДок" РеквНомерДок="098" РеквДатаДок="03.02.2024">
                <РеквИдРекСост>
                  <ИННЮЛ>4620212891</ИННЮЛ>
                </РеквИдРекСост>
              </ОснДоверОргПер>
              <ОснПолнПредПер РеквНаимДок="ОснПолнПредПер-РеквНаимДок" РеквНомерДок="098" РеквДатаДок="03.02.2024">
                <РеквИдРекСост>
                  <ИННЮЛ>4620212891</ИННЮЛ>
                </РеквИдРекСост>
              </ОснПолнПредПер>
              <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
            </ПредОргПер>
          </ИнЛицо>
        </СвЛицПер>
        <СвПерВещи>
          <ДокПерВещ РеквНаимДок="ДокПерВещ-РеквНаимДок" РеквНомерДок="098" РеквДатаДок="03.02.2024">
            <РеквИдРекСост>
              <ИННЮЛ>4620212891</ИННЮЛ>
            </РеквИдРекСост>
          </ДокПерВещ>
        </СвПерВещи>
      </СвПер>
      <ИнфПолФХЖ3 ИдФайлИнфПол="9c3adc2b-a085-4acd-af8c-3494290d782c">
        <ТекстИнф Идентиф="Идентиф1в" Значен="Значен1в" />
        <ТекстИнф Идентиф="Идентиф2в" Значен="Значен2в" />
      </ИнфПолФХЖ3>
    </СвПродПер>
    <Подписант СпосПодтПолном="6" Должн="Должность">
      <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
    </Подписант>
    <ОснДоверОргСост РеквНаимДок="ОснДоверОргСост-РеквНаимДок" РеквНомерДок="123" РеквДатаДок="01.02.2023">
      <РеквИдРекСост>
        <ДаннИно КодСтр="112" НаимСтран="Беларусь" Наим="ДаннИно-Наим" ИдСтат="ИГ" ИныеСвед="ДаннИно-ИныеСвед" Идентиф="ДаннИно-Идентиф" />
      </РеквИдРекСост>
    </ОснДоверОргСост>
  </Документ>
</Файл>

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

УПД 5.03УПД 5.02УПД 5.01

<?xml version="1.0" encoding="utf-8"?>
<UniversalTransferDocument DocumentDate="01.02.2023" DocumentNumber="123" Currency="643" Function="СЧФДОП" Uid="UID" ApprovedStructureAdditionalInfoFields="1111.2222.0000" DocumentName="Документ о передаче товаров (работ, услуг, имущественных прав)" SenderFnsParticipantId="2BM-9681265956-968101000-202207281000014689156" RecipientFnsParticipantId="2BM-9677800047-967701000-202207281004154081709" FileIdSeller="СвСчФакт-ИмяФайлИспрПрод" FileIdBuyer="СвСчФакт-ИмяФайлИспрПок" CurrencyRate="12" GovernmentContractInfo="1234567890123456789012345" DocumentCreator="Документ-НаимЭконСубСост" CircumFormat="12345" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <Sellers>
    <Seller>
      <OrganizationDetails FnsParticipantId="2BM-9681265956-968101000-202207281000014689156" Okpo="0166273597" Okopf="12200" FullNameOkopf="СвПрод-ПолнНаимОПФ" Department="СвПрод-СтруктПодр" OrganizationAdditionalInfo="СвПрод-ИнфДляУчаст" ShortOrgName="СвПрод-СокрНаим" OtherContactInfo="Контакт-ИнКонт" CorrespondentAccount="30101810500000000641" BankAccountNumber="49634485849155" BankName="СИБИРСКИЙ БАНК ПАО СБЕРБАНК" BankId="045004641" OrgType="2" OrgName="СвЮЛУч-НаимОрг" Inn="9103624367" Kpp="187245452">
        <Phones>
          <Phone>8-343-123-4567</Phone>
        </Phones>
        <Emails>
          <Email>email@sample.com</Email>
        </Emails>
        <Address>
          <RussianAddress Region="72" ZipCode="344249" Territory="Тюмень" City="Тюмень" Locality="АдрРФ-НаселПункт" Street="АдрРФ-Улица" Building="АдрРФ-Дом" Block="АдрРФ-Корпус" Apartment="АдрРФ-Кварт" OtherInfo="АдрРФ-ИныеСвед" />
        </Address>
      </OrganizationDetails>
    </Seller>
  </Sellers>
  <Shippers>
    <Shipper>
      <OrganizationDetails Okpo="76098674" Okopf="12000" FullNameOkopf="ГрузОтпр-ПолнНаимОПФ" Department="ГрузОтпр-СтруктПодр" OrganizationAdditionalInfo="ГрузОтпр-ИнфДляУчаст" ShortOrgName="ГрузОтпр-СокрНаим" OrgType="1" OrgName="Иванов Иван Иванович" Inn="753381367749" Ogrn="421319982803452" OgrnDate="12.12.2012" IndividualEntityRegistrationCertificate="СвИП-СвГосРегИП" OrganizationOrPersonInfo="СвИП-ИныеСвед">
        <Address>
          <GarAddress AddressCode="03510210-e5f3-4bc6-bbd2-24d7fe25b3ed" Region="72" ZipCode="450133" LandPlot="ЗемелУчасток">
            <MunicipalTerritory Type="1" NameOrNumber="МуниципРайон-Наим" />
            <UrbanSettlement Type="1" NameOrNumber="ГородСелПоселен-Наим" />
            <Locality Type="НаселенПункт" NameOrNumber="НаселенПункт-Наим" />
            <ElementPlanningStructure Type="ЭлПланСтруктур" NameOrNumber="ЭлПланСтруктур-Наим" />
            <ElementRoadNetwork Type="ЭлУлДорСети" NameOrNumber="ЭлУлДорСети-Наим" />
            <Buildings>
              <Building Type="Здание" NameOrNumber="Здание-Номер" />
            </Buildings>
            <RoomBuilding Type="ПомещЗдания" NameOrNumber="ПомещЗдания-Номер" />
            <RoomApartment Type="ПомещКвартиры" NameOrNumber="ПомещКвартиры-Номер" />
          </GarAddress>
        </Address>
      </OrganizationDetails>
    </Shipper>
  </Shippers>
  <Consignees>
    <Consignee>
      <OrganizationDetails Okpo="18989253" Okopf="12000" FullNameOkopf="ГрузПолуч-ПолнНаимОПФ" Department="ГрузПолуч-СтруктПодр" OrganizationAdditionalInfo="ГрузПолуч-ИнфДляУчаст" ShortOrgName="ГрузПолуч-СокрНаим" BankAccountNumber="569712456874" BankName="ЗАО Сбербанк России, отделение на Московской 11" BankId="012345671" OrgType="3" OrgName="Петров Петр Петрович" Inn="518191632595" PersonStatusId="1" OrganizationOrPersonInfo="СвФЛУч-ИныеСвед">
        <Address>
          <ForeignAddress Country="112" Address="АдрИнф-АдрТекст" />
        </Address>
      </OrganizationDetails>
    </Consignee>
  </Consignees>
  <PaymentDocuments>
    <Document Number="СЧФ/123/456" Date="01.02.2023" Total="1000.00" />
  </PaymentDocuments>
  <DocumentShipments>
    <DocumentShipment DocumentName="Документ о передаче товаров (работ, услуг, имущественных прав)" DocumentNumber="123" DocumentDate="01.02.2023">
      <IdentificationDetails Inn="1978337389" />
    </DocumentShipment>
  </DocumentShipments>
  <Buyers>
    <Buyer>
      <OrganizationDetails FnsParticipantId="2BM-9677800047-967701000-202207281004154081709" Okpo="74047744" Okopf="12200" FullNameOkopf="СвПокуп-ПолнНаимОПФ" Department="СвПокуп-СтруктПодр" OrganizationAdditionalInfo="СвПокуп-ИнфДляУчаст" ShortOrgName="СвПокуп-СокрНаим" OrgType="2" OrgName="СвЮЛУч-НаимОрг" Inn="1234567894" Kpp="667301001">
        <Address>
          <ForeignAddress Country="112" Address="АдрИнф-АдрТекст" />
        </Address>
      </OrganizationDetails>
    </Buyer>
  </Buyers>
  <CommitmentTypes>
    <CommitmentType CommitmentTypeCode="1" CommitmentTypeName="ВидОбяз-НаимВидОбяз" />
  </CommitmentTypes>
  <SellerInfoCircumPublicProc DateStateContract="02.02.2022" NumberStateContract="5" SellerTreasuryCode="0160" />
  <FactorInfo>
    <OrganizationDetails Okpo="74047744" Okopf="12000" FullNameOkopf="СвФактор-ПолнНаимОПФ" Department="СвФактор-СтруктПодр" OrganizationAdditionalInfo="СвФактор-ИнфДляУчаст" ShortOrgName="СвФактор-СокрНаим" OrgType="1" OrgName="ФИО-Фамилия ФИО-Имя ФИО-Отчество" Inn="916363626153" Ogrn="421032906553286" OgrnDate="21.08.2019" OrganizationOrPersonInfo="СвИП-ИныеСвед">
      <Address>
        <RussianAddress Region="72" ZipCode="344249" Territory="Тюмень" City="Тюмень" Locality="АдрРФ-НаселПункт" Street="АдрРФ-Улица" Building="АдрРФ-Дом" Block="АдрРФ-Корпус" Apartment="АдрРФ-Кварт" OtherInfo="АдрРФ-ИныеСвед" />
      </Address>
    </OrganizationDetails>
  </FactorInfo>
  <MainAssignMonetaryClaim DocumentName="ОснУстДенТреб-РеквНаимДок" DocumentNumber="144" DocumentDate="04.04.2004">
    <IdentificationDetails Inn="342265432525" />
  </MainAssignMonetaryClaim>
  <AccompanyingDocuments>
    <AccompanyingDocument DocumentName="СопрДокФХЖ-РеквНаимДок" DocumentNumber="876" DocumentDate="05.05.2005">
      <IdentificationDetails StatusId="PhysicalPerson" Country="112" OrgName="ДаннИно-Наим" LegalEntityId="ДаннИно-Идентиф" OrganizationOrPersonInfo="ДаннИно-ИныеСвед" />
    </AccompanyingDocument>
  </AccompanyingDocuments>
  <AdditionalInfoId InfoFileId="5b0a8e80-1a7b-4194-a64d-60ca9f10dd82">
    <AdditionalInfo Id="ТекстИнф-Идентиф" Value="ТекстИнф-Идентиф" />
  </AdditionalInfoId>
  <Table TotalWithVatExcluded="8965.00" Vat="456.00" Total="10000.00">
    <Item TaxRate="TwentyPercent" Product="СведТов-НаимТов" Unit="113" UnitName="м3" Quantity="16" Price="200.00" SubtotalWithVatExcluded="654.00" Vat="1000.00" RestoredVat="550.00" Subtotal="784.80" ItemMark="5" AdditionalProperty="Приз" ItemToRelease="102" ItemKind="СортТов" ItemSeries="ДопСведТов-СерияТов" Gtin="10000057074365" ItemTypeCode="1111111111" ProductTypeCode="676">
      <CustomsDeclarations>
        <CustomsDeclaration Country="980" DeclarationNumber="123456" />
      </CustomsDeclarations>
      <AccompanyingDocuments>
        <AccompanyingDocument DocumentName="СопрДокТов-РеквНаимДок" DocumentNumber="144" DocumentDate="04.04.2004">
          <IdentificationDetails Inn="342265432525" />
        </AccompanyingDocument>
      </AccompanyingDocuments>
      <DepreciationInfo DepreciationGroup="13" Okof="165" UsefulPeriod="23" ActualPeriod="100" />
      <ItemTracingInfos>
        <ItemTracingInfo RegNumberUnit="10001000/010123/1234567/001" Unit="778" Quantity="30" PriceWithVatExcluded="100" />
      </ItemTracingInfos>
      <ItemIdentificationNumbers>
        <ItemIdentificationNumber TransPackageId="НомСредИдентТов-ИдентТрансУпак" QuantityMark="100" BatchMarkCode="111">
          <Unit>НомСредИдентТов-КИЗ</Unit>
        </ItemIdentificationNumber>
      </ItemIdentificationNumbers>
    </Item>
    <Item TaxRate="TwentyPercent" Product="Product2 &gt; 2.0 мм" Unit="778" UnitName="упак" Quantity="114.100" Price="516.67" SubtotalWithVatExcluded="58951.67" Vat="1000.00" RestoredVat="1345.00" Subtotal="70742.00" ItemMark="5" AdditionalProperty="ДопП" ItemVendorCode="ДопСведТов-КодТов" ItemToRelease="505" ItemCharact="ДопСведТов-ХарактерТов" ItemArticle="ДопСведТов-АртикулТов" ItemKind="СортТов" ItemSeries="ДопСведТов-СерияТов" Gtin="10000057074365" ItemTypeCode="1111111111">
      <CustomsDeclarations>
        <CustomsDeclaration Country="178" DeclarationNumber="555555" />
      </CustomsDeclarations>
      <DepreciationInfo DepreciationGroup="12" Okof="165" UsefulPeriod="234" ActualPeriod="100" />
    </Item>
  </Table>
  <TransferInfo OperationInfo="СвПер-СодОпер" OperationType="СвПер-ВидОпер" TransferDate="15.02.2024" TransferStartDate="16.02.2024" TransferEndDate="16.02.2024">
    <CreatedThingTransferDocument DocumentName="ДокПерВещ-РеквНаимДок" DocumentNumber="098" DocumentDate="03.02.2024">
      <IdentificationDetails Inn="4620212891" />
    </CreatedThingTransferDocument>
    <TransferBases>
      <TransferBase DocumentName="ОснПер-РеквНаимДок" DocumentNumber="567" DocumentDate="14.02.2024">
        <IdentificationDetails Inn="144647873819" />
      </TransferBase>
    </TransferBases>
    <OtherIssuer LastName="Иванов" FirstName="Иван" MiddleName="Иванович" Position="ПредОргПер-Должность" EmployeeInfo="ПредОргПер-ИныеСвед" OrganizationName="ПредОргПер-НаимОргПер">
      <EmployeeBase DocumentName="ОснПолнПредПер-РеквНаимДок" DocumentNumber="098" DocumentDate="03.02.2024">
        <IdentificationDetails Inn="4620212891" />
      </EmployeeBase>
      <OrganizationBase DocumentName="ОснДоверОргПер-РеквНаимДок" DocumentNumber="098" DocumentDate="03.02.2024">
        <IdentificationDetails Inn="4620212891" />
      </OrganizationBase>
    </OtherIssuer>
    <AdditionalInfoId InfoFileId="9c3adc2b-a085-4acd-af8c-3494290d782c">
      <AdditionalInfo Id="Идентиф1в" Value="Значен1в" />
      <AdditionalInfo Id="Идентиф2в" Value="Значен2в" />
    </AdditionalInfoId>
  </TransferInfo>
  <Signers>
    <Signer SignerPowersConfirmationMethod="6">
      <Fio FirstName="Иван" LastName="Иванов" MiddleName="Иванович" />
      <Position PositionSource="Manual">Должность</Position>
    </Signer>
  </Signers>
  <DocumentCreatorBase DocumentName="ОснДоверОргСост-РеквНаимДок" DocumentNumber="123" DocumentDate="01.02.2023">
    <IdentificationDetails StatusId="PhysicalPerson" Country="112" OrgName="ДаннИно-Наим" LegalEntityId="ДаннИно-Идентиф" OrganizationOrPersonInfo="ДаннИно-ИныеСвед" />
  </DocumentCreatorBase>
</UniversalTransferDocument>

Генерация титула покупателя

Если выбранный вид документооборота предусматривает наличие титула покупателя, то покупатель должен сформировать и отправить ответный титул продавцу (например, для УПД с функциями ДОП, СЧФДОП, СвРК и СвЗК).

Титул покупателя генерируется аналогично титулу продавца.

Для генерации титула покупателя используйте метод GenerateTitleXml. Инструкция о генерации приведена в разделе Генерация последующих титулов.

Чтобы сгенерировать титул покупателя, нужно получить необходимую информацию из метода GetDocumentTypes (V2). Инструкция о получении данных для титула из метода GetDocumentTypes приведена в разделе Данные для генерации титула.

Обратите внимание, что сгенерировать ответный титул с версиями 5.01 или 5.02 можно только на титул продавца, сформированный и отправленный в той же версии.

Из ответа метода GetDocumentTypes для титула покупателя возьмем те же значения для параметров метода GenerateTitleXml, что и для титула продавца, но номер титула будет другой:

УПД 5.03УПД 5.02УПД 5.01

• documentTypeNamedId = UniversalTransferDocument

• documentFunction = СЧФДОП

• documentVersion = utd970_05_03_01

• titleIndex = 1 (титул покупателя)

Кроме этого нужно подготовить содержимое титула — упрощенный XML-файл UserDataXml. Схемы XSD и UserDataXSD можно скачать в разделе XSD-схемы.

С помощью полученных данных можно сгенерировать титул покупателя методом GenerateTitleXml.

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

УПД 5.03УПД 5.02УПД 5.01

POST /GenerateTitleXml?boxId={{boxId}}&documentTypeNamedId=UniversalTransferDocument&documentFunction=СЧФДОП&documentVersion=utd970_05_03_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):

УПД 5.03УПД 5.02УПД 5.01

<UniversalTransferDocumentBuyerTitle AcceptanceDate="06.07.2024" DocumentCreator="Тестовая организация">
    <ContentOperCode TotalCode="1" />
    <Employee Position="Покупатель" LastName="Иванов" FirstName="Иван" MiddleName="Иванович" />
    <Signers>
        <Signer SignerPowersConfirmationMethod="6">
            <Fio FirstName="Иван" LastName="Подписант" MiddleName="Иванович" />
            <Position PositionSource="Manual">Сотрудник</Position>
        </Signer>
    </Signers>
</UniversalTransferDocumentBuyerTitle>

Пример тела ответа метода GenerateTitleXml (титул покупателя):

УПД 5.03УПД 5.02УПД 5.01

<?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="ON_NSCHFDOPPOK_2BM-9681265956-968101000-202207281000014689156_2BM-9677800047-967701000-202207281004154081709_20240713_57cd8895-2d8c-42b2-961c-a158b5a86496_1_1_0_0_1_00" ВерсФорм="5.03" ВерсПрог="Diadoc 1.0">
  <Документ КНД="1115132" ДатаИнфПок="13.07.2024" ВремИнфПок="13.35.24" УИД="Уид" НаимЭконСубСост="Тестовая организация">
    <ИдИнфПрод ИдФайлИнфПр="ON_NSCHFDOPPR_2BM-9677800047-967701000-202207281004154081709_2BM-9681265956-968101000-202207281000014689156_20240710_2b9816b5-7858-4d0c-b264-60158cfb43b4_1_1_0_0_1_00" ДатаФайлИнфПр="10.07.2024" ВремФайлИнфПр="18.00.33">
      <ЭП>MIIN...JKyg==</ЭП>
    </ИдИнфПрод>
    <СодФХЖ4 ДатаДокИнфПр="01.02.2003" НаимДокОпрПр="Документ о передаче товаров (работ, услуг, имущественных прав)" Функция="СЧФДОП" ПорНомДокИнфПр="444">
      <СвПрин ДатаПрин="06.07.2024">
        <КодСодОпер КодИтога="1" />
        <СвЛицПрин>
          <РабОргПок Должность="Покупатель">
            <ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович" />
          </РабОргПок>
        </СвЛицПрин>
      </СвПрин>
    </СодФХЖ4>
    <Подписант СпосПодтПолном="6" Должн="Сотрудник">
      <ФИО Фамилия="Подписант" Имя="Иван" Отчество="Иванович" />
    </Подписант>
  </Документ>
</Файл>

Отправка титула покупателя

Сформированный титул покупателя можно подписать и отправить продавцу с помощью метода PostMessagePatch (V3) или PostMessagePatch (V4), передав его в поле RecipientTitles структуры MessagePatchToPost или MessagePatchToPostV2 соответственно. Инструкция об отправке дополнения приведена на странице Дополнение сообщения.

Если покупатель хочет запросить извещение о получении (ИоП) титула продавцом, то в структуре RecipientTitleAttachment нужно выставить значение NeedRecipient = true.

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

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

Если покупатель запросил ИоП, то после получения титула покупателя продавец должен сформировать и отправить покупателю ИоП. Для УПД с функцией СЧФДОП Диадок автоматически сформирует подтверждение оператора о дате получения ИоП и отправит его продавцу и покупателю. О том, как получить подтверждение оператора, написано в разделе Получение подтверждения оператора.

В результате этих действий получается УПД с двумя подписанными титулами, и документооборот УПД с функциями ДОП и СЧФДОП считается завершенным, никакие действия по документу больше не требуются.

Отправка уведомления об уточнении УПД

Для УПД с функциями СЧФ и СЧФДОП есть возможность отправить продавцу уведомление об уточнении.

Если покупатель обнаружил в полученном документе ошибку, он может запросить его исправление или корректировку.

Чтобы создать запрос на исправление или корректировку УПД, нужно сформировать уведомление об уточнении с помощью метода GenerateInvoiceCorrectionRequestXml (V2) и отправить его с помощью метода PostMessagePatch (V3) или PostMessagePatch (V4). Инструкция о генерации уведомления об уточнении приведена в разделе Генерация уведомления об уточнении.

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