Контур.Экстерн

ИИ для налоговой: держите сроки ответа по всем организациям

Подключите Контур.Экстерн к ИИ-агенту: организации, черновики отчётов, документообороты, сертификаты. Агент отследит сроки ответа и статусы сданной отчётности.

Как агент работает с Контур.Экстерн

Агент ходит в API Экстерна сразу по всем организациям учётной записи: читает черновики отчётов и вложенные в них документы, документообороты с налоговой и фондами вместе с ответными квитанциями и список сертификатов подписантов. Из этого он строит картину, которой в кабинете нет одним экраном: где срок ответа контролирующему органу истекает первым, какие отчёты приняты, какие отклонены и какие черновики не ушли к отчётной дате.

В электронной отчётности отправка — не событие, а цепочка: отчёт уходит, потом приходит подтверждение оператора, потом квитанция о приёме или отказ, и между шагами проходят часы. Поэтому отправленный отчёт ещё не сданный, и агент различает эти состояния, а причины отказов собирает в один список, а не оставляет каждую внутри своего документооборота. Истекающий сертификат подписанта он показывает заранее, до того как на нём встанет отправка.

Отправить отчёт за вас агент не берётся: сдача идёт цепочкой асинхронных задач и требует подписи КЭП, которую Экстерн сам не создаёт. Агент проверяет комплектность черновика, сверяет организацию и форму, поднимает найденные ошибки и останавливается перед подписанием — дальше действует человек с сертификатом. Пройти сценарий целиком, ничего не сдав, можно на отдельной песочнице testkontur.ru с тестовым сертификатом.

Каждый запрос агент подписывает двумя ключами сразу — коротким токеном и постоянным api-key, — и когда час жизни токена истекает, обновляет его сам, не прерывая разбор. Видит он ровно те организации, которые открыты учётной записи, и по каждой ходит отдельно: сводка по группе компаний складывается из нескольких обходов и занимает больше времени, чем вопрос про одно юрлицо. Если по организации за период ничего нет, агент скажет об этом прямо, а не покажет пустую таблицу.

Сценарии интеграции

Сроки ответа контролирующим органам

Агент соберёт документообороты по всем организациям учётной записи и покажет, где срок ответа налоговой или фонду истекает первым.

Статусы сданной отчётности

Агент покажет по каждому отправленному отчёту, принят он, отклонён или ждёт квитанции, и соберёт причины отказов в один список.

Истекающие сертификаты подписи

Агент найдёт организации, у которых сертификат подписанта истекает в ближайший месяц, — раньше, чем на нём встанет отправка.

Черновики, которые не отправлены

Агент сведёт черновики отчётов по организациям и формам и покажет, какие остались неотправленными к отчётной дате.

Черновик перед подписью

Агент проверит комплектность черновика и вложенных документов, сверит организацию и форму, поднимет найденные ошибки и остановится перед подписанием.

Репетиция на песочнице

Агент пройдёт весь путь отчёта на тестовой площадке testkontur.ru с тестовым сертификатом — ничего не сдавая в налоговую и не трогая боевые данные.

Примеры: Контур.Экстерн

Контур.Экстерн
Реальные диалоги — выберите вопрос
Все отчёты приняли?

По 11 организациям принято 34 отчёта, 2 отклонены, 3 ждут квитанцию.

  • Оба отказа — расхождение ИНН подписанта с сертификатом
  • По «Гранд-Логистике» требование ФНС: срок ответа истекает через 2 дня

Показать черновики, которые так и не ушли?

Отчётность по 11 организациям

СтатусОтчётовПричина
Принято34Квитанции о приёме получены
Отклонено2Расхождение ИНН подписанта с сертификатом
Ждут квитанцию3Ответ приёмного комплекса ещё не пришёл
Ответить...

Ассистент может ошибаться — проверяйте его работу

Как подключить

Перед подключением

  • Договор с Контуром — без него боевая площадка закрыта
  • Учётная запись Контура с доступом к нужным организациям
  • Действующий сертификат электронной подписи у подписанта
  1. 1

    Оставьте заявку на доступ к API

    Форма «Отправить заявку» на kontur.ru/extern/api — менеджер пришлёт письмо с client_id и ссылкой на выпуск ключа.

  2. 2

    Выпустите api-key по ссылке из письма

    Ссылка ведёт на integrations.kontur.ru — нажмите «Выпустить ключ». Значение выглядит как GUID: 8-4-4-4-12 шестнадцатеричных символов через дефисы.

  3. 3

    Получите Access Token на identity.kontur.ru

    Токен выдаёт OpenID-провайдер Контура: scope «openid extern.api», client_id из письма, client_secret — это ваш api-key.

  4. 4

    Проверьте срок токена и сертификат

    Access Token живёт 3600 секунд — копируйте сразу и сохраните refresh_token из того же ответа. Для отправки отчётности нужен действующий сертификат подписи.

Частые вопросы

Двумя ключами: токеном доступа со scope extern.api, который выдаёт OpenID-провайдер Контура, и api-key вида GUID из кабинета интеграций. И то и другое открывает менеджер по заявке на сайте Экстерна — самостоятельно ключи не выпускаются.

Организации учётной записи, черновики отчётов и вложенные в них документы, документообороты с контролирующими органами и ответные квитанции, а также список сертификатов — в пределах прав учётной записи.

Отправка идёт цепочкой асинхронных задач и требует подписи КЭП, которую Экстерн не создаёт сам. Агент проверяет и собирает данные, а подписание и отправку оставляет человеку с сертификатом.

Да, у подключения предусмотрен отдельный адрес песочницы на testkontur.ru с собственной учётной записью и тестовым сертификатом. Боевая площадка открывается по договору с Контуром.

Требование агент найдёт среди документооборотов, покажет срок ответа и соберёт по нему картину: что запрошено, какие документы уже есть в базе, чего не хватает. Подписание КЭП и саму отправку он не делает — это остаётся человеку с сертификатом.

Похожие интеграции

Подключение
По API-ключу
Документация
Контур.Экстерн

Подключите Контур.Экстерн

Зарегистрируйтесь — подключение занимает пару минут, данные остаются в ваших системах.

Попробовать бесплатно