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

Электронная отчётность — черновики, документообороты, организации, сертификаты

## Сценарии

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

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

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

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

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

### Оставьте заявку на доступ к 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 из того же ответа. Для отправки и подписания отчётности учётной записи нужен действующий сертификат электронной подписи.

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

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

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

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

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

[Открыть Контур.Экстерн](https://kontur.ru/extern/api)