ИИ для документооборота: документы Диадока, ждущие подписи
Агент соберёт входящие Диадока через API Контура: 23 за ночь, 6 ждут ответа дольше суток. Подписывает человек: КЭП на носителе, в облаке Диадока или в Госключе.
Примеры: Диадок
23 входящих за ночь, 6 из них ждут ответа дольше суток.
Самое старое: УПД от «Северторга» от 14 июля, лежит четвёртый день. Собрал их в один список с контрагентом, типом и датой поступления. Подписывать вам, я только подсвечиваю.
Как агент работает с Диадок
Агент работает с публичным API Диадока по адресу diadoc-api.kontur.ru в границах одного ящика организации. Он читает входящие, исходящие и внутренние документы вместе с вложениями и статусами документооборота, контрагентов и ленту событий ящика. Из этого собираются реестры под сверку с учётной системой, списки документов без ответа и сводка по тому, что пришло за ночь и требует подписи сегодня.
В ЭДО статус документа отражает состояние встречного движения, а не факт закрытой сделки. Отправленное может лежать неподписанным и неотклонённым неделями, а входящее ждать вашего ответа, ничем не напоминая о себе в интерфейсе. Поэтому агент смотрит не на сам факт отправки, а на возраст ожидания: выделяет документы, лежащие дольше суток, и называет контрагента, тип и дату поступления рядом с каждым.
Подпись требует отдельного решения, и агент его не принимает за вас. Метод отправки подпись не создаёт: она приходит извне. Если КЭП лежит на носителе, её ставит человек, и агент доводит документ ровно до этой точки: готовит черновик, собирает пакет, проверяет комплектность и вложения. Если организация подключила облачную подпись Диадока или Госключ, агент может отправить документ на подписание и дождаться результата, но запускает это по вашей команде, а не сам. Принять двусторонний документ значит отправить свой титул получателя, и его агент тоже готовит целиком. Отклонение и аннулирование он выносит на ваше решение со всей фактурой и отправляет уже подписанное.
Видит агент ровно то, что разрешает выданный Контуром доступ, и границу эту обойти не пытается. Ящик не переключается на лету, поэтому на одну организацию нужно одно подключение, а список своих юрлиц и их ящиков агент показывает из ответа GetMyOrganizations. Новое он забирает по ленте событий ящика, а не перебором дней, и помнит, до какого события дочитал, так что вторая сводка за утро не пересчитывает всё заново. Если документов за период нет, он скажет об этом прямо, а не покажет пустой реестр.
Сценарии интеграции
Документы, которые ждут подписи
Агент покажет входящие документы без ответа и выделит те, что лежат дольше суток, с контрагентом, типом и датой поступления.
Что зависло у контрагента
Агент соберёт по контрагенту документы за период и назовёт те, где вторая сторона не подписала и не отклонила отправленное.
Реестр ЭДО для сверки
Агент сведёт входящие и исходящие документы по типам, датам и контрагентам и подготовит реестр под сверку с учётной системой.
Утренняя сводка по документообороту
Агент по расписанию пришлёт, сколько документов пришло за ночь и что требует подписи сегодня, чтобы ничего не повисло.
Пакет к отправке
Агент подготовит черновик и соберёт пакет к отправке: проверит комплектность, вложения и реквизиты контрагента, а затем остановится там, где нужна ваша подпись.
Отказы и аннулирования
Агент дочитает ленту событий ящика и соберёт документы, которые контрагент отклонил или просит аннулировать, с причиной и датой; по вашему решению он сформирует предложение об аннулировании или отказ в подписи и отправит их после подписания.
Как подключить
Перед подключением
- Организация уже работает в Диадоке, и у неё есть ящик
- Одно подключение на организацию: ящик задаётся при подключении
- Сертификат КЭП у того, кто подписывает: носитель, облако Диадока или Госключ
- 1
Оставьте заявку на diadoc.ru/integrations/api
По заявке менеджер Контура откроет вам Кабинет интегратора на integrations.kontur.ru: ключи API не самообслуживаемые.
- 2
Возьмите client_id и client_secret
Оба значения лежат в Кабинете интегратора, client_secret это ключ API вашего приложения. Сам API Диадока пару не принимает: она нужна для выпуска токенов.
- 3
Выпустите refresh_token в Кабинете
Выберите clientMode «AuthorizationCode», отметьте scope openid, offline_access и Diadoc.PublicAPI и нажмите «Получить refresh-токен». Без offline_access его не выдадут.
- 4
Используйте этот refresh_token только здесь
Подключение само меняет токен примерно раз в сутки, и прежний сразу перестаёт работать. Не вставляйте этот же токен в другую программу: там он умрёт после обмена.
- 5
Скопируйте ID ящика из адресной строки
Откройте «Входящие документы» и скопируйте из адресной строки 32 символа между https://diadoc.kontur.ru/ и /Folder/Inbox.
Частые вопросы
Четырьмя значениями из Кабинета интегратора и Диадока: client_id, client_secret, refresh-токеном со scope offline_access и Diadoc.PublicAPI и идентификатором ящика, это 32 символа из адресной строки раздела «Входящие документы». Кабинет интегратора открывает менеджер Контура по заявке. Токен доступа живёт около суток, и подключение само обменивает refresh-токен на новый, так что вводить его заново не нужно.
Входящие, исходящие и внутренние документы подключённого ящика, их вложения и статусы документооборота, контрагентов и ленту событий в пределах прав, выданных приложению в Кабинете интегратора.
Сам по себе метод отправки подпись не создаёт: она приходит готовой. Если КЭП на носителе, подписывает человек, а агент готовит черновик и пакет к отправке. Если у организации подключена облачная подпись Диадока или Госключ, агент может отправить файлы на подписание и дождаться результата, но делает это по вашей команде.
Ящик задаётся при подключении, поэтому на одну организацию нужно одно подключение. Список своих юридических лиц и идентификаторов их ящиков агент покажет из ответа метода GetMyOrganizations.