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