Скилл Контур.Диадок в Aizor: как подключить ЭДО и автоматизировать документы

Что даёт скилл Контур.Диадок в Aizor

По описанию Aizor, скилл даёт электронный документооборот через API Контур.Диадок: отправка, получение и поиск документов, работа с контрагентами, лента событий.

В документации API перечислены возможности, на которых строятся такие задачи: обмен договорами, актами и счетами, формализованными документами (счета-фактуры, УПД, накладные), получение статусов, поиск документов по параметрам, ответные документы и управление списком контрагентов. Скилл полезен тем, у кого много входящих и исходящих документов и кто устал проверять их вручную.

Что понадобится

• Организация, подключённая к Диадоку, и аккаунт сотрудника с нужными правами.
• Заявка на странице интеграции Диадока: после неё свяжется менеджер, даст доступ в Кабинет интегратора и выдаст идентификатор приложения client_id.
• Для подписания документов нужна электронная подпись. API Диадока не создаёт файл подписи, его нужно сформировать отдельно.
• Приложение Aizor и скилл из каталога.

Совет документации: используйте сервисную учётную запись, а не личную запись сотрудника. Токен отражает права того, кто подтвердил доступ, и интеграция сломается, если он уйдёт из компании. Права зависят от задачи: отправка документов требует права создавать и редактировать, подписание права подписи, административные методы прав администратора.

Как получить ключ API: по шагам

1. Оставьте заявку на странице интеграции Диадока. Менеджер выдаст доступ в Кабинет интегратора и client_id.
2. В Кабинете интегратора откройте раздел «API-ключи» и нажмите «+ Выпустить ключ». Это секретный ключ client_secret, сохраните его и никому не передавайте.
3. В разделе «Способ получения токенов (clientMode)» выберите значение «AuthorizationCode».
4. В разделе «Выпуск токенов» выберите нужные скоупы и нажмите «Получить refresh-токен». Если выпускаете токен впервые, подтвердите сообщение и подождите 2 до 5 минут.
5. Выберите учётную запись, от имени которой будет работать агент. Для технической записи нажмите «Скопировать ссылку» и откройте её в браузере без прежней авторизации (например, в режиме инкогнито).
6. Подтвердите доступы, введите API-ключ и получите refresh-токен. Сохраните его.

Сроки. Refresh-токен живёт 30 дней, и счётчик обновляется при каждом использовании. Токен доступа обычно живёт 24 часа, его обновляют по refresh-токену. Если токен не использовали больше срока жизни, доступ придётся выдавать заново.

В Aizor установите скилл из каталога и вставьте данные в его настройки. Какие именно поля он запросит, показано в самом скилле. Остальные инструкции: все скиллы Aizor.

Проверка: первые запросы агенту

• «Покажи, для каких организаций у меня доступен ящик в Диадоке.»
• «Покажи список моих контрагентов.»
• «Найди входящие документы за последние три дня и назови статусы.»
• «Что нового в ленте событий по документам?»

Сначала пробуйте на тестовой площадке. В документации она подключается отдельным скоупом, а в быстром старте описана отправка документа из тестового ящика в тестовый. Идентификаторы ящиков на главной и тестовой площадке разные.

Сценарии автоматизации

Дайджест входящих документов

Агент по расписанию проверяет входящие документы и присылает в Telegram список: от кого, какой документ, в каком статусе. Планировщик есть в Aizor, подробности на странице «Что такое Aizor».

Поиск документа по запросу

Вы пишете: «найди все акты от такого-то контрагента за квартал». Агент ищет по параметрам и отвечает списком.

Отслеживание статусов

Агент следит за лентой событий и сообщает, когда контрагент подписал или отклонил документ. По расписанию.

Отправка документов

Агент может отправить документ контрагенту. Подписание требует электронной подписи и права подписи у сотрудника, поэтому отправку и подписание оставьте под ручным подтверждением.

Частые ошибки

Что видите	Причина	Что делать
Ошибка 401	Нет заголовка Authorization, в нём нет токена, либо токен повреждён или просрочен	Обновите токен доступа по refresh-токену
Ошибка 403 при обращении к ящику	Ящик недоступен пользователю, либо токен и ящик относятся к разным площадкам	Используйте идентификаторы ящика той площадки, на которой работаете
403 «У вас нет права подписи в организации»	У пользователя недостаточно прав	Выдайте права сотруднику в настройках Диадока
Ошибка 400 или 401 на /connect/authorize	В приложении не указан адрес перенаправления или запрос ушёл не на identity.kontur.ru	Заполните адрес перенаправления в Кабинете интегратора
Автообновление токена перестало работать	Не указан offline_access, не сохранён новый refresh-токен или токен не использовали больше 30 дней	Получите refresh-токен заново

Безопасность

• Не передавайте client_secret и refresh-токен третьим лицам. Храните их только в настройках скилла.
• Делайте токен для сервисной учётной записи с минимальными правами. Права администратора нужны только для административных методов.
• Подписание, отправку и аннулирование документов оставьте под ручным подтверждением в Aizor.
• Refresh-токен действует, пока вы не отзовёте его в Кабинете интегратора. Если он мог попасть в чужие руки, отзовите его там и выпустите новый.
• Сначала проверяйте сценарии на тестовой площадке.

Инструкция написана по официальной документации Контур.Диадок (developer.kontur.ru, раздел «Диадок API»), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.