Інтеграція 1С-Бітрікс і Контур.Фокус: реквізити за ІПН

Інтеграція 1С-Бітрікс з Контур.Фокус

Уявіть: менеджер вводить ІПН в картку CRM, а система мовчить. Доводиться відкривати сайт Контур.Фокус, копіювати реквізити вручну, звіряти ризики — 15 хвилин на одну компанію. З нашою інтеграцією все відбувається за 2 секунди (в 450 разів швидше). Наші інженери, які мають сертифікати 1С-Бітрікс та багаторічний досвід в інтеграціях, реалізують таку зв'язку під ключ: від налаштування API до вбудовування в бізнес-процеси.

Контур.Фокус — сервіс перевірки контрагентів: ЄДРПОУ/ЄДР, арбітражні справи, фінансова звітність, афілійовані особи. Інтеграція з 1С-Бітрікс потрібна там, де менеджер вводить ІПН компанії в картку CRM або при реєстрації юрособи на сайті — і очікує, що система сама підтягне реквізити та дасть сигнал про ризики. Ми пропонуємо готове рішення: ви отримуєте автоматичне заповнення реквізитів, ризик-аналіз та сповіщення — все в вашій звичній системі.

Як влаштовано API Контур.Фокус?

Контур.Фокус надає REST API (Документація API Контур.Фокус). Аутентифікація через 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 з лімітом запитів за тарифом. При великому обсязі CRM (1000+ компаній) і частих оновленнях карток кешування обов'язкове. Перевитрата запитів веде до додаткових витрат, а без кешу швидкість роботи CRM падає.

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

Інтеграція при реєстрації юрособи на сайті

Для 1С-Бітрікс (не Бітрікс24): форма реєстрації юрособи — користувач вводить ІПН, AJAX-запит до ендпоінту сайту, той запитує Контур.Фокус і повертає реквізити для автозаповнення. Після реєстрації зберігаємо статус контрагента та ризик-оцінку у властивостях користувача (b_uts_user).

Що входить в роботу?

Орієнтири за термінами

Вартість розраховується індивідуально після аналізу бізнес-процесів перевірки контрагентів та архітектури CRM. Замовте інтеграцію під ключ з гарантією якості — зв'яжіться з нами для безплатної оцінки.