Контур.Диадок
Подключите Контур.Диадок к ИИ-агенту: входящие и исходящие документы, контрагенты, статусы подписания
Подключите Контур.Диадок к ИИ-агенту: входящие и исходящие документы, контрагенты, статусы подписания. Агент покажет, что ждёт подписи и где нет ответа.
Документация23 входящих за ночь, 6 из них ждут ответа дольше суток.
Самое старое — УПД от «Северторга» от 14 июля, лежит четвёртый день. Собрал их в один список с контрагентом, типом и датой поступления — подписывать вам, я только подсвечиваю.
Сценарии интеграции
Документы, которые ждут подписи
Агент покажет входящие документы без ответа и выделит те, что лежат дольше суток, с контрагентом, типом и датой поступления.
Что зависло у контрагента
Агент соберёт по контрагенту документы за период и назовёт те, где вторая сторона не подписала и не отклонила отправленное.
Реестр ЭДО для сверки
Агент сведёт входящие и исходящие документы по типам, датам и контрагентам и подготовит реестр под сверку с учётной системой.
Утренняя сводка по документообороту
Агент по расписанию пришлёт, сколько документов пришло за ночь и что требует подписи сегодня, чтобы ничего не повисло.
Как подключить
Оставьте заявку на интеграцию с API Диадока
На diadoc.ru/integrations/api оставьте заявку: менеджер Контура свяжется, откроет Кабинет интегратора и выдаст client_id приложения. Ключи не самообслуживаемые — без заявки их не выпускают.
Выпустите client_secret в Кабинете интегратора
В Кабинете интегратора, доступ к которому дал менеджер, выпустите client_secret к своему client_id. Пара нужна только для получения токена — сам API её не принимает.
Получите access_token по OpenID Connect
Обменяйте client_id и client_secret на токен со scope «openid profile email offline_access Diadoc.PublicAPI»: без Diadoc.PublicAPI боевой API откажет, а старый ключ ddauth_api_client_id новым интеграциям не выдают.
Скопируйте идентификатор ящика организации
Откройте в Диадоке раздел «Входящие документы» и скопируйте из адресной строки 32 символа между https://diadoc.kontur.ru/ и /Folder/Inbox. В API тот же ящик выглядит как 32 символа плюс @diadoc.ru.
Что агент сделает в первые 10 минут
- Покажет входящие документы, которые ждут подписи, и выделит те, что лежат без ответа дольше суток
- Соберёт по контрагенту все документы за период и скажет, по каким вторая сторона так и не ответила
- Будет присылать утреннюю сводку: сколько документов пришло за ночь и что требует подписи сегодня
Частые вопросы
Как подключить Контур.Диадок?
Двумя значениями: токеном доступа и идентификатором ящика. Токен получают по OpenID Connect со scope Diadoc.PublicAPI, а идентификатор ящика — это 32 символа из адресной строки раздела «Входящие документы». Ключи выдаёт менеджер Контура по заявке.
Что агент видит в Диадоке?
Входящие, исходящие и внутренние документы подключённого ящика, их вложения и статусы документооборота, контрагентов и ленту событий — в пределах прав выданного токена.
Может ли агент подписать документ за меня?
Нет. API Диадока не формирует подпись — КЭП создаётся на вашей стороне. Агент может подготовить черновик и собрать пакет к отправке, но подписание остаётся за человеком с сертификатом.
Что делать, если организаций несколько?
Ящик задаётся при подключении, поэтому одна организация — одно подключение. Список своих юридических лиц и идентификаторов их ящиков агент покажет из ответа метода GetMyOrganizations.