Контур.Диадок API: POST /V3/PostMessage — Отправка сообщения

В ответе: MessageId, Entities, FromBoxId, ToBoxId, MessageType. Поля Invoices, NonformalizedDocuments, Torg12Documents и т. п. устарели — используйте DocumentAttachments.

Документация: https://developer.kontur.ru/doc/diadoc.api/method?type=post&path=%2FV3%2FPostMessage

Параметр	Где	Тип	Обяз.	Описание
operationId	query	string	нет	ID операции для идемпотентности
FromBoxId	body	string	да	Ящик отправителя
ToBoxId	body	string	да	Ящик получателя
DocumentAttachments[].TypeNamedId	body	string	да	Тип документа
DocumentAttachments[].Function	body	string	нет	Функция документа
DocumentAttachments[].Version	body	string	нет	Версия документа
DocumentAttachments[].SignedContent.Content	body	string	да	Содержимое (base64)
DocumentAttachments[].SignedContent.Signature	body	string	нет	Подпись CMS SignedData в DER (base64)
DocumentAttachments[].Metadata	body	array	нет	Метаданные (номер, дата и т. п.)
DocumentAttachments[].NeedRecipientSignature	body	boolean	нет	Нужна подпись получателя
DocumentAttachments[].CustomDocumentId	body	string	нет	ID во внешней системе
DocumentAttachments[].Comment	body	string	нет	Комментарий, до 5000 символов
ToDepartmentId	body	string	нет	Подразделение получателя
IsDraft	body	boolean	нет	Сохранить черновиком
DelaySend	body	boolean	нет	Сохранить без отправки

Базовые URL

• Боевой: https://diadoc-api.kontur.ru
• Тестовый: https://diadoc-api.testkontur.ru

Авторизация

Тип: Другое

Нужны ключ разработчика (выдаётся по заявке на https://www.diadoc.ru/integrations/api) и авторизационный токен пользователя. Оба передаются в заголовке по схеме DiadocAuth:

Токен выдаёт POST /V3/Authenticate: по логину и паролю (type=password, JSON с login и password), по сертификату (type=certificate, ответ расшифровывается закрытым ключом и подтверждается через /V3/AuthenticateConfirm) или по auth.sid (type=sid).

Authorization: DiadocAuth ddauth_api_client_id={{client_id}}, ddauth_token={{auth_token}}

Нюансы

• В методы передавайте BoxIdGuid из GetMyOrganizations (GUID).
• Электронная подпись (CMS SignedData в DER) формируется на стороне клиента; для работы с сертификатами и подписью Контур рекомендует SDK.
• Время в API — тики (100-наносекундные интервалы от 00:00:00 01.01.0001).
• Асинхронные методы (AcquireCounteragent, генерация печатных форм) отвечают 204 или пустым телом с Retry-After.
• operationId защищает от повторной отправки: при успешном вызове с тем же ID все следующие вернут тот же результат.
• Документы с тестовыми ящиками помечаются IsTest и не имеют юридической силы.
• Устаревшие поля сообщения (Invoices, Torg12Documents, UniversalTransferDocumentSellerTitles и др.) заменены универсальными DocumentAttachments и RecipientTitles.

Сценарии с этим методом

• Отправить УПД или другой формализованный документ

---

Если этого недостаточно — официальная документация: https://developer.kontur.ru/doc/diadoc.api/method?type=post&path=%2FV3%2FPostMessage Вся интеграция одним документом: https://mcp-everything.ru/integrations/diadoc.md