GenerateInvoiceCorrectionRequestXml (V2)

Генерирует файл уведомления об уточнении.

POST /V2/GenerateInvoiceCorrectionRequestXml
Query Parameters:

  • boxId – идентификатор ящика организации.

Request Headers:
Request Body:

Тело запроса должно содержать структуру InvoiceCorrectionRequestGenerationRequestV2.

Status Codes:

  • 200 OK – операция успешно завершена.

  • 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

  • 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

  • 402 Payment Required – у указанного ящика закончилась подписка на API.

  • 403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.

  • 404 Not Found – не найдены документ или сообщение с указанным идентификатором, или указанная сущность имеет неверный тип, или у указанной сущности нет дочерней сущности типа Signature.

  • 405 Method Not Allowed – используется неподходящий HTTP-метод.

  • 409 Conflict – невозможно сформировать уведомление об уточнении.

  • 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Headers:

  • Content-Disposition – имя файла с уведомлением.

Response Body:

Тело ответа содержит XML-файл уведомления об уточнении attachmentId из сообщения messageId в ящике boxId. Файл формируется в соответствии с XSD-схемой уведомления об уточнении.

Для выполнения метода текущий пользователь должен иметь доступ к документу исходного счета-фактуры, иначе метод вернет ошибку 403 (Forbidden).

Примеры использования

Пример HTTP-запроса:

POST /V2/GenerateInvoiceCorrectionRequestXml?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json; charset=utf-8
Content-Type: application/json

Пример тела запроса:

{
    "ErrorMessage": "Текстовый комментарий",
    "MessageId": "{{messageId}}",
    "AttachmentId": "{{documentId}}",
    "SignerContent": "PD94bWwgdmVyc2l...LDQudC7Pg=="        // содержимое XML-файла с данными подписанта в кодировке Base-64
}

Пример тела ответа:

<?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="DP_UVUTOCH_2BM-1839264655-732644841-202407101103418496883_2BM-9147414342-757645784-202407101104400484330_20250207_8bc3aae6-ce88-459e-943a-37094526c16c" ВерсПрог="Diadoc 1.0" ВерсФорм="1.03">
  <Документ КНД="1115113">
    <УчастЭДО ИдУчастЭДО="2BM-9147414342-757645784-202407101104400484330">
      <ЮЛ НаимОрг="Получатель" ИННЮЛ="8147414342" КПП="857645784" />
    </УчастЭДО>
    <СвУведУточ ДатаПол="07.02.2025" ВремяПол="10.06.17">
      <СведПолФайл ИмяПолФайла="ON_NSCHFDOPPR_2BM-9147414342-757645784-202407101104400484330_2BM-1839264655-732644841-202407101103418496883_20250207_30f13ccc-deb2-4d49-8201-0ab211e8683d">
        <ЭППолФайл>...</ЭППолФайл>
      </СведПолФайл>
      <ТекстУведУточ>Текстовый комментарий</ТекстУведУточ>
    </СвУведУточ>
    <ОтпрДок ИдУчастЭДО="2BM-1839264655-732644841-202407101103418496883">
      <ЮЛ НаимОрг="Отправитель" ИННЮЛ="8125600340" КПП="832644841" />
    </ОтпрДок>
    <Подписант ТипПодпис="1" СтатПодп="2" Должн="Подписант-Должн">
      <ФИО Фамилия="Фамилия" Имя="Имя" Отчество="Отчество" />
      <СвДоверЭл СпособПредставл="1" НомДовер="c8a8949a-4907-4c36-9f48-7efb2fba1987" ДатаВыдДовер="17.09.2024" ВнНомДовер="123" ДатаВнРегДовер="18.09.2024" СвСистХран="СвДоверЭл-ИдСистХран" />
    </Подписант>
  </Документ>
</Файл>

См. также

Инструкции:
Устаревшие версии метода: