ИИ для документооборота: документы Диадока, ждущие подписи
Подключите Контур.Диадок к ИИ-агенту: входящие и исходящие документы, контрагенты, статусы подписания. Агент покажет, что ждёт подписи и где нет ответа.
Как агент работает с Диадок
Агент работает с публичным API Диадока по адресу diadoc-api.kontur.ru в границах одного ящика организации. Он читает входящие, исходящие и внутренние документы вместе с вложениями и статусами документооборота, контрагентов и ленту событий ящика. Из этого собираются реестры под сверку с учётной системой, списки документов без ответа и сводка по тому, что пришло за ночь и требует подписи сегодня.
В ЭДО статус документа — это состояние встречного движения, а не факт закрытой сделки. Отправленное может лежать неподписанным и неотклонённым неделями, а входящее — ждать вашего ответа, ничем не напоминая о себе в интерфейсе. Поэтому агент смотрит не на сам факт отправки, а на возраст ожидания: выделяет документы, лежащие дольше суток, и называет контрагента, тип и дату поступления рядом с каждым.
Подпись — это отдельное решение, и агент его не принимает за вас. Метод отправки подпись не создаёт: она приходит извне. Если КЭП лежит на носителе, её ставит человек, и агент доводит документ ровно до этой точки — готовит черновик, собирает пакет, проверяет комплектность и вложения. Если организация подключила облачную подпись Диадока или Госключ, агент может отправить документ на подписание и дождаться результата, но запускает это по вашей команде, а не сам. Принять двусторонний документ — значит отправить свой титул получателя, и его агент тоже готовит целиком. Отклонение и аннулирование он выносит на ваше решение со всей фактурой и отправляет уже подписанное.
Видит агент ровно то, что разрешает выданный токен, и границу эту обойти не пытается. Ящик не переключается на лету, поэтому одна организация — одно подключение, а список своих юрлиц и их ящиков агент показывает из ответа GetMyOrganizations. Новое он забирает по ленте событий ящика, а не перебором дней, и помнит, до какого события дочитал, так что вторая сводка за утро не пересчитывает всё заново. Если документов за период нет, он скажет об этом прямо, а не покажет пустой реестр.
Сценарии интеграции
Документы, которые ждут подписи
Агент покажет входящие документы без ответа и выделит те, что лежат дольше суток, с контрагентом, типом и датой поступления.
Что зависло у контрагента
Агент соберёт по контрагенту документы за период и назовёт те, где вторая сторона не подписала и не отклонила отправленное.
Реестр ЭДО для сверки
Агент сведёт входящие и исходящие документы по типам, датам и контрагентам и подготовит реестр под сверку с учётной системой.
Утренняя сводка по документообороту
Агент по расписанию пришлёт, сколько документов пришло за ночь и что требует подписи сегодня, чтобы ничего не повисло.
Пакет к отправке
Агент подготовит черновик и соберёт пакет к отправке: проверит комплектность, вложения и реквизиты контрагента — и остановится там, где нужна ваша подпись.
Отказы и аннулирования
Агент дочитает ленту событий ящика и соберёт документы, которые контрагент отклонил или просит аннулировать, с причиной и датой; по вашему решению он сформирует предложение об аннулировании или отказ в подписи и отправит их после подписания.
Примеры: Диадок
23 входящих за ночь, 6 из них ждут ответа дольше суток.
Самое старое — УПД от «Северторга» от 14 июля, лежит четвёртый день. Собрал их в один список с контрагентом, типом и датой поступления — подписывать вам, я только подсвечиваю.
Ассистент может ошибаться — проверяйте его работу
Из 214 исходящих за квартал 19 висят без ответа второй стороны.
- Дольше 30 дней лежат 7 документов, самый старый — УПД «Северторгу» от 12 мая
- Ещё 12 ждут от 14 до 30 дней, половина из них — по одному контрагенту
Смотрел один ящик организации: у второго ЮЛ свой boxId, его обхожу отдельным запросом. Ни напомнить, ни аннулировать сам не буду — предложение об аннулировании уходит только после вашей подписи.
Ассистент может ошибаться — проверяйте его работу
Как подключить
Перед подключением
- Организация уже работает в Диадоке, и у неё есть ящик
- Одно подключение на организацию: ящик задаётся при подключении
- Сертификат КЭП у того, кто подписывает: носитель, облако Диадока или Госключ
- 1
Оставьте заявку на интеграцию с API Диадока
Заявка — на diadoc.ru/integrations/api. Менеджер Контура откроет Кабинет интегратора и выдаст client_id: ключи не самообслуживаемые.
- 2
Выпустите client_secret в кабинете
В Кабинете интегратора выпустите client_secret к своему client_id. Пара нужна только для получения токена — сам API её не принимает.
- 3
Получите access_token по OpenID Connect
Обменяйте client_id и client_secret на токен со scope «openid profile email offline_access Diadoc.PublicAPI»: без него боевой API откажет.
- 4
Скопируйте идентификатор ящика
Откройте «Входящие документы» и скопируйте из адресной строки 32 символа между https://diadoc.kontur.ru/ и /Folder/Inbox.
Частые вопросы
Двумя значениями: токеном доступа и идентификатором ящика. Токен получают по OpenID Connect со scope Diadoc.PublicAPI, а идентификатор ящика — это 32 символа из адресной строки раздела «Входящие документы». Ключи выдаёт менеджер Контура по заявке.
Входящие, исходящие и внутренние документы подключённого ящика, их вложения и статусы документооборота, контрагентов и ленту событий — в пределах прав выданного токена.
Сам по себе метод отправки подпись не создаёт: она приходит готовой. Если КЭП на носителе, подписывает человек, а агент готовит черновик и пакет к отправке. Если у организации подключена облачная подпись Диадока или Госключ, агент может отправить файлы на подписание и дождаться результата — но делает это по вашей команде.
Ящик задаётся при подключении, поэтому одна организация — одно подключение. Список своих юридических лиц и идентификаторов их ящиков агент покажет из ответа метода GetMyOrganizations.