Перейти к основному содержимому

Работа с документом для отмены сведений об отгрузке

Генерация документа для отмены сведений об отгрузке маркированных товаров

Чтобы отменить сведения об отгрузке маркированных товаров, сгенерируйте и отправьте специальный служебный документ.

Сгенерировать документ для отмены сведений об отгрузке можно с помощью метода GenerateTtGisFixationCancellationRequest.

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

POST /GenerateTtGisFixationCancellationRequest?boxId={{boxId}}&messageId={{messageId}}&documentId={{documentId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}

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

{
"fixation_document_id": "FIX_ON_NSCHFDOPPR_2BM-9147414342-757645784-202407101104400484330_2BM-3175546205-732644841-202407101103418496883_20250620_fc857ac8-5e25-4cd3-91fd-77f0a8e141d4_0_1_1_0_0_00",
"inn": "1234567890"
}

В ответе метод вернет сгенерированный JSON-файл документа. Полученный файл нужно подписать электронной подписью и поместить в структуру TtGisFixationCancellationRequestAttachment. Отправить эту структуру можно с помощью метода PostMessagePatch (V4), передав ее в поле TtGisFixationCancellationRequests структуры MessagePatchToPostV2 соответственно. Инструкция об отправке документа приведена ниже.

Отправка документа для отмены сведений об отгрузке маркированных товаров

Инструкция по созданию документа для отмены сведений об отгрузке маркированных товаров приведена выше в разделе Генерация документа для отмены сведений об отгрузке маркированных товаров.

Чтобы отправить документ, в теле запроса метода PostMessagePatch (V4) передайте структуру MessagePatchToPostV2, заполненную следующими данными:

  • BoxId — идентификатор ящика, в котором находится исходное сообщение;
  • MessageId — идентификатор сообщения, к которому относится дополнение;
  • TtGisFixationCancellationRequests — вложенная структура для передачи документов для отмены сведений об отгрузке маркированных товаров:
    • DocumentId — идентификатор документа, содержащего маркированные товары, сведения об отгрузке которых необходимо отменить;
    • SignedContent.Content — содержимое JSON-файла документа для отмены сведений об отгрузке, сконвертированное в Base64-строку;
    • SignedContent.Signature — содержимое файла подписи документа для отмены сведений об отгрузке, сконвертированное в Base64-строку.

Пример тела запроса метода PostMessagePatch с документом для отмены сведений об отгрузке маркированных товаров:

{
"BoxId": "{{boxId}}",
"MessageId": "d94982e8-7eb9-4993-8c52-41c14e3fc3a8",
"TtGisFixationCancellationRequests": [
{
"DocumentId": "05ea290d-9aa1-4291-a87b-d30be9ccf5b7",
"SignedContent":
{
"Content": "eyJpbm4iOiI2MT...F8wMCJ9", // содержимое JSON-файла в кодировке base-64
"Signature": "MIIMtAYJKoZIhvc...KW1oPlA==" // содержимое файла подписи в кодировке base-64
}
}
]
}

Метод вернет в ответе отправленный документ, представленный структурой MessagePatch.

Получение документа для отмены сведений об отгрузке маркированных товаров

Чтобы получить служебный документ для отмены сведений об отгрузке, можно воспользоваться следующими способами:

  • Методы для работы с документами, сообщениями и событиями:

    Информация о документе для отмены сведений об отгрузке будет представлена структурой Entity со следующими полями:

    • EntityType = Attachment,
    • AttachmentType = TtGisFixationCancellationRequest.

    Статус подписания документа для отмены сведений об отгрузке хранится в поле TtGisFixationCancellationStatus структуры Document и принимает значения из перечисления TtGisFixationCancellationStatus.

  • Методы для работы с документооборотом для одно-, двух- и трехтитульных документов:

    Информация о документе для отмены сведений об отгрузке хранится в поле TtGisFixation структуры DocflowV4 в виде структуры TtGisFixationDocflow. Статус подписания хранится в поле CancellationStatus этой структуры.

  • Методы для работы с документооборотом для любых, в том числе многотитульных документов:

    Информация о документе для отмены сведений об отгрузке хранится в поле TtGisFixation структуры DocflowV5 в виде структуры TtGisFixationDocflow. Статус подписания хранится в поле CancellationStatus этой структуры.

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года