Контур.Фокус

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

Назначение

Фокус полезен для проверки реквизитов контрагента, выписки ЕГРЮЛ или ЕГРИП, анализа банкротств, арбитража, ФССП и финансовых признаков, а также для поиска аффилированных компаний.

Подключение

1. Получите ключ доступа Фокус.API по договору вашей организации. Он доступен в кабинете разработчика Контура.
2. Откройте Контур.Фокус → Настройки.
3. Вставьте ключ и нажмите Подключить.

Promto проверяет ключ бесплатным запросом /api3/stat и одновременно получает остатки лимитов по методам. Подключать и отключать ключ может только владелец рабочего стола.

Ключ хранится на сервере Promto. Фокус передаёт его как query-параметр, поэтому прокси дополнительно удаляет значение key из ошибок и журналов. Агент и браузер после подключения видят только маску.

Интерфейс и данные

На главной странице находятся сценарии:

• Проверить контрагента;
• Риски и аналитика;
• Связи и бенефициары;
• Подключить Контур.Фокус.

В настройках показаны маска ключа, состояние подключения, статистика расхода по каждому методу, тип лимита и переключатель доступа агента. Для лимитов типа LegalEntities учитываются уникальные ОГРН, а для Persons — уникальные ИННФЛ: повторная проверка того же идентификатора может не расходовать новую единицу.

Возможности агента

Инструмент — promto_focus. Основные действия:

• get_requisites — реквизиты;
• get_egr_details — подробности ЕГРЮЛ или ЕГРИП;
• get_brief_report — краткий отчёт в JSON;
• get_analytics — аналитика legal, bankruptcy, court, finance, fssp, link или purchases;
• get_licences — лицензии;
• get_beneficial_owners — бенефициары;
• get_affiliates — связи организаций;
• check_person — связи и банкротство физического лица по ИННФЛ;
• search и suggest — поиск и подсказки;
• list_monitoring, get_monitoring_changes — список наблюдения и изменения;
• get_stat — актуальная статистика лимитов.

В один запрос можно передать до 100 ИНН или ОГРН через запятую. Фокус возвращает массив только найденных записей, поэтому агент отдельно сопоставляет результат с исходным списком и перечисляет идентификаторы без ответа.

Сценарии

Проверка списка контрагентов

Через promto_focus вызови get_requisites и get_egr_details по этим ИНН: <список до 100>. Сопоставь ответы с исходным списком и отдельно назови ИНН, для которых данных нет.

Факты риска

Через promto_focus собери get_analytics с kind=bankruptcy, court, fssp и finance. Каждый маркер объясни только вместе с фактом-источником и датой, без итогового вердикта одним словом.

Ограничения и подтверждения

• Единственная изменяемая область Фокуса — список наблюдения.
• add_to_monitoring и remove_from_monitoring требуют явного согласия и confirm=true, потому что состав наблюдения влияет на оплачиваемую услугу.
• PDF и XML через этот JSON-прокси не передаются. Запрос выписки PDF и briefReport?pdf=true вернёт понятную ошибку; используйте JSON или откройте файл в интерфейсе Фокуса.
• Ответ ограничен 512 КБ.
• Promto ограничивает параллельность, чтобы не занять весь лимит ключа.

Если что-то не работает

• 403. Фокус не различает неверный ключ, истёкший ключ, отсутствие метода в тарифе и исчерпанную дневную квоту. Вызовите get_stat и не пытайтесь угадать причину по одному статусу.
• 429. Превышен лимит одновременных запросов. Подождите завершения текущих проверок и повторите.
• По одному ИНН нет элемента. Это не ошибка всего пакета: Фокус просто не вернул запись. Покажите такой ИНН отдельно.
• Нужен поиск, но путь /api3/search не работает. Используйте действие search; сервер сам направит его на фактический /api2/search.
• Не обновилась статистика. Вызовите get_stat или обновите состояние приложения.

Связанные материалы

• Интеграции
• Агенты
• Настройки Promto