Контур.Диадок API: POST /V3/AcquireCounteragent — Приглашение контрагента

Асинхронный: возвращает TaskId, результат — в /V2/AcquireCounteragentResult.

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

Параметр	Где	Тип	Обяз.	Описание
myBoxId	query	string	да	Ящик, от имени которого приглашаем
myDepartmentId	query	string	нет	Подразделение
OrgId	body	string	нет	ID организации контрагента
Inn	body	string	нет	ИНН контрагента
BoxId	body	string	нет	Ящик контрагента
MessageToCounteragent	body	string	нет	Сообщение, до 2000 символов
InvitationDocument	body	object	нет	Файл приглашения (FileName, SignedContent, SignatureRequested)

Базовые 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%2FAcquireCounteragent Вся интеграция одним документом: https://mcp-everything.ru/integrations/diadoc.md