.. _Integration_DocumentsGenerationApi_DocumentsGenerationUkdV1: Генерация УКД версии 5.01 ######################### | Запрос: ``POST /documents/generate/ukd_seller_5.01`` | 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", // свободное двузначное число, которое принимает значение в соответствии со списком в электронной форме "Operator": { "Name": "string", // наименование оператора "Inn": "string", // ИНН оператора "Id": "string" // идентификатор оператора } "DocumentInfo": { "Function": 0, // функция документа "PrimaryDocumentName": "string", // наименование первичного документа "EconomicSubjectName": "string", // наименование экономического субъекта-составителя документа "EconomicLifeSubjectDocumentName": "string", // основание, по которому экономический субъект является составителем файла обмена кор. счета-фактуры "InvCorInfo": { // сведения о корректировочном счете-фактуре }, "TableInvoCor": { // сведения таблицы корректировочного счета-фактуры }, "EconomicFactOfLife3": { // содержание факта хозяйственной жизни 3 }, "Signers": [ // список подписантов ] } Описание запроса **************** Запрос ставит задачу на генерацию титула продавца УКД. В результате будет сгенерирован XML-документ титула продавца УКД. Функции УКД (``Function``): * ``0`` - КСЧФ; * ``1`` - ДИС; * ``2`` - КСЧФДИС; * ``3`` - Сведения об изменении стоимости товаров, реализованных комиссионером; * ``4`` - Сведения об изменении стоимости товаров, закупленных комиссионером. Сведения о корректировочном счете-фактуре ========================================= .. code-block:: JSON { "Number": "string", // номер "Date": "yyyy-MM-dd", // дата составления "Code": "string", // код валюты "Correction": { // сведения об исправлении кор. счета-фактуры "Number": 0, // номер исправления кор. счета-фактуры "Date": "yyyy-MM-dd" // дата исправления кор. счета-фактуры }, "ParticipantExtraInfo": { // дополнительные сведения об участниках факта хоз. жизни "ContractId": "string", // идентификатор государственного контракта "Name": "string", // наименование валюты "ExchangeRate": 0 // курс валюты }, "Invoices": [ // список счет-фактур ], "SellerInfo": { // сведения о продавце (участник) }, "BuyerInfo": { // сведения о покупателе (участник) }, "InformationalFactOfLife": { // информационное поле факта хозяйственной жизни { "FileId": "string", // идентификатор файла информационного поля "TextInfos": [ // список текстовой информации { "Id": "string", // идентификатор "Value": "string" // значение } ] } } } Сведения о счете-фактуре ======================== .. code-block:: JSON { "Number": "string", // номер "Date": "yyyy-MM-dd", // дата составления "Corrections": [ { "Number": 0, // номер исправления кор. счета-фактуры "Date": "yyyy-MM-dd" // дата исправления кор. счета-фактуры } ] } Сведения об участнике ===================== .. code-block:: JSON { "Code": "string", // код в общероссийском классификаторе предприятий и организаций "Department": "string", // структурное подразделение "Information": "string", // информация для участника документооборота "BankRequisite": { // банковские реквизиты "AccountNumber": "string", // номер банковского счета "BankDetails": { // сведения о банке "Name": "string", // наименование банка "Bik": "string", // БИК "BankAccount": "string" // счет банка } }, "ContactDetails": { // контактные данные "Telephone": "string", // номер телефона "Email": "string" // адрес электронной почты } "IdentificationInformation": { // идентификационные сведения }, "Address": { // сведения об адресе } } Содержание факта хозяйственной жизни 3 ====================================== .. code-block:: JSON { "OtherInfoChange": "string", // иные сведения об изменении стоимости "Operation": "string", // содержание операции "Date": "yyyy-MM-dd", // дата направления на согласование "Documents": [ // список реквизитов передаточных документов (реквизиты) ], "GroundDocuments": [ // список сведений о документах, являющихся основанием корректировки (реквизиты) ] } Сведения таблицы корректировочного счета-фактуры ================================================ Для сведений о сумме налога ``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", // наименование товара "UnitCodeBefore": "string", // код единицы измерения до изменения "UnitCodeAfter": "string", // код единицы измерения после изменения "CountBefore": 0, // количество до изменения "CountAfter": 0, // количество после изменения "CostBefore": 0, // цена до изменения "CostAfter": 0, // цена после изменения "TaxBefore": "string", // налоговая ставка до изменения "TaxAfter": "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 // стоимость отгруженных товаров - уменьшение }, "TextInfos": [ // список информационного поля факта хоз. жизни 2 { "Id": "string", // идентификатор "Value": "string" // значение } ], "ExtraInfo": { // дополнительные сведения об отгруженных товарах }, "TrackingInfos": [ // список сведений о товаре, подлежащем прослеживаемости ], "IdentificationInfosBefore": [ // список номеров средств идентификации товаров до изменения ], "IdentificationInfosAfter": [ // список номеров средств идентификации товаров после изменения ] } Дополнительные сведения об отгруженных товарах ============================================== .. code-block:: JSON { "Description": "string", // описание товара "ProductType": "string", // сорт товара "ProductArticle": "string", // артикул товара "ProductCode": "string", // код товара "UnitNameBefore": "string", // наименование единицы измерения до изменения "UnitNameAfter": "string", // наименование единицы измерения после изменения "ProductTypeCode": "string" // код вида товара } Сведения о товаре, подлежащем прослеживаемости ============================================== .. code-block:: JSON { "RegistrationNumber": "string", // регистрационный номер партии "Unit": "string", // единица количественного учета товара "ExtraInfo": "string", // дополнительная информацию по товару "ChangeProductCount": { // изменения в количестве товара "Before": 0, // сведения до изменения "After": 0, // сведения после изменения "Adding": 0, // сведения увеличения "Decreasing": 0 // сведения уменьшения } } Сведения о номере средств идентификации товаров =============================================== .. code-block:: JSON { "Id": "string", // уникальный идентификатор транспортной упаковки "Kizs": [ // список контрольных идентификационных знаков "string" ], "PackageIds": [ // список уникальных идентификаторов вторичной/третичной упаковки "string" ] } Сведения о подписанте ===================== .. code-block:: JSON { "Authority": "string", // область полномочий "Status": "string", // статус "GroundAuthority": "string", // основание полномочий "GroundAuthorityOrganization": "string", // основание полномочий организации "IndividualEntrepreneur": { // сведения об индивидуальном предпринимателе }, "LegalEntity": { // сведения о юридическом лице }, "Individual":{ // сведения о физическом лице } } Идентификационные сведения ========================== В идентификационных сведениях заполняется на выбор: * сведения об индивидуальном предпринимателе ``IndividualEntrepreneur``; * сведения о юридическом лице ``LegalEntity``; * сведения об иностранной организации ``ForeignEntity``. .. code-block:: JSON { "IndividualEntrepreneur": { // сведения об индивидуальном предпринимателе }, "LegalEntity": { // сведения о юридическом лице }, "ForeignEntity":{ // сведения об иностранной организации } } Сведения о физическом лице ========================== .. code-block:: JSON { "Requisite": "string", // реквизиты свидетельства о государственной регистрации в качестве индивидуального предпринимателя физического лица "Inn": "string", // ИНН "OtherInfo": "string", // иные сведения "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество } } Сведения об индивидуальном предпринимателе ========================================== .. code-block:: JSON { "Inn": "string", // ИНН "RegistrationDocument": "string", // реквизиты свидетельства о регистрации ИП "OtherInformation": "string", // иные сведения "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество } } Сведения о юридическом лице =========================== .. code-block:: JSON { "Name": "string", // полное наименование "Inn": "string", // ИНН "Kpp": "string", // КПП "Requisite": "string", // реквизиты свидетельства о государственной регистрации в качестве индивидуального предпринимателя физического лица "Position": "string", // должность "OtherInfo": "string", // иные сведения "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество } } Сведения об иностранной организации =================================== .. code-block:: JSON { "Name": "string", // наименование иностранной организации / ФИО иностранного гражданина "Id": "string", // идентификатор иностранной организации / иностранного гражданина "OtherInformation": "string" // иные сведения } Сведения о реквизитах документа =============================== .. code-block:: JSON { "Name": "string", // наименование документа "Number": "string", // номер документа "Date": "yyyy-MM-dd", // дата документа "ExtraInfo": "string", // дополнительные сведения "GroundDocumentId": "string" // идентификатор файла основания } Сведения об адресе ================== В сведениях об адресе заполняется на выбор: * сведения об адресе в РФ ``RusAddress``; * сведения об иностранным адресе ``ForeignAddress``; * код адреса в ГАР ``GarCode``. .. code-block:: JSON { "RusAddress": { // сведения об адресе в РФ }, "ForeignAddress": { // сведения об иностранным адресе }, "GarCode": "string" // код адреса в ГАР } Сведения об адресе в РФ ======================= .. code-block:: JSON { "PostalCode": "string", // почтовый индекс "RegionCode": "string", // код субъекта "District": "string", // район "City": "string", // город "Locality": "string", // населенный пункт "Street": "string", // улица "House": "string", // дом "Building": "string", // корпус "Apartment": "string", // квартира } Сведения об иностранном адресе ============================== .. code-block:: JSON { "CountryCode": "string", // код страны "FullAddress": "string" // полный адрес }