.. _Integration_DocumentsGenerationApi_DocumentsGenerationUkdV2: Генерация УКД версии 5.02 ######################### | Запрос: ``POST /documents/generate/ukd_seller_5.02`` | HTTP-заголовки: .. code-block:: Authorization: Bearer access_token Accept: application/json Тело запроса: .. code-block:: JSON { "UtcOffsetInMinutes": 0, // смещение даты и времени относительно UTC (в минутах) "SellerTitle": { "SenderFnsId": "string", // идентификатор отправителя файла "ReceiverFnsId": "string", // идентификатор получателя файла "IsTrackable": false, // признак того, что документ используется в целях контроля за движением товаров, подлежащих прослеживаемости "IsMarkable": false, // признак того, что документ используется в целях контроля за движением товаров, подлежащих маркировке "IsMarkableAlcohol": false, // признак того, что документ используется в целях контроля за движением алкогольной продукции, подлежащей маркировке "IsTrackableNicotine": false, // признак того, что документ используется в целях контроля за движением/оборотом табачной продукции "IsTrackablePetroleum": false, // признак того, что использование настоящего формата предусмотрено в рамках движения нефтепродуктов "OtherNumber": "string", // свободное двузначное число, которое принимает значение в соответствии со списком в электронной форме "DocumentInfo": { "Uid": "string", // уникальный идентификатор документа "Function": 0, // функция документа "PrimaryDocumentName": "string", // наименование первичного документа "EconomicSubjectName": "string", // наименование экономического субъекта-составителя документа "AgreedStructureInformation": "string", // информация о наличии согласованной структуры доп. инф. полей "EconomicLifeSubjectDocument": { // основание, по которому экономический субъект является составителем файла обмена кор. счета-фактуры (реквизиты) }, "InvCorInfo": { // сведения о кор. счете-фактуре }, "TableInvoCor": { // сведения о таблице кор. счета-фактуры }, "EconomicFactOfLife3": { // содержание факта хозяйственной жизни 3 }, "Signers": [ // список подписантов ] } } } Описание запроса **************** Запрос ставит задачу на генерацию титула продавца УКД. В результате будет сгенерирован XML-документ титула продавца УКД. Функции УКД (``Function``): * ``0`` - КСЧФ; * ``1`` - ДИС; * ``2`` - КСЧФДИС; * ``3`` - Сведения об изменении стоимости товаров, реализованных комиссионером; * ``4`` - Сведения об изменении стоимости товаров, закупленных комиссионером. Сведения о корректировочном счете-фактуре ========================================= .. code-block:: JSON { "Number": "string", // номер "Date": "yyyy-MM-dd", // дата составления "Correction": { // сведения об исправлении кор. счета-фактуры "Number": 0, // номер исправления кор. счета-фактуры "Date": "yyyy-MM-dd" // дата исправления кор. счета-фактуры }, "Currency": { // сведения о единице денежного измерения "Code": "string", // код валюты "Name": "string", // наименование валюты "ExchangeRate": 0 // курс валюты } "ParticipantExtraInfo": { // дополнительные сведения об участниках факта хоз. жизни }, "Invoices": [ // список счет-фактур { "Number": "string", // номер счета-фактуры "Date": "yyyy-MM-dd", // дата составления счета-фактуры "Corrections": [ // список исправлений счета-фактуры { "Number": 0, // номер исправления счета-фактуры "Date": "yyyy-MM-dd" // дата исправления счета-фактуры } ] } ], "SellerInfo": { // сведения о продавце (участник) }, "BuyerInfo": { // сведения о покупателе (участник) }, "InformationalFactOfLife": { // информационное поле факта хозяйственной жизни { "FileId": "string", // идентификатор файла информационного поля "TextInfos": [ // список текстовой информации { "Id": "string", // идентификатор "Value": "string" // значение } ] } } } Дополнительные сведения об участниках факта хоз. жизни ====================================================== .. code-block:: JSON { "ContractId": "string", // идентификатор государственного контракта "InvoCorCircumstances": "string", // спец. обстоятельства формирования КСЧФ "InvoCorDisCircumstances": "string", // спец. обстоятельства формирования КСЧФДИС "DisCircumstances": "string", // спец. обстоятельства формирования ДИС "ObligationTypes": [ { "Code": "string", // код вида обязательств "Name": "string" // наименование вида обязательств } ], "SellerInfo": { // информация продавца об обстоятельствах закупок }, } Сведения об участнике ===================== .. code-block:: JSON { "Code": "string", // код в общероссийском классификаторе предприятий и организаций "CodeOpf": "string", // код по общероссийскому классификатору организационно-правовых форм "FullNameOpf": "string", // полное наименование ОПФ "Department": "string", // структурное подразделение "Information": "string", // информация для участника документооборота "ShortName": "string", // сокращенное наименование "IdentificationInformation": { // идентификационные сведения }, "Address": { // адрес }, "BankRequisite": { // банковские реквизиты }, "ContactDetails": { // контактные данные } } Содержание факта хозяйственной жизни 3 ====================================== .. code-block:: JSON { "OtherInfoChange": "string", // иные сведения об изменении стоимости "Operation": "string", // содержание операции "OperationDetails": "string", // уточнение содержания операции "Date": "yyyy-MM-dd", // дата направления на согласование "Documents": [ // список реквизитов передаточных документов (реквизиты) ], "GroundDocuments": [ // список сведений о документах, являющихся основанием корректировки (реквизиты) ] } Информация продавца об обстоятельствах закупок ============================================== .. code-block:: JSON { "Date": "yyyy-MM-dd", // дата гос. контракта "ContractNumber": "string", // номер гос. контракта "Account": "string", // номер лицевого счета продавца "BudgetCode": "string", // код по бюджетной классификации, продавец "ObjectCode": "string", // код цели, продавец "TreasuryCode": "string", // код территориального органа Федерального казначейства продавца "TreasuryName": "string" // наименование территориального органа Федерального казначейства продавца } Идентификационные сведения ========================== В идентификационных сведениях заполняется одно из следующих полей: * сведения об индивидуальном предпринимателе ``IndividualEntrepreneur``; * сведения о юридическом лице ``LegalEntity``; * сведения об иностранной организации ``ForeignEntity``; * сведения о физическом лице ``Individual``. .. code-block:: JSON { "IndividualEntrepreneur": { // сведения об индивидуальном предпринимателе }, "LegalEntity": { // сведения о юридическом лице }, "ForeignEntity": { // сведения об иностранной организации }, "Individual": { // сведения о физическом лице } } Сведения об индивидуальном предпринимателе ========================================== .. code-block:: JSON { "Inn": "string", // ИНН "RegistrationDocument": "string", // реквизиты свидетельства о регистрации ИП "Ogrn": "string", // ОГРН "DateOgrn": "yyyy-MM-dd", // дата присвоения ОГРН "OtherInformation": "string", // иные сведения "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество } } Сведения о юридическом лице =========================== .. code-block:: JSON { "Name": "string", // полное наименование "Inn": "string", // ИНН "Kpp": "string" // КПП } Сведения об иностранной организации =================================== .. code-block:: JSON { "IsForeignEntity": false, // признак идентификации статуса, иностранная организация/иностранный гражданин "CountryCode": "string", // код страны "CountryName": "string", // наименование страны "Name": "string", // наименование иностранной организации / ФИО иностранного гражданина "Id": "string", // идентификатор иностранной организации / иностранного гражданина "OtherInformation": "string" // иные сведения } Сведения о физическом лице ========================== .. code-block:: JSON { "Inn": "string", // ИНН "IsRetailBuyer": false, // признак того, что лицо является покупателем при розничной цене "OtherInformation": "string", // иные сведения "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество } } Сведения таблицы корректировочного счета-фактуры ================================================ Для сведений о сумме налога ``TotalTax`` заполняется либо сумма налога ``Value``, либо без НДС ``WithoutTax`` со значением ``true``. .. code-block:: JSON { "Products": [ // список сведений об отгруженных товарах ], "TotalAdd": { // реквизиты строки "Всего увеличение" "TotalCost": 0, // стоимость товара "всего" "TotalTaxCost": 0 // стоимость товара с налогом "всего" "TotalTax": { "Value": 0, // сумма налога "WithoutTax": false // признак того, что без НДС } }, "TotalDecr": { // реквизиты строки "Всего уменьшение" "TotalCost": 0, // стоимость товара "всего" "TotalTaxCost": 0 // стоимость товара с налогом "всего" "TotalTax": { "Value": 0, // сумма налога "WithoutTax": false // признак того, что без НДС } } } Сведения об отгруженном товаре ============================== | Для сведений о сумме акциза ``ExciseBefore`` и ``ExciseAfter`` заполняется либо сумма акциза ``Cost``, либо без акциза ``WithoutExcise`` со значением ``true``. | Для сведений о сумме налога ``TaxSumBefore`` и ``TaxSumAfter`` заполняется либо сумма налога ``Value``, либо без НДС ``WithoutTax`` со значением ``true``. .. code-block:: JSON { "RowOrder": 0, // порядковый номер записи "ProductOrder": 0, // порядковый номер товара "Name": "string", // наименование товара "UnitCode": "string", // код единицы измерения "UnitName": "string", // наименование единицы измерения после изменения "CountBefore": 0, // количество до изменения "CountAfter": 0, // количество после изменения "CostBefore": 0, // цена до изменения "CostAfter": 0, // цена после изменения "Tax": "string", // налоговая ставка "TotalCost": { // стоимость товаров без налога "CostBefore": 0, // стоимость отгруженных товаров до изменения "CostAfter": 0, // стоимость отгруженных товаров после изменения "CostAdd": 0, // стоимость отгруженных товаров - увеличение "CostDecr": 0 // стоимость отгруженных товаров - уменьшение }, "ExciseBefore": { // сумма акциза до изменения "Cost": 0, // сумма акциза "WithoutExcise": false // признак того, что без акциза }, "ExciseAfter": { // сумма акциза после изменения "Cost": 0, // сумма акциза "WithoutExcise": false // признак того, что без акциза }, "ExciseDifference": { // разница суммы акциза - увеличение или уменьшение "SumAdd": 0, // сумма - увеличение "SumDecr": 0 // сумма - уменьшение }, "TaxSumBefore": { // сумма налога до изменения "Value": 0, // сумма налога "WithoutTax": false // признак того, что без НДС }, "TaxSumAfter": { // сумма налога после изменения "Value": 0, // сумма налога "WithoutTax": false // признак того, что без НДС }, "TaxSumDifference": { // разница суммы налога - увеличение или уменьшение "SumAdd": 0, // сумма - увеличение "SumDecr": 0 // сумма - уменьшение }, "TotalTaxCost": { // стоимость товаров с налогом "CostBefore": 0, // стоимость отгруженных товаров до изменения "CostAfter": 0, // стоимость отгруженных товаров после изменения "CostAdd": 0, // стоимость отгруженных товаров - увеличение "CostDecr": 0 // стоимость отгруженных товаров - уменьшение }, "Declarations": [ // список сведений о декларации ], "TextInfos": [ // список информационного поля факта хоз. жизни 2 { "Id": "string", // идентификатор "Value": "string" // значение } ], "ExtraInfo": { // дополнительные сведения об отгруженных товарах } } Cведения о декларации ===================== .. code-block:: JSON { "CountryCode": "string", // цифровой код страны "RegistrationNumberBefore": "string", // регистрационный номер до изменения "RegistrationNumberAfter": "string", // регистрационный номер после изменения "ShortCountryName": "string", // краткое наименование страны "RegistrationNumberAdding": "string", // регистрационный номер - увеличение "RegistrationNumberDecrease": "string" // регистрационный номер - уменьшение } Дополнительные сведения об отгруженных товарах ============================================== .. code-block:: JSON { "Type": "string", // признак товара, имущество, работа и т.д. "TypeInfo": "string", // дополнительная информацию о признаке "Description": "string", // описание товара "ProductType": "string", // сорт товара "ProductSeries": "string", // серия товара "ProductArticle": "string", // артикул товара "ProductCode": "string", // код товара "CatalogCode": "string", // код каталога "ProductTypeCode": "string", // код вида товара "ProductionTypeCode": "string", // код вида продукции "ProductCodeOkpd2": "string", // код товара по ОКПД2 "TrackingInfos": [ // список сведений о товаре, подлежащем прослеживаемости ], "IdentificationInfosBefore": [ // список номеров средств идентификации товаров до изменения ], "IdentificationInfosAfter": [ // список номеров средств идентификации товаров после изменения ], "GosSystemInfos": [ // список дополнительных сведений о товаре, подлежащем идентификации и учету в гос. информационной системе ] } Сведения о товаре, подлежащем прослеживаемости ============================================== .. code-block:: JSON { "RegistrationNumber": "string", // регистрационный номер партии "Unit": "string", // единица количественного учета товара "UnitName": "string", // наименование единицы количественного учета товара "ExtraInfo": "string", // дополнительная информацию по товару "ChangeProductCount": { // изменения в количестве товара "Before": 0, // сведения до изменения "After": 0, // сведения после изменения "Adding": 0, // сведения увеличения "Decreasing": 0 // сведения уменьшения }, "ChangeProductCost": { // изменения в стоимости товара "Before": 0, // сведения до изменения "After": 0, // сведения после изменения "Adding": 0, // сведения увеличения "Decreasing": 0 // сведения уменьшения } } Сведения о номере средств идентификации товаров =============================================== .. code-block:: JSON { "Id": "string", // уникальный идентификатор транспортной упаковки "Gtin": "string", // глобальный идентификационный номер "Count": 0, // количество товара "Weight": 0, // вес товара "Kod": "string", // производственная партия (КОД) "Kizs": [ // список контрольных идентификационных знаков "string" ], "PackageIds": [ // список уникальных идентификаторов вторичной/третичной упаковки "string" ] } Дополнительные сведения о товаре, подлежащем идентификации и учету в ГИС ======================================================================== .. code-block:: JSON { "Name": "string", // наименование ГИС "Unit": "string", // учетная единица в ГИС "OtherInfo": "string", // иная информацию в ГИС "UnitIds": [ // список идентификационных номеров учетной единицы в ГИС "string" ] } Сведения о банковских реквизитах ================================ .. code-block:: JSON { "AccountNumber": "string", // номер банковского счета "BankDetails": { // сведения о банке "Name": "string", // наименование банка "Bik": "string", // БИК "BankAccount": "string" // счет банка } } Сведения о контактных данных ============================ .. code-block:: JSON { "Telephone": "string", // номер телефона "Email": "string", // адрес электронной почты "OtherInformation": "string" // иные контактные данные } Сведения о подписанте ===================== | Сведения о доверенностях в электронном формате заполняются, если способ подтверждения ``ApprovingMethod`` имеет значение ``3``. | Сведения о доверенностях в бумажном формате заполняются, если способ подтверждения ``ApprovingMethod`` имеет значение ``5``. .. code-block:: JSON { "Position": "string", // должность "Type": "string", // тип подписи "Date": "yyyy-MM-dd", // дата подписания документа "ApprovingMethod": "string", // способ подтверждения "ExtraInfo": "string", // дополнительные сведения "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество }, "PowerOfAttorneys": [ // список сведений о доверенностях в электронном формате ], "PaperPowerOfAttorneys": [ // список сведений о доверенностях в бумажном формате ] } Сведения о доверенности в электронном формате ============================================= .. code-block:: JSON { "Id": "string", // регистрационный номер доверенности "Date": "yyyy-MM-dd", // дата выдачи доверенности "InnerId": "string", // внутренний номер доверенности "InnerDate": "yyyy-MM-dd", // дата внутренней регистрации доверенности "SystemInfo": "string", // информационная система "Url": "string" // URL информационной системы } Сведения о доверенности в бумажном формате ========================================== .. code-block:: JSON { "Date": "yyyy-MM-dd", // дата выдачи доверенности "InnerId": "string", // внутренний номер доверенности "Info": "string", // сведения, идентифицирующие доверителя "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество }, } Сведения о реквизитах документа =============================== .. code-block:: JSON { "Name": "string", // наименование документа "Number": "string", // номер документа "Date": "yyyy-MM-dd", // дата документа "FileId": "string", // идентификатор файла обмена документа, подписанного первой стороной "DocumentId": "string", // идентификатор документа "InfoSystem": "string", // описание информационной системы "Url": "string", // URL об информационной системе "ExtraInfo": "string", // дополнительные сведения "EconomicLifeIdentifiers": [ // список идентифицирующих реквизитов экономических субъектов, составивших документ ] } Сведения об идентифицирующих реквизитах экономического субъекта =============================================================== В сведениях об идентифицирующих реквизитах экономического субъекта заполняется на выбор: * ИНН физического лица ``IndividualInn``; * ИНН организации ``LegalEntityInn``; * краткое наименование органа исполнительной власти ``ShortNameExecutiveAuthority``; * сведения об иностранной организации ``ForeignEntity``. .. code-block:: JSON { "IndividualInn": "string", // ИНН физического лица "LegalEntityInn": "string", // ИНН организации "ShortNameExecutiveAuthority": "string", // краткое наименование органа исполнительной власти "ForeignEntity": { // сведения об иностранной организации } } Сведения об адресе ================== В сведениях об адресе заполняется на выбор: * сведения об адресе в РФ ``RusAddress``; * сведения об иностранным адресе ``ForeignAddress``; * сведения об адресе в ГАР ``GarAddress``. .. code-block:: JSON { "Gln": "string", // глобальный номер места нахождения "RusAddress": { // сведения об адресе в РФ }, "ForeignAddress": { // сведения об иностранным адресе }, "GarAddress": { // сведения об адресе в ГАР } } Сведения об адресе в РФ ======================= .. code-block:: JSON { "PostalCode": "string", // почтовый индекс "RegionCode": "string", // код субъекта "RegionName": "string", // наименования субъекта "District": "string", // район "City": "string", // город "Locality": "string", // населенный пункт "Street": "string", // улица "House": "string", // дом "Building": "string", // корпус "Apartment": "string", // квартира "OtherInfo": "string" // иные сведения об адресе } Сведения об иностранном адресе ============================== .. code-block:: JSON { "CountryCode": "string", // код страны "CountryName": "string", // наименование страны "FullAddress": "string" // полный адрес } Сведения об адресе в ГАР ======================== .. code-block:: JSON { "UniqueNumber": "string", // уникальный номер адреса объекта "PostalCode": "string", // почтовый индекс "RegionCode": "string", // код субъекта "RegionName": "string", // наименование субъекта "MunicipalDistrict": { // сведения о муниципальном районе "Code": "string", // код адр. элемента "Name": "string" // наименование адр. элемента }, "UrbanDistrict": { // сведения о городском поселении "Code": "string", // код адр. элемента "Name": "string" // наименование адр. элемента }, "Locality": { // сведения о населенном пункте "Kind": "string", // вид адр. элемента "Name": "string" // наименование адр. элемента }, "PlanningElement": { // элемент планировочной структуры "Type": "string", // тип адр. элемента "Name": "string" // наименование адр. элемента }, "RoadNetworkElement": { // элемент улично-дорожной сети "Type": "string", // тип адр. элемента "Name": "string" // наименование адр. элемента }, "LandPlot": "string", // земельный участок "Building": { // сведения о здании "Type": "string", // тип адр. элемента "Number": "string" // номер адр. элемента }, "Premise": { // сведения о помещении "Type": "string", // тип адр. элемента "Number": "string" // номер адр. элемента }, "Apartment": { // сведения о квартире "Type": "string", // тип адр. элемента "Number": "string" // номер адр. элемента } }