שילוב 1C-Bitrix עם שירותי אימות קבלנים

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 בקשות ליום במסלול החינמי).

שילוב בטופס הרישום

רכיב UF_USER_ID נדרס בתבנית. שדה INN עם השלמה אוטומטית ב-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('Компания не является действующей');
        }
    }
});

נקודת הקצה COMPANY_ID היא בקר דק שקורא ל-CAgent ומחזיר JSON.

אינטגרציית CRM

אם משתמשים ב-CRM, האימות מוטמע בעת יצירת איש קשר או חברה דרך אירועים:

• 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'), ]; } } / bitrix:system.auth.registration — מפעיל בדיקת רקע דרך handler
• התוצאה נכתבת לשדה מותאם אישית של חברת ה-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.

תהליך היישום

1. ביקורת — אנו בודקים את הגדרות Bitrix הנוכחיות שלכם (אינפובלוקים, HL-blocks, CRM).
2. בחירת API — אנו ממליצים על ה-API הטוב ביותר (Dadata, Kontur.Focus או FTS) לצרכים שלכם.
3. בקר — אנו מפתחים את בקר ה-PHP לבדיקת INN עם מטמון.
4. HL-block — אנו יוצרים את ה-HL-block לאחסון פרטים וניקוד.
5. שילוב — אנו מוסיפים השלמה אוטומטית לטופס הרישום (התאמת תבנית).
6. סוכני רקע — אנו מגדירים סוכנים לאימות חוזר תקופתי.
7. אינטגרציית CRM — אנו מחברים אירועי CRM (אנשי קשר/חברות) עם התראות.
8. בדיקות והשקה — אנו בודקים בסביבת staging ומשיקים לסביבת הייצור.
9. תיעוד — אנו מספקים תיעוד תפעולי ומכשירים את המנהלים שלכם.
10. תמיכה — אנו מציעים חודש תמיכה לאחר ההשקה.

מה כלול בעבודה

• פיתוח בקר לבדיקת INN עם מטמון של 24 שעות
• יצירת HL-block לאחסון נתוני קבלן וניקוד
• שילוב השלמה אוטומטית בטופס הרישום (התאמת תבנית)
• הגדרת סוכני רקע לאימות חוזר תקופתי
• אינטגרציית CRM (אירועים, שדות מותאמים אישית, יצירת משימות)
• בדיקות בסביבת staging
• השקה לסביבת הייצור
• תיעוד תפעולי והכשרת מנהלים
• חודש תמיכה לאחר ההשקה עם תיקוני באגים והתאמות
• קוד מקור וגישה לבקרת גרסאות (Git)

לוח זמנים ועלות

העלויות הן הערכות; המחיר הסופי תלוי במורכבות ובמספר ה-API. עבור 500 פניות בחודש, החיסכון השנתי שלכם עולה על $45,000.

למה לבחור באינטגרציה שלנו?

בדיקה ידנית איטית פי 450 מבדיקה אוטומטית. אימות חוזר אוטומטי מזהה שינויים עד 30 יום מוקדם יותר. הצוות שלנו השלים למעלה מ-100 אינטגרציות Bitrix, עם שיעור שביעות רצון של 98% מלקוחות. אנו מספקים אחריות יציבות לשנה. כשותף Bitrix מוסמך, אנו מציעים תמיכה אמינה.

העריכו את הפרויקט שלכם

צרו קשר כדי לקבל הערכה ראשונית של מורכבות ולוח זמנים. אנו ננתח את תצורת Bitrix הנוכחית שלכם, נבחר את ה-API האופטימליים, ונציע פתרון סוהר עם אחריות לפעולה יציבה. שלחו בקשה — אנו נעריך את הפרויקט שלכם. העשרת נתונים ממספר מקורות מבטיחה דיוק.