Генерация УПД¶
Запрос:
POST /documents/generate/upd970_sellerHTTP-заголовки:
Authorization: Bearer access_token
Accept: application/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- Сведения о товарах, закупленных комиссионером.
Примечание
На данный момент доступна генерация титула продавца УПД версии (FormatVersion) 5.03.
Сведения о счете-фактуре¶
{
"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": { // информационное поле факта хозяйственной жизни
}
}
}
Сведения о грузоотправителе¶
{
"CargoSender":{ // сведения о грузоотправителе (участник)
},
"Same": false // признак того, что грузоотправитель тот же самый, что и продавец
}
Дополнительные сведения об участниках факта хоз. жизни¶
{
"ContractId": "string", // идентификатор государственного контракта
"InvoCircumstances": "string", // спец. обстоятельства формирования СЧФ
"InvoDopCircumstances": "string", // спец. обстоятельства формирования СЧФДОП
"DopCircumstances": "string", // спец. обстоятельства формирования ДОП
"ObligationTypes": [
{
"Code": "string", // код вида обязательств
"Name": "string" // наименование вида обязательств
}
],
"SellerInfo": { // информация продавца об обстоятельствах закупок
},
"FactorInfo": { // сведения о факторе (участник)
},
"MoneyGround": { // основание уступки денежного требования (реквизиты)
},
"ClarifyingDocuments": [ // список сведений о сопроводительных документах (реквизиты)
],
}
Сведения об участнике¶
{
"Code": "string", // код в общероссийском классификаторе предприятий и организаций
"CodeOpf": "string", // код по общероссийскому классификатору организационно-правовых форм
"FullNameOpf": "string", // полное наименование ОПФ
"Department": "string", // структурное подразделение
"Information": "string", // информация для участника документооборота
"ShortName": "string", // сокращенное наименование
"IdentificationInformation": { // идентификационные сведения
},
"Address": { // адрес
},
"BankRequisite": { // банковские реквизиты
},
"ContactDetails": { // контактные данные
}
}
Содержание факта хозяйственной жизни 3¶
{
"Transfer": { // сведения о передаче товаров
},
"InformationalFactOfLife": { // информационное поле факта хозяйственной жизни
}
}
Информационное поле факта хозяйственной жизни¶
{
"FileId": "string", // идентификатор файла информационного поля
"TextInfos": [ // список текстовой информации
{
"Id": "string", // идентификатор
"Value": "string" // значение
}
]
}
Информация продавца об обстоятельствах закупок¶
{
"Date": "yyyy-MM-dd", // дата гос. контракта
"ContractNumber": "string", // номер гос. контракта
"Account": "string", // номер лицевого счета продавца
"BudgetCode": "string", // код по бюджетной классификации, продавец
"ObjectCode": "string", // код цели, продавец.
"TreasuryCode": "string", // код территориального органа Федерального казначейства продавца
"TreasuryName": "string" // наименование территориального органа Федерального казначейства продавца
}
Идентификационные сведения¶
В идентификационных сведениях заполняется одно из следующих полей:
сведения об индивидуальном предпринимателе
IndividualEntrepreneur;сведения о юридическом лице
LegalEntity;сведения об иностранной организации
ForeignEntity;сведения о физическом лице
Individual.
{
"IndividualEntrepreneur": { // сведения об индивидуальном предпринимателе
},
"LegalEntity": { // сведения о юридическом лице
},
"ForeignEntity": { // сведения об иностранной организации
},
"Individual": { // сведения о физическом лице
}
}
Сведения об индивидуальном предпринимателе¶
{
"Inn": "string", // ИНН
"RegistrationDocument": "string", // реквизиты свидетельства о регистрации ИП
"Ogrn": "string", // ОГРН
"DateOgrn": "yyyy-MM-dd", // дата присвоения ОГРН
"OtherInformation": "string", // иные сведения
"Person": {
"Surname": "string", // фамилия
"FirstName": "string", // имя
"FathersName": "string" // отчество
}
}
Сведения о юридическом лице¶
{
"Name": "string", // полное наименование
"Inn": "string", // ИНН
"Kpp": "string" // КПП
}
Сведения об иностранной организации¶
{
"IsForeignEntity": false, // признак идентификации статуса, иностранная организация/иностранный гражданин
"CountryCode": "string", // код страны
"CountryName": "string", // наименование страны
"Name": "string", // наименование иностранной организации / ФИО иностранного гражданина
"Id": "string", // идентификатор иностранной организации / иностранного гражданина
"OtherInformation": "string" // иные сведения
}
Сведения о физическом лице¶
{
"Inn": "string", // ИНН
"IsRetailBuyer": false, // признак того, что лицо является покупателем при розничной цене
"OtherInformation": "string", // иные сведения
"Person": {
"Surname": "string", // фамилия
"FirstName": "string", // имя
"FathersName": "string" // отчество
}
}
Сведения о передаче товаров¶
{
"Operation": "string", // содержание операции
"OperationType": "string", // вид операции
"Date": "yyyy-MM-dd", // дата отгрузки товаров
"StartDate": "yyyy-MM-dd", // начало периода оказания услуг
"EndDate": "yyyy-MM-dd", // окончание периода оказания услуг
"WithoutDocument": false, // признак того, что без документа-основания отгрузки
"Documents": [ // список оснований отгрузки товаров (реквизиты)
],
"Person": { // сведения о лице, передавшем товар
},
"Transportation": { // сведения о транспортировке
},
"TransferInfo": { // сведения о передаче вещи, изготовленной по договору подряда
}
}
Сведения о лице, передавшем товар¶
В запросе заполняется либо сведения о работнике организации продавца SellerWorker, либо иное лицо OtherWorker.
{
"SellerWorker": { // сведения о работнике организации продавца
},
"OtherWorker": { // иное лицо
}
}
Сведения о работнике организации продавца¶
{
"Position": "string", // должность
"OtherInfo": "string", // иные сведения
"Person": {
"Surname": "string", // фамилия
"FirstName": "string", // имя
"FathersName": "string" // отчество
}
}
Сведения об ином лице¶
В запросе заполняется либо представитель организации, которой доверена отгрузка товара Representative,
либо физического лицо, которому доверена отгрузка товара Individual.
{
"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" // отчество
}
}
}
Сведения о транспортировке¶
{
"Info": "string", // сведения о транспортировке
"Inkoterms": "string", // значение в соответствии с международными правилами толкования торговых терминов
"Version": "string" // версия международных правил
}
Сведения о передаче вещи, изготовленной по договору подряда¶
{
"Date": "yyyy-MM-dd", // дата передачи вещи
"Info": "string", // сведения о передаче
"Document": { // документ, подтверждающий передачу (реквизиты)
}
}
Сведения о таблице счета-фактуры¶
{
"Products": [ // сведения об отгруженных товарах
],
"TotalCost": { // "Всего к оплате"
}
}
Сведения об отгруженных товарах¶
Для сведений о сумме акциза
Excise заполняется либо сумма акциза Cost, либо без акциза WithoutExcise со значением true.Для сведений о сумме налога
TaxSum заполняется либо сумма налога Value, либо без НДС WithoutTax со значением true.{
"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" // значение
}
]
}
Сведения «Всего к оплат延
{
"Cost": 0, // всего к оплате, стоимость товаров без налога
"TaxCost": 0, // всего к оплате, стоимость товаров с налогом
"Count": 0, // количество
"Total": { // всего к оплате, сумма налога
}
}
Дополнительные сведения об отгруженных товарах¶
Для сведений о сумме налога TaxSum заполняется либо сумма налога Value, либо без НДС WithoutTax со значением true.
{
"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": [ // список дополнительных сведений о товаре, подлежащем идентификации и учету в гос. информационной системе
]
}
Сведения о товаре, подлежащем прослеживаемости¶
{
"RegistrationNumber": "string", // регистрационный номер партии
"Unit": "string", // единица количественного учета товара
"UnitName": "string", // наименование единицы количественного учета товара
"UnitCount": 0, // количество товара в единицах измерения
"Cost": 0, // стоимость товара без налога
"ExtraInfo": "string" // дополнительная информация по товару
}
Сведения о номере средств идентификации товаров¶
{
"Id": "string", // уникальный идентификатор транспортной упаковки
"Count": 0, // количество товара
"Kod": "string", // производственная партия (КОД)
"Kizs": [ // список контрольных идентификационных знаков
"string"
],
"PackageIds": [ // список уникальных идентификаторов вторичной/третичной упаковки
"string"
]
}
Дополнительные сведения о товаре, подлежащем идентификации и учету в ГИС¶
{
"Name": "string", // наименование ГИС
"Unit": "string", // учетная единица в ГИС
"OtherInfo": "string", // иная информация в ГИС
"UnitIds": [ // список идентификационных номеров учетной единицы в ГИС
"string"
]
}
Сведения о банковских реквизитах¶
{
"AccountNumber": "string", // номер банковского счета
"BankDetails": { // сведения о банке
"Name": "string", // наименование банка
"Bik": "string", // БИК
"BankAccount": "string" // счет банка
}
}
Сведения о контактных данных¶
{
"Telephone": "string", // номер телефона
"Email": "string", // адрес электронной почты
"OtherInformation": "string" // иные контактные данные
}
Сведения о подписанте¶
Сведения о доверенностях в электронном формате заполняются, если способ подтверждения
ApprovingMethod имеет значение 3.Сведения о доверенностях в бумажном формате заполняются, если способ подтверждения
ApprovingMethod имеет значение 5.{
"Position": "string", // должность
"Type": "string", // тип подписи
"Date": "yyyy-MM-dd", // дата подписания документа
"ApprovingMethod": "string", // способ подтверждения
"ExtraInfo": "string", // дополнительные сведения
"Person": {
"Surname": "string", // фамилия
"FirstName": "string", // имя
"FathersName": "string" // отчество
},
"PowerOfAttorneys": [ // список сведений о доверенностях в электронном формате
],
"PaperPowerOfAttorneys": [ // список сведений о доверенностях в бумажном формате
]
}
Сведения о доверенности в электронном формате¶
{
"Id": "string", // регистрационный номер доверенности
"Date": "yyyy-MM-dd", // дата выдачи доверенности
"InnerId": "string", // внутренний номер доверенности
"InnerDate": "yyyy-MM-dd", // дата внутренней регистрации доверенности
"SystemInfo": "string", // информационная система
"Url": "string" // URL информационной системы
}
Сведения о доверенности в бумажном формате¶
{
"Date": "yyyy-MM-dd", // дата выдачи доверенности
"InnerId": "string", // внутренний номер доверенности
"Info": "string", // сведения, идентифицирующие доверителя
"Person": {
"Surname": "string", // фамилия
"FirstName": "string", // имя
"FathersName": "string" // отчество
},
}
Сведения о реквизитах документа¶
{
"Name": "string", // наименование документа
"Number": "string", // номер документа
"Date": "yyyy-MM-dd", // дата документа
"FileId": "string", // идентификатор файла обмена документа, подписанного первой стороной
"DocumentId": "string", // идентификатор документа
"InfoSystem": "string", // описание информационной системы
"Url": "string", // URL об информационной системе
"ExtraInfo": "string", // дополнительные сведения
"EconomicLifeIdentifiers": [ // список идентифицирующих реквизитов экономических субъектов, составивших документ
]
}
Сведения об идентифицирующих реквизитах экономического субъекта¶
В сведениях об идентифицирующих реквизитах экономического субъекта заполняется на выбор:
ИНН физического лица
IndividualInn;ИНН организации
LegalEntityInn;краткое наименование органа исполнительной власти
ShortNameExecutiveAuthority;сведения об иностранной организации
ForeignEntity.
{
"IndividualInn": "string", // ИНН физического лица
"LegalEntityInn": "string", // ИНН организации
"ShortNameExecutiveAuthority": "string", // краткое наименование органа исполнительной власти
"ForeignEntity": { // сведения об иностранной организации
}
}
Сведения об адресе¶
В сведениях об адресе заполняется на выбор:
сведения об адресе в РФ
RusAddress;сведения об иностранным адресе
ForeignAddress;сведения об адресе в ГАР
GarAddress.
{
"Gln": "string", // глобальный номер места нахождения
"RusAddress": { // сведения об адресе в РФ
},
"ForeignAddress": { // сведения об иностранным адресе
},
"GarAddress": { // сведения об адресе в ГАР
}
}
Сведения об адресе в РФ¶
{
"PostalCode": "string", // почтовый индекс
"RegionCode": "string", // код субъекта
"RegionName": "string", // наименование субъекта
"District": "string", // район
"City": "string", // город
"Locality": "string", // населенный пункт
"Street": "string", // улица
"House": "string", // дом
"Building": "string", // корпус
"Apartment": "string", // квартира
"OtherInfo": "string" // иные сведения об адресе
}
Сведения об иностранном адресе¶
{
"CountryCode": "string", // код страны
"CountryName": "string", // наименование страны
"FullAddress": "string" // полный адрес
}
Сведения об адресе в ГАР¶
{
"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" // номер адр. элемента
}
}