Интеграция 1С-Битрикс с Контур.Фокус

Интеграция 1С-Битрикс с Контур.Фокус

Контур.Фокус — сервис проверки контрагентов: ЕГРЮЛ/ЕГРИП, арбитражные дела, финансовая отчётность, аффилированные лица. Интеграция с 1С-Битрикс нужна там, где менеджер вводит ИНН компании в карточку CRM или при регистрации юрлица на сайте — и ожидает, что система сама подтянет реквизиты и даст сигнал о рисках.

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

Контур.Фокус предоставляет REST API. Документация: https://api.focus.kontur.ru/. Аутентификация через API-ключ в параметре запроса ?key={api_key}.

Основные методы:

• GET /api/req?req={inn_or_ogrn}&key={key} — поиск по ИНН/ОГРН, возвращает базовые реквизиты
• GET /api/brief?inn={inn}&key={key} — краткая карточка организации: статус, ОПФ, адрес, руководитель
• GET /api/financials?inn={inn}&key={key} — финансовые показатели (выручка, прибыль за последние годы)
• GET /api/risks?inn={inn}&key={key} — сводный риск-профиль: негативные признаки, санкционные списки

Ответ — JSON. Поле status содержит ACTIVE (действующая), LIQUIDATING (ликвидируется), LIQUIDATED (ликвидирована), BANKRUPT. Для CRM-интеграции это ключевое поле: сделка с ликвидирующейся компанией требует особого внимания.

Интеграция с CRM Битрикс24: автозаполнение реквизитов

Самый распространённый сценарий: менеджер вводит ИНН в карточку компании CRM → система запрашивает Контур.Фокус → автоматически заполняет КПП, ОГРН, юридический адрес, ФИО руководителя.

Реализуется через обработчик события CRM::ON_BEFORE_COMPANY_UPDATE (on-premise Битрикс24) или через вебхуки в облачном Битрикс24. При изменении поля ИНН запускаем запрос к Контур.Фокус и подставляем данные в поля карточки.

В облачном Битрикс24 через REST API:

// Хук на изменение компании через BX24.callMethod
BX24.callMethod('event.bind', {
    event: 'ONCRMUPDATECOMPANY',
    handler: 'https://your-app.ru/focus-handler/'
});

На стороне обработчика: получаем ИНН из поля UF_INN или стандартного реквизита, делаем запрос к Фокусу, обновляем карточку компании через crm.company.update.

Риск-проверка и уведомления

Второй сценарий: проверка контрагента перед сделкой. Подключаем триггер в бизнес-процессе Битрикс24 — при переходе сделки в стадию «Договор» автоматически запрашиваем риск-профиль из Контур.Фокус.

Если risks.negative_factors содержит критичные признаки (массовый адрес, дисквалифицированный руководитель, исполнительные производства на крупную сумму) — сделка получает метку «требует проверки» и создаётся задача для службы безопасности.

Это настраивается через роботов CRM (Битрикс24 облако) или через бизнес-процессы (on-premise). Условие: «если поле UF_FOCUS_RISK > порогового значения → создать задачу → уведомить руководителя».

Кэширование запросов к API

Контур.Фокус — платный API с лимитом запросов по тарифу. При большом объёме CRM (1000+ компаний) и частых обновлениях карточек кэширование обязательно.

Кэшируем результаты запросов в Redis или в таблице Битрикс (\Bitrix\Main\Data\Cache). TTL кэша: 24 часа для базовых реквизитов, 1 час для статуса (статус может измениться быстро при ликвидации). Для принудительного обновления — кнопка в карточке CRM «Обновить данные из Фокус».

Интеграция при регистрации юрлица на сайте

Для 1С-Битрикс (не Битрикс24): форма регистрации юрлица — пользователь вводит ИНН, AJAX-запрос к эндпоинту сайта, тот запрашивает Контур.Фокус и возвращает реквизиты для автозаполнения. После регистрации сохраняем статус контрагента и риск-оценку в свойствах пользователя (b_uts_user).

Ориентиры по срокам

Стоимость рассчитывается индивидуально после анализа бизнес-процессов проверки контрагентов и архитектуры CRM.