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

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

Представьте: B2B-магазин на Битрикс получает заявку от компании. Менеджер вручную проверяет ИНН через сторонние сайты, тратя 15 минут на каждую заявку. Мы внедряем автоматическую проверку контрагента прямо в момент регистрации организации, оформления заказа или создания сделки в CRM. Данные из ЕГРЮЛ, реестра дисквалифицированных лиц и финансовые отчёты подтягиваются в карточку за секунды. Ручная проверка — 15 минут, автоматическая — 2 секунды, в 450 раз быстрее. Экономия на каждой заявке: если у вас 500 заявок в месяц, высвобождается 125 часов менеджерского времени.

Почему важна автоматическая проверка контрагентов?

При ручной проверке человеческий фактор неизбежен: менеджер может пропустить ликвидированную компанию или ошибиться в ИНН. Интеграция с надёжными источниками (ФНС, Dadata, Контур.Фокус) исключает эти риски. Мы гарантируем, что каждая заявка проходит проверку по единому алгоритму, а данные всегда актуальны благодаря периодической перепроверке. Наш опыт — 10+ лет в Битрикс-разработке, сертифицированные специалисты.

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

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

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

Как хранить данные контрагентов?

Для хранения реквизитов организаций используем 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 в профиле.

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

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

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

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

Запрос к 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.

Что входит в работу (deliverables)

• Аудит текущей архитектуры Битрикс (инфоблоки, HL-блоки, CRM)
• Выбор оптимального API под ваши задачи (Dadata vs Контур.Фокус vs ФНС)
• Разработка PHP-контроллера проверки по ИНН с кешированием
• Создание HL-блока для хранения реквизитов и скоринга
• Встройка автодополнения в форму регистрации (кастомизация шаблона)
• Настройка фоновых агентов для перепроверки
• Интеграция с CRM Битрикс24 (события + уведомления)
• Тестирование на стенде и развёртывание в production
• Документация по эксплуатации и обучение менеджеров
• Поддержка в течение 1 месяца после запуска

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

Оценим ваш проект

Свяжитесь с нами, чтобы получить предварительную оценку сложности и сроков. Мы проанализируем вашу текущую конфигурацию Битрикс, подберём оптимальные API и предложим решение под ключ с гарантией стабильной работы. Пишите — оценим проект бесплатно.