מילוי אוטומטי של פרטי קבלן ב-Bitrix24 באמצעות Kontur.Focus API

שילוב 1C-Bitrix עם Kontur.Focus

תארו לעצמכם שמנהל מזין ח"פ (מספר עוסק מורשה) בכרטיס CRM. המערכת שותקת. הוא נאלץ לפתוח את אתר Kontur.Focus. הוא מעתיק את הפרטים הידנית. הוא בודק סיכונים — 15 דקות לכל חברה. עם השילוב שלנו, כל זה קורה תוך 2 שניות. זה מהיר פי 450.

המהנדסים שלנו, מוסמכים ב-1C-Bitrix ועם יותר מ-8 שנות ניסיון, מיישמים את החיבור הזה כפתרון סופי (turnkey). השלמנו יותר מ-50 שילובים מוצלחים. מהגדרת API ועד הטמעה בתהליכים עסקיים.

Kontur.Focus הוא שירות לבדיקת קבלנים: מרשם המדינה המאוחד של ישויות משפטיות/יזמים יחידים, תיקי בוררות, דוחות כספיים, אנשים קשורים. שילוב עם 1C-Bitrix נדרש כאשר מנהל מזין ח"פ של חברה בכרטיס CRM או במהלך רישום ישות משפטית באתר — ומצפה שהמערכת תשלוף אוטומטית פרטים ותסמן סיכונים.

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

כיצד פועל ה-API של Kontur.Focus

Kontur.Focus מספק REST API. האימות מתבצע באמצעות מפתח API בפרמטר הבקשה ?key={api_key}. שיטות עיקריות:

• GET /api/req?req={inn_or_ogrn}&key={key} — חיפוש לפי ח"פ/ע.מ., מחזיר פרטים בסיסיים
• GET /api/brief?inn={inn}&key={key} — כרטיס ארגון מקוצר: סטטוס, צורה משפטית, כתובת, מנהל
• GET /api/financials?inn={inn}&key={key} — מדדים כספיים (הכנסות, רווח בשנים האחרונות)
• GET /api/risks?inn={inn}&key={key} — פרופיל סיכונים מאוחד: סימנים שליליים, רשימות סנקציות

התגובה היא JSON. השדה status מכיל ACTIVE, LIQUIDATING, LIQUIDATED, BANKRUPT. עבור שילוב CRM, שדה זה הוא המפתח: עסקה עם חברה בפירוק דורשת תשומת לב מיוחדת.

מקור: תיעוד ה-API של Kontur.Focus

כיצד פועל מילוי אוטומטי של פרטים מ-Kontur.Focus ב-Bitrix24 CRM

התרחיש הנפוץ ביותר: מנהל מזין ח"פ בכרטיס חברה ב-CRM. המערכת שולחת שאילתה ל-Kontur.Focus. היא ממלאת אוטומטית את הקוד הסיווגי (KPP), את מספר הרישום הממלכתי (OGRN), את הכתובת המשפטית, ואת השם המלא של המנהל.

זה מיושם באמצעות מטפל אירועים CRM::ON_BEFORE_COMPANY_UPDATE (Bitrix24 on-premise) או באמצעות webhooks ב-Bitrix24 בענן. כאשר שדה ח"פ משתנה, אנו מפעילים בקשה ל-Kontur.Focus וממלאים את שדות הכרטיס.

ב-Bitrix24 בענן באמצעות REST API:

// Hook on company change via BX24.callMethod
BX24.callMethod('event.bind', {
  event: 'ONCRMUPDATECOMPANY',
  handler: 'https://your-app.ru/focus-handler/' // Replace with actual endpoint
});

בצד המטפל: אנו מקבלים את ח"פ מהשדה UF_INN או משדה פרטים סטנדרטי. אנו שולחים בקשה ל-Focus. לאחר מכן אנו מעדכנים את כרטיס החברה באמצעות crm.company.update.

בדיקת סיכונים והתראות

תרחיש שני: בדיקת קבלן לפני עסקה. אנו מצרפים טריגר בתהליך העסקי של Bitrix24. כאשר עסקה עוברת לשלב "חוזה", פרופיל הסיכונים נשלף אוטומטית מ-Kontur.Focus.

אם risks.negative_factors מכיל סימנים קריטיים (כתובת המונית, מנהל פסול, הליכי אכיפה על סכום גדול) — העסקה מקבלת תווית "דורש בדיקה". נוצרת משימה עבור מחלקת הביטחון.

זה מוגדר באמצעות רובוטי CRM (Bitrix24 בענן) או תהליכים עסקיים (on-premise). תנאי: "אם שדה UF_FOCUS_RISK > ערך סף → צור משימה → הודע למנהל".

מדוע מטמון בקשות הוא קריטי לתקציב

Kontur.Focus הוא API בתשלום עם מגבלת בקשות לפי תוכנית. עם CRM גדול (1000+ חברות) ועדכוני כרטיסים תכופים, מטמון הוא חובה. חריגה ממגבלת הבקשות מובילה לעלויות נוספות. ללא מטמון, ביצועי ה-CRM נפגעים.

אנו שומרים תוצאות בקשות במטמון ב-Redis או בטבלת Bitrix (\Bitrix\Main\Data\Cache). TTL של המטמון: 24 שעות עבור פרטים בסיסיים, שעה אחת עבור סטטוס (הסטטוס יכול להשתנות במהירות במהלך פירוק). לרענון כפוי — כפתור בכרטיס ה-CRM "עדכן נתונים מ-Focus". זה מפחית את העומס על ה-API וחוסך בתקציב.

שילוב במהלך רישום ישות משפטית באתר

עבור 1C-Bitrix (לא Bitrix24): טופס רישום ישות משפטית. המשתמש מזין ח"פ. בקשת AJAX נשלחת לנקודת הקצה של האתר. היא שולחת שאילתה ל-Kontur.Focus ומחזירה פרטים למילוי אוטומטי. לאחר הרישום, אנו שומרים את סטטוס הקבלן ואת הערכת הסיכונים במאפייני המשתמש (b_uts_user).

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

הערכות לוחות זמנים

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