1C-Bitrix Integration with Contractor Verification Services

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'), ]; } } 

Caching for 24 hours is mandatory. Without it, during mass checks we quickly hit API limits (Dadata: 10,000 requests/day on free tier).

Embedding into Registration Form

The bitrix:system.auth.registration component is overridden in the template. An INN field with JavaScript autocomplete is added:

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('Company is not active'); } } }); 

The /local/ajax/check-inn.php endpoint is a thin controller that calls DadataContragentChecker and returns JSON.

CRM Integration

If CRM is used, verification is embedded upon creating a contact or company via events:

• OnAfterCrmContactAdd / OnAfterCrmCompanyAdd — triggers a background check via handler
• The result is written to a custom field of the CRM company
• With low scoring or "liquidated" status — a task is automatically created for the manager for manual check

AddEventHandler('crm', 'OnAfterCrmCompanyAdd', function(&$fields) { $inn = $fields['fields']['UF_INN'] ?? ''; if (!$inn) return; // Launch asynchronously via agent \CAgent::AddAgent( "checkContragentAgent({$fields['id']}, '{$inn}');", 'my_module', 'N', 60 ); }); 

Periodic Re-verification

Companies change status — get liquidated, reorganized. The agent re-checks records older than 30 days:

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__ . '();'; } 

Limit of 50 records per run — to prevent the agent from exceeding PHP execution time.

Implementation Process

1. Audit — We review your current Bitrix setup (infoblocks, HL-blocks, CRM).
2. API Selection — We recommend the best API (Dadata, Kontur.Focus, or FTS) for your needs.
3. Controller — We develop the PHP controller for INN check with caching.
4. HL-block — We create the HL-block for storing requisites and scoring.
5. Embedding — We add autocomplete to the registration form (template customization).
6. Background Agents — We configure agents for periodic re-verification.
7. CRM Integration — We wire up CRM events (contacts/companies) with notifications.
8. Testing & Deployment — We test on staging and deploy to production.
9. Documentation — We provide operational docs and train your managers.
10. Support — We offer 1-month post-launch support.

What's Included in the Work

• Development of INN check controller with 24-hour caching
• Creation of HL-block for storing contractor data and scoring
• Embedding of autocomplete into registration form (template customization)
• Configuration of background agents for periodic re-verification
• CRM integration (events, custom fields, task creation)
• Testing on staging environment
• Deployment to production
• Operational documentation and manager training
• 1-month post-launch support with bug fixes and adjustments
• Source code and access to version control (Git)

Timeline and Cost

Costs are estimates; final price depends on complexity and number of APIs. For 500 applications per month, your annual savings exceed $45,000.

Why Choose Our Integration?

Manual verification is 450 times slower than automated. Automated re-verification catches changes up to 30 days earlier. Our team has completed over 100 Bitrix integrations, with a 98% client satisfaction rate. We provide a 1-year stability guarantee. As a certified Bitrix partner, we offer reliable support.

Evaluate Your Project

Contact us to get a preliminary assessment of complexity and timeline. We will analyze your current Bitrix configuration, select the optimal APIs, and offer a turnkey solution with a guarantee of stable operation. Submit a request — we'll evaluate your project for free. Data enrichment from multiple sources ensures accuracy.