Интеграция 1С-Битрикс с сервисами проверки контрагентов

Интеграция 1С-Битрикс с сервисами проверки контрагентов

B2B-магазин или корпоративный портал на Битрикс получает заявку от компании — и менеджер тратит 15 минут на ручную проверку ИНН через сторонние сайты. Автоматическая проверка контрагента встраивается в момент регистрации организации, оформления заказа или создания сделки в CRM, и данные из ЕГРЮЛ/реестра дисквалифицированных лиц появляются прямо в карточке.

Источники данных и API

Основные сервисы, с которыми интегрируется Битрикс:

Dadata — наиболее распространённый выбор для автодополнения реквизитов при вводе: по ИНН возвращает полное наименование, КПП, ОГРН, юридический адрес, статус. Контур.Фокус или СПАРК подключают при необходимости глубокого финансового анализа.

Архитектура интеграции

Интеграция работает в двух режимах:

Режим 1 — онлайн-проверка при вводе ИНН. Клиент вводит ИНН в форму регистрации или профиля организации. AJAX-запрос уходит на промежуточный PHP-контроллер, тот запрашивает API Dadata, возвращает реквизиты на фронт. Пользователь видит заполненную форму автоматически.

Режим 2 — фоновая проверка существующих контрагентов. Агент Битрикс (CAgent) запускается ночью, перебирает компании из b_highload_block_entity (HL-блок «Организации») или из таблицы пользователей, отправляет ИНН в API, сохраняет результат.

Хранение данных контрагентов

Для хранения реквизитов организаций — HL-блок CompanyRequisites:

• UF_INN — ИНН (строка, уникальный индекс)
• UF_OGRN — ОГРН
• UF_KPP — КПП
• UF_FULL_NAME — полное наименование
• UF_ADDRESS_LEGAL — юридический адрес
• UF_DIRECTOR — руководитель
• UF_STATUS — статус (active, liquidated, reorganizing)
• UF_RISK_SCORE — скоринговый балл (если используется СПАРК/Фокус)
• UF_LAST_CHECK — дата последней проверки
• UF_RAW_DATA — сырой JSON-ответ API

Привязка к пользователю Битрикс — поле UF_USER_ID на пользователе или связь через свойство COMPANY_ID в профиле.

Запрос к Dadata: реализация

class DadataContragentChecker
{
    private string $apiKey;
    private string $secretKey;

    public function __construct(string $apiKey, string $secretKey)
    {
        $this->apiKey    = $apiKey;
        $this->secretKey = $secretKey;
    }

    public function getByInn(string $inn): ?array
    {
        $cacheKey = 'dadata_inn_' . md5($inn);
        $cache    = \Bitrix\Main\Data\Cache::createInstance();

        if ($cache->initCache(86400, $cacheKey, '/dadata/inn/')) {
            return $cache->getVars();
        }

        $response = (new \Bitrix\Main\Web\HttpClient())->post(
            'https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party',
            json_encode(['query' => $inn, 'count' => 1]),
            [
                'Content-Type'  => 'application/json',
                'Authorization' => 'Token ' . $this->apiKey,
                'X-Secret'      => $this->secretKey,
            ]
        );

        $data = json_decode($response, true);
        if (empty($data['suggestions'][0])) {
            return null;
        }

        $result = $this->normalizeResponse($data['suggestions'][0]);

        $cache->startDataCache(86400, $cacheKey, '/dadata/inn/');
        $cache->endDataCache($result);

        return $result;
    }

    private function normalizeResponse(array $suggestion): array
    {
        $data = $suggestion['data'];
        return [
            'full_name' => $data['name']['full_with_opf'] ?? '',
            'inn'       => $data['inn'] ?? '',
            'kpp'       => $data['kpp'] ?? '',
            'ogrn'      => $data['ogrn'] ?? '',
            'address'   => $suggestion['unrestricted_value'] ?? '',
            'director'  => $data['management']['name'] ?? '',
            'status'    => strtolower($data['state']['status'] ?? 'unknown'),
        ];
    }
}

Кеширование на 24 часа — обязательно. Без него при массовой проверке быстро упираемся в лимиты API (Dadata: 10 000 запросов/сутки на бесплатном тарифе).

Встройка в форму регистрации

Компонент bitrix:system.auth.registration переопределяется в шаблоне. В форму добавляется поле ИНН с JavaScript-автодополнением:

document.getElementById('inn-field').addEventListener('blur', async function() {
    const inn = this.value.replace(/\D/g, '');
    if (inn.length !== 10 && inn.length !== 12) return;

    const resp = await fetch('/local/ajax/check-inn.php?inn=' + inn);
    const data = await resp.json();

    if (data.success) {
        document.getElementById('company-name').value  = data.full_name;
        document.getElementById('kpp-field').value     = data.kpp;
        document.getElementById('ogrn-field').value    = data.ogrn;
        document.getElementById('address-field').value = data.address;

        if (data.status !== 'active') {
            showWarning('Компания не является действующей');
        }
    }
});

Поле /local/ajax/check-inn.php — тонкий контроллер, который вызывает DadataContragentChecker и возвращает JSON.

Интеграция с CRM Битрикс24

Если используется CRM, проверка встраивается в момент создания контакта или компании через события:

• OnAfterCrmContactAdd / OnAfterCrmCompanyAdd — запускает фоновую проверку через обработчик
• Результат пишется в поле UF компании CRM
• При низком скоринге или статусе «ликвидирована» — автоматически создаётся задача менеджеру на ручную проверку

AddEventHandler('crm', 'OnAfterCrmCompanyAdd', function(&$fields) {
    $inn = $fields['fields']['UF_INN'] ?? '';
    if (!$inn) return;

    // Запускаем асинхронно через агент
    \CAgent::AddAgent(
        "checkContragentAgent({$fields['id']}, '{$inn}');",
        'my_module',
        'N',
        60
    );
});

Периодическая перепроверка

Компании меняют статус — ликвидируются, реорганизуются. Агент перепроверяет записи старше 30 дней:

function reCheckContragentsAgent(): string
{
    $connection = \Bitrix\Main\Application::getConnection();
    $rows = $connection->query(
        "SELECT ID, UF_INN FROM b_hl17_company_requisites
         WHERE UF_LAST_CHECK < DATE_SUB(NOW(), INTERVAL 30 DAY)
         LIMIT 50"
    );

    $checker = new DadataContragentChecker(DADATA_API_KEY, DADATA_SECRET);

    while ($row = $rows->fetch()) {
        $data = $checker->getByInn($row['UF_INN']);
        if ($data) {
            updateHlBlockRecord($row['ID'], $data);
        }
    }

    return __FUNCTION__ . '();';
}

Лимит 50 записей за запуск — чтобы агент не превышал время выполнения PHP.

Сроки реализации