Контур.Экстерн
Подключите Контур.Экстерн к ИИ-агенту: организации, черновики отчётов, документообороты, сертификаты
Подключите Контур.Экстерн к ИИ-агенту: организации, черновики отчётов, документообороты, сертификаты. Агент отследит сроки ответа и статусы сданной отчётности.
ДокументацияПо 11 организациям принято 34 отчёта, 2 отклонены, 3 ждут квитанцию.
- Оба отказа — расхождение ИНН подписанта с сертификатом
- По «Гранд-Логистике» требование ФНС: срок ответа истекает через 2 дня
Показать черновики, которые так и не ушли?
Сценарии интеграции
Сроки ответа контролирующим органам
Агент соберёт документообороты по всем организациям учётной записи и покажет, где срок ответа налоговой или фонду истекает первым.
Статусы сданной отчётности
Агент покажет по каждому отправленному отчёту, принят он, отклонён или ждёт квитанции, и соберёт причины отказов в один список.
Истекающие сертификаты подписи
Агент найдёт организации, у которых сертификат подписанта истекает в ближайший месяц, — раньше, чем на нём встанет отправка.
Черновики, которые не отправлены
Агент сведёт черновики отчётов по организациям и формам и покажет, какие остались неотправленными к отчётной дате.
Как подключить
Оставьте заявку на доступ к API Экстерна
Форма «Отправить заявку» на kontur.ru/extern/api. Менеджер пришлёт письмо с client_id и ссылкой на выпуск ключа. Боевая площадка — только по договору с Контуром; для знакомства дают тестовую с отдельной учёткой и сертификатом.
Выпустите api-key по ссылке из письма
Ссылка ведёт на integrations.kontur.ru — нажмите «Выпустить ключ». Значение выглядит как GUID: 8-4-4-4-12 шестнадцатеричных символов через дефисы. Для боевой площадки там же создаётся самостоятельная интеграция.
Получите Access Token на identity.kontur.ru
Токен выдаёт не Экстерн, а OpenID-провайдер Контура: scope «openid extern.api», client_id из письма, client_secret — это и есть ваш api-key. Вход под учётной записью Контура, у которой есть доступ к нужным организациям.
Проверьте срок токена и сертификат подписи
Access Token живёт 3600 секунд (час) — копируйте его сразу и держите под рукой refresh_token из того же ответа. Для отправки и подписания отчётности учётной записи нужен действующий сертификат электронной подписи.
Что агент сделает в первые 10 минут
- Соберёт документообороты по всем вашим организациям и покажет, где срок ответа контролирующему органу истекает первым
- Найдёт организации, у которых сертификат подписи истекает в ближайший месяц, — раньше, чем на нём встанет отправка отчёта
- Будет присылать утреннюю сводку: какие черновики ждут отправки, что принято, а что отклонено и требует правки
Частые вопросы
Как подключить Контур.Экстерн?
Двумя ключами: токеном доступа со scope extern.api, который выдаёт OpenID-провайдер Контура, и api-key вида GUID из кабинета интеграций. И то и другое открывает менеджер по заявке на сайте Экстерна — самостоятельно ключи не выпускаются.
Что агент видит в Экстерне?
Организации учётной записи, черновики отчётов и вложенные в них документы, документообороты с контролирующими органами и ответные квитанции, а также список сертификатов — в пределах прав учётной записи.
Может ли агент отправить отчёт?
Отправка идёт цепочкой асинхронных задач и требует подписи КЭП, которую Экстерн не создаёт сам. Агент проверяет и собирает данные, а подписание и отправку оставляет человеку с сертификатом.
Есть ли тестовая площадка?
Да, у подключения предусмотрен отдельный адрес песочницы на testkontur.ru с собственной учётной записью и тестовым сертификатом. Боевая площадка открывается по договору с Контуром.