Контур.Диадок API: GET /V8/GetNewEvents — Лента событий ящика

Events[]: EventId, Message, Patch, IndexKey; TotalCount.

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

Параметр	Где	Тип	Обяз.	Описание
boxId	query	string	да	Ящик (GUID)
afterIndexKey	query	string	нет	Ключ последнего полученного события
documentDirection	query	array	нет	Inbound, Outbound и др., через запятую
messageType	query	array	нет	Тип сообщения, например Draft
typeNamedId	query	array	нет	Типы документов
counteragentBoxId	query	string	нет	Ящик контрагента
timestampFromTicks	query	string	нет	Начало периода (тики от 01.01.0001)
timestampToTicks	query	string	нет	Конец периода
orderBy	query	string	нет	Ascending (по умолчанию) или Descending
limit	query	integer	нет	Элементов на странице

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