Генерация вложений¶
POST /document/accept/contentAuthorization: Bearer access_token
Content-Type: application/json
Accept: application/json
Тело запроса:
{
"DocumentId": "guid", // идентификатор документа
"Signer": { // подписант
},
"Certificate": "base64", // открытая часть сертификата подписанта в Base64
"SignersSettings": [ // настройки подписанта для документов пакета
],
"AcceptanceResults": [ // сведения по итогам приемки для документов пакета
],
"MaterialAssetsAcceptanceResults": [ // сведения по итогам приемки материальных ценностей для документов пакета
],
"ActReconAcceptanceResults": [ // сведения по итогам приемки акта сверки
]
}
Описание запроса¶
Запрос ставит задачу на генерацию вложений для приемки.
Для формализованных документов вложением будет второй титул. Для остальных документов вложением будет первичное вложение, т. е. в этом случае генерация не происходит и результатом будет сам документ.
Настройки подписантов¶
Настройки подписантов нужны для формализованных документов. Они задают полномочия и статус подписанта:
{
"DocumentId": "guid", // идентификатор документа
"SignerPowersBase": "string", // основание полномочий подписанта
"SignerOrganizationPowersBase": "string", // основание полномочий организации, в которой работает подписант
"SignerPowers": 0, // область полномочий подписанта
"SignerStatus": 0 // статус подписанта
}
Настройки передаются в разрезе документов: если в пакете несколько документов, то для каждого документа могут быть заданы свои значения. Если настройки для документа не переданы, то используются значения по умолчанию.
Значения полей SignerPowers и SignerStatus являются перечислениями и определяются приказами ФНС.
Примечание
Полномочия и статус подписанта обычно передаются в XML-элементе Подписант.
Примечание
Значения по умолчанию могут отличаться для разных типов документов, но в целом значения по умолчнанию сводятся к тому, что документ принимает работник организации-покупателя, который имеет полномочия в силу должностных обязанностей.
Сведения по итогам приемки¶
Сведения по итогам приемки нужны для универсальных передаточных документов (УПД).
Они задают содержимое элемента КодСодОпер во втором титуле УПД:
{
"DocumentId": "guid", // идентификатор документа
"AcceptanceResultType": 0, // код, обозначающий итог приемки
"DivergenceDocumentName": "string", // наименование документа, оформляющего расхождения
"DivergenceDocumentType": 0, // код вида документа о расхождениях
"DivergenceDocumentNumber": "string", // номер документа покупателя о расхождениях
"DivergenceDocumentDate": "YYYY-MM-DD", // дата документа о расхождениях
"DivergenceDocumentFileId": "string" // идентификатор файла обмена документа о расхождениях
}
Сведения передаются в разрезе документов: если в пакете несколько УПД, то для каждого документа могут быть заданы свои значения. Если сведения для документа не переданы, то используются значения по умолчанию.
Примечание
Приемка по умолчанию предполагает отсутствие расхождений.
Сведения по итогам приемки материальных ценностей¶
Сведения по итогам приемки материальных ценностей нужны для файла дополнительных сведений к документу о расхождениях (ТОРГ-2).
Они задают содержимое элемента СвИтПрием в файле дополнительных сведений:
{
"DocumentId": "guid",
"Date": "2022-11-16T14:00:04.602Z",
"AcceptanceText": "string",
"Information": {
"FileId": "guid",
"TextInformation": [
{
"Id": "string",
"Value": "string"
}
]
}
}
Сведения передаются в разрезе документов: если в пакете несколько ТОРГ-2, то для каждого документа должны быть заданы свои значения. Сведения обязательны к заполнению: если они не переданы для каждого ТОРГ-2, то генерация завершится с ошибкой.
Сведения по итогам приемки актов сверки¶
Сведения по итогам приемки актов сверки задают содержимое элемента ТаблАкт во втором титуле акта сверки (Акт сверки):
{
"DocumentId": "guid", // идентификатор документа
"Divergences": [ // сведения о разногласиях
]
}
Сведения передаются в разрезе документов: если в пакете несколько актов сверки, то для каждого документа должны быть заданы свои значения.
Структура данных разногласий¶
{
"OpeningBalanceDebit": 0, // сумма сальдо на начало периода сверки, дебет
"OpeningBalanceCredit": 0, // сумма сальдо на начало периода сверки, кредит
"TurnoverBalanceDebit": 0, // обороты по дебету
"TurnoverBalanceCredit": 0, // обороты по кредиту
"FinalBalanceDebit": 0, // сумма сальдо на конец периода сверки, дебет
"FinalBalanceCredit": 0, // сумма сальдо на конец периода сверки, кредит
"TotalDiscrepancyDebit": 0, // итоговое расхождение, дебет
"TotalDiscrepancyCredit": 0, // итоговое расхождение, кредит
"AdditionalInformation": "string", // дополнительная информация
"Contracts": [ // сведения о договорах
]
}
Структура данных договора¶
{
"ContractId": "string", // идентификатор договора
"ContractType": "string", // описание типа договора
"ContractNumber": "string", // номер договора
"ContractDate": "2024-04-03T16:00:37.126Z", // дата договора
"OpeningBalanceDebit": 0, // сумма сальдо на начало периода сверкаи, дебет
"OpeningBalanceCredit": 0, // сумма сальдо на начало периода сверкаи, кредит
"TurnoverBalanceDebit": 0, // обороты по дебету
"TurnoverBalanceCredit": 0, // обороты по кредиту
"FinalBalanceDebit": 0, // сумма сальдо на конец периода сверки, дебет
"FinalBalanceCredit": 0, // сумма сальдо на конец периода сверки, кредит
"TotalDiscrepancyDebit": 0, // итоговое расхождение, дебет
"TotalDiscrepancyCredit": 0, // итоговое расхождение, кредит
"AdditionalInformation": "string", // дополнительная информация
"Documents": [ // сведения о документах
]
}
Структура данных документа¶
{
"Name": "string", // наименование документа
"Number": "string", // номер документа
"Date": "2024-04-03T16:00:37.126Z", // дата документа
"DocumentId": "string", // идентификатор документа
"TotalDiscrepancy": 0, // итоговое расхождение
"AdditionalInformation": "string", // дополнительная информация
"Operations": [ // сведения об операциях
]
}
Структура данных операции¶
{
"Name": "string", // наименование операции
"Number": "string", // номер строки в таблице сведений об операциях
"Date": "2024-04-03T16:00:37.126Z", // дата операции
"Debit": 0, // сумма дебета операции
"Credit": 0, // сумма кредита операции
"AdditionalInformation": "string" // дополнительная информация
}
Ответ на запрос¶
Генерация вложений выполняется асинхронно. В случае успешного выполнения запроса ставится задача на генерацию и возвращается ее идентификатор.