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

PostMessagePatch (V4)

Отправляет дополнение к сообщению.

POST /V4/PostMessagePatch

Параметры запроса

  • operationId — идентификатор операции. Необязательный параметр, нерегистрочувствительный. Если вызов с указанным идентификатором операции завершился успехом, то и все последующие вызовы с тем же идентификатором операции также завершатся успехом. Результат всех последующих вызовов будет равен результату первого успешного вызова.

Заголовки запроса

Тело запроса

Тело запроса должно содержать отправляемое дополнение к сообщению, представленное структурой MessagePatchToPostV2.

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат, или отсутствуют обязательные параметры, или отправлено предложение об аннулировании перевозочного документа.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 402 — у указанного ящика закончилась подписка на API.
  • 403 — доступ к ящику с предоставленным авторизационным токеном запрещен.
  • 404 — не найдено сообщение или документ с указанными идентификаторами.
  • 405 — используется неподходящий HTTP-метод.
  • 409 — осуществляется попытка отправить дубликат сообщения, или запрещен прием документов от контрагентов согласно свойству Sociability в структуре Organization, или в сутки отправлено больше трех невалидных подписей для одной сущности.
  • 415 — тип содержимого запроса не поддерживается.
  • 429 — превышено ограничение на количество запросов в единицу времени. Повторите запрос через время, указанное в HTTP-заголовке Retry-After.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Заголовки ответа

  • Retry-After — если в ответе содержится HTTP-заголовок Retry-After, то операция с указанным идентификатором еще не завершена или превышено ограничение на количество запросов (код ответа 429). В этом случае повторите вызов через указанное в заголовке время (в секундах).

Тело ответа

Тело ответа содержит отправленное дополнение, представленное структурой MessagePatch.

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

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

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

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

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

{
"BoxId": "{{boxId}}",
"MessageId": "bbcedb0d-ce34-4e0d-b321-3f600c920935",
"RecipientTitles": [
{
"ParentEntityId":"30cf2c07-7297-4d48-bc6f-ca7a80e2cf95&",
"SignedContent":
{
"Content": "PD94bWwgdmVyc2l...LDQudC7Pg==", // содержимое XML-файла в кодировке base-64
"Signature": "MIIN5QYJKoZIhvc...KsTM6zixgz" // содержимое файла подписи в кодировке base-64
}
}
]
}

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

{
"MessageId": "bbcedb0d-ce34-4e0d-b321-3f600c920935",
"TimestampTicks": 639046584722481846,
"Entities": [],
"ForDraft": false,
"DraftIsRecycled": false,
"DraftIsTransformedToMessageIdList": [],
"DraftIsLocked": false,
"MessageIsDeleted": false,
"EntityPatches": [],
"MessageIsRestored": false,
"MessageIsDelivered": false,
"PatchId": "02988e7d-0623-488a-a883-1475e3fb927f",
"MessageType": "Letter"
}

См. также

Инструкции:

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

  • CanPostMessage — проверяет возможность отправки сообщения с указанными параметрами
  • GetMessage (V6) — возвращает данные сообщения по указанному идентификатору
  • PostMessage (V3) — отправляет сообщение
  • PostMessagePatch (V4) — отправляет дополнение к сообщению
  • TransformTemplateToMessage — создает из шаблона исходящее неотправленное сообщение

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

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

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