Інтеграція Бітрікс24 з СБІС: автоперевірка контрагентів

Проблема ручної перевірки контрагентів

Менеджер вводить ІПН — решту робить система. Ручна перевірка контрагентів — один з головних пожирачів часу: відкрити сайт СБІС, вбити ІПН, скопіювати дані, вставити в CRM. Помилки дорого коштують: компанія з боргами, виконавчі провадження, афілійовані фірми. Тому автоматизація стає критичною для бізнесу. За даними документації СБІС API, сесійна автентифікація потребує оновлення кожні кілька годин — це ключова технічна складність, яку ми вирішуємо. Економія часу співробітників — до 30 хвилин на одного контрагента, що безпосередньо впливає на рентабельність відділу продажів. Втрати від підписання договору з недобросовісним контрагентом можуть сягати значних збитків, а автоматична перевірка знижує цей ризик на 80%.

Екосистема СБІС та її переваги

СБІС (Тензор) — екосистема сервісів для бізнесу: ЕДО, звітність, телефонія та перевірка контрагентів. Модуль перевірки контрагентів у СБІС конкурує з Контур.Фокус і має свої сильні сторони: глибока аналітика пов'язаних компаній, історія змін у ЄДРПОУ, показники надійності за власним скорингом. Інтеграція будується через REST API СБІС з використанням JSON-RPC 2.0. Інтеграція можлива як для хмарної версії Бітрікс24, так і для коробкової — у кожному випадку ми підбираємо оптимальний стек: вебхуки, REST API або події epilog/template.

Як налаштувати сесійну автентифікацію СБІС у Бітрікс24?

СБІС використовує власний протокол автентифікації. Для отримання токена:

POST https://online.sbis.ru/auth/service/ { "jsonrpc": "2.0", "method": "СБИС.Аутентифицировать", "params": { "Логин": "[email protected]", "Пароль": "hashed_password", "АппКлюч": "app_key_from_cabinet" }, "id": 0 } 

У відповіді — "sid" (session ID). Всі наступні запити передають X-SBISSessionID: {sid} в заголовку. Сесія живе кілька годин, після чого потрібно переавтентифікуватися.

Це відмінність від OAuth2/API-ключів — сесійна автентифікація потребує зберігання активної сесії та її оновлення. Реалізуємо окремий сервіс автентифікації зі зберіганням sid у кеші (Redis/Memcache) з TTL трохи менше реального часу життя сесії.

Ми створюємо PHP-сервіс SbisAuthService, який при старті отримує sid і зберігає його в кеш. При кожному виклику API перевіряємо, чи не закінчився TTL. Якщо так — переавтентифікуємося. Це гарантує, що sid завжди актуальний, і CRM не втрачає зв'язок з СБІС.

Які методи API СБІС потрібні для перевірки контрагентів?

СБІС API використовує JSON-RPC 2.0. Всі методи передаються в полі "method" як рядки російською мовою — це специфіка платформи.

• СБИС.ПрочитатьКонтрагента — основна картка за ІПН/ЄДРПОУ
• СБИС.ОтчётОКомпании — розгорнутий звіт: фінанси, судові справи, ліцензії
• СБИС.НадёжностьКонтрагента — власний скоринг СБІС (числовий показник від 0 до 100)
• СБИС.СписокАффилированных — афілійовані компанії через засновників та директорів

Приклад запиту перевірки за ІПН:

{ "jsonrpc": "2.0", "method": "СБИС.ПрочитатьКонтрагента", "params": { "Контрагент": {"ИНН": "7707083893"} }, "id": 1 } 

Відповідь містить "Название", "КПП", "ОГРН", "Адрес", "Руководитель", "Статус" (Діє/Ліквідована/...).

Інтеграція з CRM Бітрікс24

Схема аналогічна інтеграції з Контур.Фокус, але з урахуванням специфіки СБІС API.

Автозаповнення реквізитів. При введенні ІПН у картку компанії CRM → запит до СБІС API → заповнення полів КПП, ЄДРПОУ, адреси, керівника. У on-premise Бітрікс24 реалізуємо через подію зміни картки компанії. У хмарі — через вебхук і REST API Бітрікс24.

Скоринг надійності. Показник надійності СБІС зберігаємо в користувацьке поле UF_SBIS_SCORE. На основі цього поля налаштовуємо роботів CRM: при значенні нижче 30 — створити задачу «Перевірити контрагента», повідомити керівника.

Оновлення даних. Дані про контрагента змінюються: компанія може змінити директора, отримати виконавче провадження. Налаштовуємо планове оновлення через агент — раз на тиждень для всіх активних контрагентів CRM.

Як налаштувати інтеграцію: покроковий план

1. Отримання доступу до API СБІС: реєструємо додаток в кабінеті СБІС, отримуємо АппКлюч.
2. Розробка сервісу автентифікації: реалізуємо отримання та зберігання sid із кешуванням.
3. Створення користувацьких полів у CRM: додаємо поля UF_SBIS_SCORE, UF_SBIS_STATUS.
4. Налаштування роботів та подій: при введенні ІПН — автозаповнення, при зміні — запит скорингу.
5. Тестування та деплой: перевірка на тестових контрагентах, моніторинг помилок.

Чому СБІС вигідніший за Контур.Фокус для компаній з ЕДО?

Якщо компанія вже використовує СБІС для ЕДО — інтеграція через СБІС логічна: єдиний постачальник, один договір, дані узгоджені. Автозаповнення реквізитів через СБІС працює в 1.5 рази швидше, ніж ручне введення, а скоринг дозволяє відсіювати ненадійних контрагентів на етапі укладання угоди. Економія часу на перевірку одного контрагента — до 30 хвилин, що в масштабах відділу продажів дає суттєву фінансову вигоду — значну економію на відділ з 10 менеджерів.

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

• Проектування схеми інтеграції з урахуванням вашого сценарію використання
• Розробка модуля автентифікації та сервісу виклику API СБІС
• Налаштування користувальницьких полів та роботів CRM для скорингу
• Документація по доступах та підтримці
• Навчання співробітників (2–3 години)

Орієнтовні терміни

Вартість розраховується індивідуально — ми оцінимо ваш проєкт за один день. Інтеграція окупається за 2–3 місяці за рахунок зниження витрат на ручну перевірку контрагентів до 60%. Замовте інтеграцію та отримайте безкоштовну консультацію з налаштування API СБІС. Зв'яжіться з нами — оцінимо ваш проєкт за 1 день.