PostMessage (V3)
Отправляет сообщение.
POST /V3/PostMessage
Параметры запроса
operationId— идентификатор операции. Необязательный параметр, нерегистрочувствительный. Если вызов с указанным идентификатором операции завершился успехом, то и все последующие вызовы с тем же идентификатором операции также завершатся успехом. Результат всех последующих вызовов будет равен результату первого успешного вызова. По умолчанию в качестве идентификатора операции используется MD5-хэш тела запроса.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Тело запроса
Тело запроса должно содержать отправляемое сообщение, представленное структурой MessageToPost.
Коды ответа
200— операция успешно завершена.204— операция еще не завершена. В HTTP-заголовке ответаRetry-Afterуказано время в секундах, через которое нужно повторить запрос.400— данные в запросе имеют неверный формат, или отсутствуют обязательные параметры, или превышено максимально допустимое количество документов в сообщении.401— в запросе отсутствует HTTP-заголовокAuthorizationили в этом заголовке содержатся некорректные авторизационные данные.402— у указанного ящика закончилась подписка на API.403— доступ к ящику с предоставленным авторизационным токеном запрещен или организация ликвидирована.405— используется неподходящий HTTP-метод.409— осуществляется попытка отправить дубликат сообщения или запрещен прием документов от контрагентов согласно свойствуSociabilityв структуре Organization.415— тип содержимого запроса не поддерживается.429— превышено ограничение на количество запросов в единицу времени. Повторите запрос через время, указанное в HTTP-заголовкеRetry-After.500— при обработке запроса возникла непредвиденная ошибка.
Заголовки ответа
Retry-After— если в ответе содержится HTTP-заголовокRetry-After, то операция с указанным идентификатором еще не завершена или превышено ограничение на количество запросов (код ответа429). В этом случае повторите вызов через указанное в заголовке время (в секундах).
Тело ответа
Тело ответа содержит отправленное сообщение, представленное структурой Message.
В одном сообщении можно отправить не более 40 документов.
Нельзя отправить сообщение, если отправитель или получатель отключен от оператора ЭДО (заполнено поле DisconnectionFromOperatorDate в структуре Organization).
Примеры использования
Отправка документа одному участнику
Пример HTTP-запроса:
POST /V3/PostMessage HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json
Пример тела запроса:
{
"FromBoxId": "{{boxId_sender}}",
"ToBoxId": "{{boxId_recipient}}",
"DocumentAttachments": [
{
"SignedContent": {
"Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0...NC50Ls+", // содержимое XML-файла в кодировке base-64
"Signature": "MIIN5QYJKoZIhvcNAQcCoIIN1jCCDdIA...kA9MJfsplqgW", // содержимое файла подписи в кодировке base-64
"PowerOfAttorney": {
"FullId": {
"RegistrationNumber": "{{registrationNumber}}",
"IssuerInn": "{{issuerInn}}",
"RepresentativeInn": "{{representativeInn}}"
}
}
},
"TypeNamedId": "{{documentTypeName}}",
"Function": "{{function}}",
"Version": "{{version}}"
}
]
}
Пример тела ответа:
{
"MessageId": "a6865acc-050a-432f-9a77-548e32a3c7c8",
"TimestampTicks": 638841169138072584,
"LastPatchTimestampTicks": 638841169141027588,
"FromBoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"FromTitle": "Организация-отправитель",
"ToBoxId": "1f208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
"ToTitle": "Организация-получатель",
"Entities": [
{
"EntityType": "Attachment",
"EntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"AuthorUserId": "",
"ParentEntityId": "",
"Content": {
"Size": 32837
},
"AttachmentType": "Contract",
"FileName": "FileName.png",
"NeedRecipientSignature": true,
"DocumentInfo": {
"MessageId": "a6865acc-050a-432f-9a77-548e32a3c7c8",
"EntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"CreationTimestampTicks": 638841169138072584,
"CounteragentBoxId": "1f208d032a604f6491b1b7aad54cfaf3@diadoc.ru",
"DocumentType": "Contract",
"InitialDocumentIds": [],
"SubordinateDocumentIds": [],
"Content": {
"Size": 32837
},
"FileName": "FileName.png",
"DocumentDate": "29.05.2025",
"DocumentNumber": "23",
"IsDeleted": false,
"DepartmentId": "00000000-0000-0000-0000-000000000000",
"IsTest": false,
"FromDepartmentId": "00000000-0000-0000-0000-000000000000",
"ToDepartmentId": "00000000-0000-0000-0000-000000000000",
"RevocationStatus": "RevocationStatusNone",
"SendTimestampTicks": 638841169138072584,
"DeliveryTimestampTicks": 638841169141027588,
"ForwardDocumentEvents": [],
"ContractMetadata": {
"DocumentStatus": "OutboundWaitingForRecipientSignature",
"ContractPrice": "23",
"ContractType": "",
"ReceiptStatus": "ReceiptStatusNone"
},
"RoamingNotificationStatus": "RoamingNotificationStatusNone",
"HasCustomPrintForm": false,
"CustomData": [],
"DocumentDirection": "Outbound",
"LastModificationTimestampTicks": 638841169141027588,
"IsEncryptedContent": false,
"SenderSignatureStatus": "SenderSignatureCheckedAndValid",
"IsRead": true,
"PacketIsLocked": false,
"ProxySignatureStatus": "ProxySignatureStatusNone",
"TypeNamedId": "Contract",
"Function": "default",
"WorkflowId": 2,
"Title": "Договор №23 от 29.05.25",
"Metadata": [
{
"Key": "FileName",
"Value": "FileName.png"
},
{
"Key": "DocumentNumber",
"Value": "23"
},
{
"Key": "DocumentDate",
"Value": "29.05.2025"
},
{
"Key": "CurrencyCode",
"Value": "643"
},
{
"Key": "ContractPrice",
"Value": "23"
}
],
"RecipientReceiptMetadata": {
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable",
"ConfirmationMetadata": {
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable",
"DateTimeTicks": 0
}
},
"ConfirmationMetadata": {
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable",
"DateTimeTicks": 638841169141027588
},
"RecipientResponseStatus": "WaitingForRecipientSignature",
"AmendmentRequestMetadata": {
"AmendmentFlags": 0,
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable"
},
"EditingSettingId": "",
"LockMode": "None",
"SenderReceiptMetadata": {
"ReceiptStatus": "GeneralReceiptStatusNotAcceptable"
},
"Version": "v1",
"LastOuterDocflows": [],
"DocflowStatus": {
"PrimaryStatus": {
"Severity": "Warning",
"StatusText": "Ожидается подпись контрагента"
},
"PowerOfAttorneyGeneralStatus": {
"Severity": "Warning",
"StatusNamedId": "IsNotAttached",
"StatusText": "Не приложена доверенность",
"Errors": []
}
},
"TtGisFixationCancellationStatus": "TtGisFixationCancellationStatusNone",
"MessageIdGuid": "a6865acc-050a-432f-9a77-548e32a3c7c8",
"EntityIdGuid": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"CreationTimestamp": "2025-05-29T12:01:53.8072584Z"
},
"RawCreationDate": 638841169138072584,
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"Version": "v1",
"ContentTypeId": "contract_01"
},
{
"EntityType": "Attachment",
"EntityId": "adbdf5b1-93b1-4ba6-b72e-e6acbfe6960f",
"AuthorUserId": "",
"ParentEntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"Content": {
"Size": 40
},
"AttachmentType": "AttachmentComment",
"NeedRecipientSignature": false,
"RawCreationDate": 638841169138072584,
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": ""
},
{
"EntityType": "Signature",
"EntityId": "88c3511a-a6de-4d84-b01f-55dc3452d87d",
"AuthorUserId": "9aa516d1-eec7-4e09-b11e-8772d081a4fa",
"ParentEntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"Content": {
"Size": -1
},
"AttachmentType": "Nonformalized",
"NeedRecipientSignature": false,
"SignerBoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"RawCreationDate": 638841169141027588,
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "",
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyRequired",
"Comment": "Документ подписан сертификатом физ. лица без МЧД"
}
},
{
"EntityType": "Attachment",
"EntityId": "269f2463-484e-412d-b769-5e6c2b719162",
"AuthorUserId": "",
"ParentEntityId": "8422e22f-ee03-45b6-b62d-257e99c755d5",
"Content": {
"Size": 5208
},
"AttachmentType": "InvoiceConfirmation",
"FileName": "DP_PDPOL_2BM-6125600340-732644841-202407101103418496883_2BM_20250529_269f2463-484e-412d-b769-5e6c2b719162.xml",
"NeedRecipientSignature": false,
"RawCreationDate": 638841169141027588,
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "send_confirmation_133_01_03"
},
{
"EntityType": "Signature",
"EntityId": "8f77de9f-2ffb-491e-b9ba-4207e0e20ee0",
"AuthorUserId": "",
"ParentEntityId": "269f2463-484e-412d-b769-5e6c2b719162",
"Content": {
"Size": -1
},
"AttachmentType": "Nonformalized",
"NeedRecipientSignature": false,
"SignerBoxId": "00000000000000000000000000000000@diadoc.ru",
"RawCreationDate": 638841169141027588,
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000",
"NeedReceipt": false,
"IsApprovementSignature": false,
"IsEncryptedContent": false,
"Labels": [],
"ContentTypeId": "",
"PowerOfAttorneyAttachmentStatus": {
"StatusName": "PowerOfAttorneyNotRequired"
}
}
],
"IsDraft": false,
"DraftIsLocked": false,
"DraftIsRecycled": false,
"CreatedFromDraftId": "",
"DraftIsTransformedToMessageIdList": [],
"IsDeleted": false,
"IsTest": false,
"IsInternal": false,
"IsProxified": false,
"ProxyBoxId": "",
"ProxyTitle": "",
"PacketIsLocked": false,
"LockMode": "None",
"MessageType": "Letter",
"IsReusable": false
}
Отправка документа нескольким участникам
Пример HTTP-запроса:
POST /V3/PostMessage HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json
Пример тела запроса:
{
"FromBoxId": "{{boxId_sender}}",
"DocumentAttachments": [
{
"SignedContent": {
"Content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0...NC50Ls+", // содержимое XML-файла в кодировке base-64
"Signature": "MIIN5QYJKoZIhvcNAQcCoIIN1jCCDdIA...kA9MJfsplqgW" // содержимое файла подписи в кодировке base-64
},
"NeedRecipientSignature": true,
"TypeNamedId": "Contract",
"Function": "default",
"Version": "multilateral_contract_01_01",
"ParticipantRoles": [
{
"BoxId": "{{boxId_sender}}",
"Role": "default:sender"
},
{
"BoxId": "{{boxId_recipient1}}",
"Role": "default:recipient"
},
{
"BoxId": "{{boxId_recipient2}}",
"DepartmentId": "{{departmentId_recipient2}}",
"Role": "default:recipient"
}
]
}
]
}
Пример тела ответа:
{
"MessageId": "a6865a******************************",
"TimestampTicks": 638841169138072584,
"LastPatchTimestampTicks": 638841169141027588,
"FromBoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"FromTitle": "Организация-отправитель",
"ToBoxId": "",
"ToTitle": "",
"Entities": [
{
"EntityType": "Attachment",
"EntityId": "8422e2******************************",
"ParentEntityId": "",
"AttachmentType": "Contract",
"FileName": "Договор.pdf",
"NeedRecipientSignature": true,
"DocumentInfo": {
"MessageId": "a6865a******************************",
"EntityId": "8422e2******************************",
"DocumentType": "Contract",
"DocumentDate": "29.05.2025",
"DocumentNumber": "23",
"FromDepartmentId": "00000000-0000-0000-0000-000000000000",
"ToDepartmentId": "00000000-0000-0000-0000-000000000000",
"IsDeleted": false,
"IsTest": false,
"TypeNamedId": "Contract",
"Function": "default",
"WorkflowId": 1002,
"Version": "multilateral_contract_01_01",
"Title": "Договор №23 от 29.05.25"
}
},
{
"EntityType": "Signature",
"EntityId": "88c351******************************",
"AuthorUserId": "9aa516******************************",
"ParentEntityId": "8422e2******************************",
"AttachmentType": "Nonformalized",
"SignerBoxId": "09ae254c5cd0408284de7ccb46d86f82@diadoc.ru",
"SignerDepartmentId": "00000000-0000-0000-0000-000000000000"
}
],
"IsDraft": false,
"IsDeleted": false,
"IsTest": false,
"IsInternal": false,
"IsProxified": false,
"ProxyBoxId": "",
"ProxyTitle": "",
"MessageType": "Letter"
}
См. также
Инструкции:
Методы для работы с сообщением:
- CanPostMessage — проверяет возможность отправки сообщения с указанными параметрами
- GetMessage (V6) — возвращает данные сообщения по указанному идентификатору
- PostMessage (V3) — отправляет сообщение
- PostMessagePatch (V4) — отправляет дополнение к сообщению
- TransformTemplateToMessage — создает из шаблона исходящее неотправленное сообщение
Методы для работы с черновиками:
- PostMessage (V3) — отправляет сообщение
- RecycleDraft — удаляет еще не утилизированные черновики
- SendDraft — отправляет сообщение, созданное из черновика