Контур.Диадок API: GET /V3/GetDocuments — Список документов

Без содержимого. Documents[]: MessageId, EntityId, TypeNamedId, Title, DocumentDirection, CounteragentBoxId, Metadata, DocflowStatus, IndexKey; HasMoreResults.

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

Параметр	Где	Тип	Обяз.	Описание
boxId	query	string	да	Ящик (GUID)
filterCategory	query	string	да	Категория фильтра (тип и статус документа, см. документацию метода)
counteragentBoxId	query	string	нет	Ящик контрагента
documentNumber	query	string	нет	Номер первичного документа
fromDocumentDate	query	string	нет	Дата документа с, ДД.ММ.ГГГГ
toDocumentDate	query	string	нет	Дата документа по
timestampFromTicks	query	integer	нет	Начало периода (тики)
timestampToTicks	query	integer	нет	Конец периода
afterIndexKey	query	string	нет	Ключ следующей страницы
sortDirection	query	string	нет	Ascending или Descending
count	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=%2FV3%2FGetDocuments Вся интеграция одним документом: https://mcp-everything.ru/integrations/diadoc.md