Інтеграція 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.