.. _Integration_DocumentsGenerationApi_DocumentsGenerationUpd: Генерация УПД ############# | Запрос: ``POST /documents/generate/upd970_seller`` | HTTP-заголовки: .. code-block:: Authorization: Bearer access_token Accept: application/json Тело запроса: .. code-block:: JSON { "UtcOffsetInMinutes": 0, // смещение даты и времени относительно UTC (в минутах) "SellerTitle": { "FormatVersion": "string", // версия формата "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", // информация о наличии согласованной структуры доп. инф. полей "Invoice": { // сведения о счете-фактуре }, "TableInvoice": { // сведения о таблице счета-фактуры }, "EconomicFactOfLife": { // содержание факта хозяйственной жизни 3 }, "Signers": [ // список подписантов ], "Document": { // основание, по которому экономический субъект является составителем файла обмена счета-фактуры }, } } } Описание запроса **************** Запрос ставит задачу на генерацию титула продавца УПД. В результате будет сгенерирован XML-документ титула продавца УПД. Функции УПД (``Function``): * ``0`` - СЧФ; * ``1`` - ДОП; * ``2`` - СЧФДОП; * ``3`` - Сведения о товарах, реализованных комиссионером; * ``4`` - Сведения о товарах, закупленных комиссионером. .. note:: На данный момент доступна генерация титула продавца УПД версии (``FormatVersion``) ``5.03``. Сведения о счете-фактуре ======================== .. code-block:: JSON { "Invoice": { "Number": "string", // номер счет-фактуры "DateTime": "yyyy-MM-dd", // дата составления "SellerFileName": "string", // имя файла обмена, информации продавца "BuyerFileName": "string", // имя файла обмена, информации покупателя "Correction": { "Number": 0, // номер исправления "Date": "yyyy-MM-dd" // дата исправления }, "PaymentSettlementInfos": [ { "Number": "string", // номер платежно-расчетного документа "Date": "yyyy-MM-dd", // дата составления платежно-расчетного документа "Total": 0 // сумма платежно-расчетного документа } ], "Currency": { "Code": "string", // код валюты "Name": "string", // наименование валюты "ExchangeRate": 0 // курс валюты }, "SellerInfos": [ // список сведений о продавцах (участник) ], "CargoSenderInfos": [ // список сведений о грузоотправителях ], "ReceiverInfos": [ // список сведений о грузополучателях (участник) ], "DocumentRequisites": [ // список реквизитов документа об отгрузке товаров (реквизиты) ], "Buyers": [ // список сведений о покупателях (участник) ], "ParticipantExtraInfo": { // дополнительные сведения об участниках факта хоз. жизни }, "InformationalFactOfLife": { // информационное поле факта хозяйственной жизни } } } Сведения о грузоотправителе =========================== .. code-block:: JSON { "CargoSender":{ // сведения о грузоотправителе (участник) }, "Same": false // признак того, что грузоотправитель тот же самый, что и продавец } Дополнительные сведения об участниках факта хоз. жизни ====================================================== .. code-block:: JSON { "ContractId": "string", // идентификатор государственного контракта "InvoCircumstances": "string", // спец. обстоятельства формирования СЧФ "InvoDopCircumstances": "string", // спец. обстоятельства формирования СЧФДОП "DopCircumstances": "string", // спец. обстоятельства формирования ДОП "ObligationTypes": [ { "Code": "string", // код вида обязательств "Name": "string" // наименование вида обязательств } ], "SellerInfo": { // информация продавца об обстоятельствах закупок }, "FactorInfo": { // сведения о факторе (участник) }, "MoneyGround": { // основание уступки денежного требования (реквизиты) }, "ClarifyingDocuments": [ // список сведений о сопроводительных документах (реквизиты) ], } Сведения об участнике ===================== .. code-block:: JSON { "Code": "string", // код в общероссийском классификаторе предприятий и организаций "CodeOpf": "string", // код по общероссийскому классификатору организационно-правовых форм "FullNameOpf": "string", // полное наименование ОПФ "Department": "string", // структурное подразделение "Information": "string", // информация для участника документооборота "ShortName": "string", // сокращенное наименование "IdentificationInformation": { // идентификационные сведения }, "Address": { // адрес }, "BankRequisite": { // банковские реквизиты }, "ContactDetails": { // контактные данные } } Содержание факта хозяйственной жизни 3 ====================================== .. code-block:: JSON { "Transfer": { // сведения о передаче товаров }, "InformationalFactOfLife": { // информационное поле факта хозяйственной жизни } } Информационное поле факта хозяйственной жизни ============================================= .. code-block:: JSON { "FileId": "string", // идентификатор файла информационного поля "TextInfos": [ // список текстовой информации { "Id": "string", // идентификатор "Value": "string" // значение } ] } Информация продавца об обстоятельствах закупок ============================================== .. 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" // отчество } } Сведения о передаче товаров =========================== .. code-block:: JSON { "Operation": "string", // содержание операции "OperationType": "string", // вид операции "Date": "yyyy-MM-dd", // дата отгрузки товаров "StartDate": "yyyy-MM-dd", // начало периода оказания услуг "EndDate": "yyyy-MM-dd", // окончание периода оказания услуг "WithoutDocument": false, // признак того, что без документа-основания отгрузки "Documents": [ // список оснований отгрузки товаров (реквизиты) ], "Person": { // сведения о лице, передавшем товар }, "Transportation": { // сведения о транспортировке }, "TransferInfo": { // сведения о передаче вещи, изготовленной по договору подряда } } Сведения о лице, передавшем товар ================================= В запросе заполняется либо сведения о работнике организации продавца ``SellerWorker``, либо иное лицо ``OtherWorker``. .. code-block:: JSON { "SellerWorker": { // сведения о работнике организации продавца }, "OtherWorker": { // иное лицо } } Сведения о работнике организации продавца ========================================= .. code-block:: JSON { "Position": "string", // должность "OtherInfo": "string", // иные сведения "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество } } Сведения об ином лице ===================== В запросе заполняется либо представитель организации, которой доверена отгрузка товара ``Representative``, либо физического лицо, которому доверена отгрузка товара ``Individual``. .. code-block:: JSON { "Representative": { // представитель организации, которой доверена отгрузка товара "Position": "string", // должность "OtherInfo": "string", // иные сведения "OrganizationName": "string", // наименование организации "Inn": "string", // ИННЮЛ "Document": { // основание, по которому организации доверена отгрузка товаров (реквизиты) }, "TrusteeDocument": { // основание полномочий представителя (реквизиты) }, "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество } }, "Individual": { // физического лицо, которому доверена отгрузка товара "Inn": "string", // ИНН "OtherInfo": "string", // иные сведения "Document": { // основание, по которому физ. лицу доверена отгрузка товаров (реквизиты) }, "Person": { "Surname": "string", // фамилия "FirstName": "string", // имя "FathersName": "string" // отчество } } } Сведения о транспортировке ========================== .. code-block:: JSON { "Info": "string", // сведения о транспортировке "Inkoterms": "string", // значение в соответствии с международными правилами толкования торговых терминов "Version": "string" // версия международных правил } Сведения о передаче вещи, изготовленной по договору подряда =========================================================== .. code-block:: JSON { "Date": "yyyy-MM-dd", // дата передачи вещи "Info": "string", // сведения о передаче "Document": { // документ, подтверждающий передачу (реквизиты) } } Сведения о таблице счета-фактуры ================================ .. code-block:: JSON { "Products": [ // сведения об отгруженных товарах ], "TotalCost": { // "Всего к оплате" } } Сведения об отгруженных товарах =============================== | Для сведений о сумме акциза ``Excise`` заполняется либо сумма акциза ``Cost``, либо без акциза ``WithoutExcise`` со значением ``true``. | Для сведений о сумме налога ``TaxSum`` заполняется либо сумма налога ``Value``, либо без НДС ``WithoutTax`` со значением ``true``. .. code-block:: JSON { "Order": 0, // порядковый номер записи "Name": "string", // наименование товара "UnitCode": "string", // код единицы измерения "UnitName": "string", // название единицы измерения "Count": 0, // количество товара "Cost": 0, // цена товара "TotalCost": 0, // стоимость товаров "Tax": "string", // налоговая ставка "TaxCost": 0, // стоимость товаров с налогом "Declaration": [ // список сведений о декларации { "CountryCode": "string", // цифровой код страны "RegistrationNumber": "string" // регистрационный номер } ], "ExtraInfo": { // дополнительные сведения об отгруженных товарах }, "Excise": { "Cost": 0, // сумма акциза "WithoutExcise": false // признак того, что без акциза }, "TaxSum": { "Value": 0, // сумма налога "WithoutTax": false // признак того, что без НДС } "TextInfos": [ // список информационного поля факта хоз. жизни { "Id": "string", // идентификатор "Value": "string" // значение } ] } Сведения "Всего к оплате" ========================= .. code-block:: JSON { "Cost": 0, // всего к оплате, стоимость товаров без налога "TaxCost": 0, // всего к оплате, стоимость товаров с налогом "Count": 0, // количество "Total": { // всего к оплате, сумма налога } } Дополнительные сведения об отгруженных товарах ============================================== Для сведений о сумме налога ``TaxSum`` заполняется либо сумма налога ``Value``, либо без НДС ``WithoutTax`` со значением ``true``. .. code-block:: JSON { "Type": "string", // признак товара, имущество, работа и т.д. "TypeInfo": "string", // дополнительная информация о признаке "Count": 0, // заказанное количество "Description": "string", // описание товара "ProductType": "string", // сорт товара "ProductSeries": "string", // серия товара "ProductArticle": "string", // артикул товара "ProductCode": "string", // код товара "Gtin": "string", // глобальный идентификационный номер товарной продукции "CatalogCode": "string", // код каталога "ProductTypeCode": "string", // код вида товара "ProductionTypeCode": "string", // код вида продукции "ProductCodeOkpd2": "string", // код товара по ОКПД2 "ExtraOperationInfo": "string", // дополнительная информация к продукции по видам операции "Countries": [ // список кратких наименований страны происхождения товара "string" ], "Documents": [ // список сведений о сопроводительных документах по товару (реквизиты) ], "AmortizationTax": { // данные налогового учета по расчету амортизации "Group": "string", // амортизационная группа "Code": "string", // код вида основных фондов "Period": "string", // срок полезного использования "FactPeriod": "string" // фактический срок полезного использования } "TaxSum": { "Value": 0, // сумма налога "WithoutTax": false // признак того, что без НДС } "TrackingInfos": [ // список сведений о товаре, подлежащем прослеживаемости ], "IdentificationInfos": [ // список номеров средств идентификации товаров ], "GosSystemInfos": [ // список дополнительных сведений о товаре, подлежащем идентификации и учету в гос. информационной системе ] } Сведения о товаре, подлежащем прослеживаемости ============================================== .. code-block:: JSON { "RegistrationNumber": "string", // регистрационный номер партии "Unit": "string", // единица количественного учета товара "UnitName": "string", // наименование единицы количественного учета товара "UnitCount": 0, // количество товара в единицах измерения "Cost": 0, // стоимость товара без налога "ExtraInfo": "string" // дополнительная информация по товару } Сведения о номере средств идентификации товаров =============================================== .. code-block:: JSON { "Id": "string", // уникальный идентификатор транспортной упаковки "Count": 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" // номер адр. элемента } }