Перейти к основному содержимому

Работа с УПД

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

к сведению

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

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

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

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

  • documentTypeNamedId = UniversalTransferDocument
  • documentFunction = СЧФДОП
  • documentVersion = utd970_05_03_01
  • titleIndex = 0 (титул продавца)

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

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

к сведению

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

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

Пример 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
Accept: application/xml

Пример тела запроса метода 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 (V3):

  • TypeNamedId = UniversalTransferDocument
  • Function = СЧФДОП
  • Version = utd970_05_03_01

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

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

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

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

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

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

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

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

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

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

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

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:

<Файл ИдФайл="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:

<?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>

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

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

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

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

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

  • documentTypeNamedId = UniversalTransferDocument
  • documentFunction = СЧФДОП
  • documentVersion = utd970_05_03_01
  • titleIndex = 1 (титул покупателя)
  • letterId = {{letterId}} (значение из идентификатора титула продавца)
  • documentId = {{documentId}} (значение из идентификатора титула продавца)

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

к сведению

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

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

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

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
Accept: application/xml

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

<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 (титул покупателя):

<?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 (V4), передав его в поле RecipientTitles структуры MessagePatchToPostV2. Полная инструкция об отправке ответного титула приведена в разделе Отправка ответного титула.

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

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

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

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

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

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

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

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

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

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

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года