אינטגרציה בין Bitrix24 ל-Kontur.Accounting

מנהל סוגר עסקה ב-CRM, רואה החשבון לומד על כך ממסר — הזמן הולך לאיבוד. יש ליצור ידנית חשבונית ב-Kontur.Accounting, לאמת פרטי צד נגדי בכרטיס ה-CRM, לעקוב אחר תשלום בדף החשבון הבנקאי, ולחזור ל-Bitrix24. כל עסקה דורשת 3-5 מעברים בין מערכות. עם 50+ עסקאות בשבוע — הפסדים מובטחים: חשבוניות שנשכחו, צדדים נגדיים כפולים, שגיאות בפרטים.

הקמנו תוכנת ביניים שמחברת בין Bitrix24 ל-Kontur.Accounting דרך REST API. תוך 5-10 ימים אנו מגדירים את ההחלפה: צדדים נגדיים, חשבוניות, תשלומים, מסמכי סגירה. עיבוד ידני של עסקה אחת אורך עד 15 דקות, אוטומטי — 2-3 שניות.

האוטומציה מפחיתה את עלויות יצירת החשבוניות מ-по индивидуальному расчётуל-по индивидуальному расчёту— חיסכון של עד по индивидуальному расчёту בשנה עם 100 עסקאות.

כיצד בנויה האינטגרציה בין Bitrix24 ל-Kontur.Accounting?

Kontur.Accounting מספקת REST API לעבודה עם צדדים נגדיים, חשבוניות ומסמכים. ל-Bitrix24 יש REST API ומנגנון webhook. החיבור נבנה דרך שירות מתווך (middleware) שמאזין לאירועים של Bitrix24 ושולח בקשות ל-Kontur.

1. מאזין לאירועים של Bitrix24 — העברת עסקה לשלב "הנפקת חשבונית" יוצרת webhook.
2. שולף נתונים — מכרטיס העסקה ואיש הקשר/החברה המקושרים, הוא מוציא פרטים, סכום ורשימת מוצרים.
3. יוצר או מאתר את הצד הנגדי ב-Kontur — לפי ח.פ. אם הצד הנגדי חדש, הוא יוצר כרטיס.
4. יוצר חשבונית — עם פריטים, סכומים, מע"מ.
5. מחזיר את מספר החשבונית — כותב אותו לשדה מותאם אישית של העסקה ב-Bitrix24.

זרימה הפוכה: ה-middleware בודק מעת לעת (או דרך webhook מ-Kontur) את סטטוסי התשלומים ומעדכן שלבי עסקאות ב-CRM.

כיצד להימנע מצדדים נגדיים כפולים? — אינטגרציה עם Bitrix24

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

אנחנו פותרים זאת עם שני מנגנונים:

• מילוי אוטומטי לפי ח.פ. בכרטיס החברה ב-Bitrix24, המנהל מזין את ח.פ — סקריפט פונה לשירות Kontur.Focus (או DaData) ושולף את כל הפרטים. הנתונים תקפים מיד להנהלת חשבונות.
• סנכרון הפוך. אם רואה החשבון מוסיף צד נגדי ב-Kontur (למשל, ספק), ה-middleware יוצר את החברה המתאימה ב-CRM עם פרטים מלאים.

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

מה לעשות במקרה של שגיאות סנכרון?

ה-middleware מתעד כל פעולה: בקשה, תגובה, תוצאה. במקרה של שגיאות API (timeout, נתונים לא תקינים, rate limiting) — שלושה ניסיונות חוזרים עם השהיה הולכת וגדלה. אם עדיין לא מצליח — התראה למנהל מערכת בצ'אט של Bitrix24.

שגיאות אופייניות:

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

תהליך ידני לעומת אוטומציה: מה יעיל יותר?

שלבי יישום

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

• תכנון Middleware — בהתאמה לארכיטקטורת ה-CRM ולתהליכים העסקיים שלך.
• הגדרת REST API — עבור Bitrix24 ו-Kontur.Accounting.
• מיפוי נתונים — לקוחות, פריטים, חשבוניות.
• בדיקות — הפעלת פיילוט ל-3 ימים עם הנתונים שלך.
• תיעוד — תיאור כל התרחישים ונקודות הכשל.
• הדרכה — וובינר של שעתיים למנהלים ולרואי חשבון.
• תמיכה — 30 ימים לאחר ההפעלה (תיקון באגים, כיוונון עדין).

אבטחה וניטור

נתונים בין מערכות מועברים באמצעות HTTPS. אסימוני API מאוחסנים במשתני סביבה על שרת ה-middleware, ולא בקוד. הגישה ל-middleware מוגבלת לפי כתובות IP של שרתי Bitrix24 ו-Kontur. יומנים המכילים נתונים אישיים מסובבים — אחסון של לא יותר מ-90 יום.

אנו מגדירים את האינטגרציה עבור תהליך העסקי הספציפי שלך: מקישור מינימלי של "חשבונית → תשלום" ועד לזרימת מסמכים מלאה עם EDI.

// Example webhook handler in PHP
$event = json_decode(file_get_contents('php://input'), true);
if ($event['event'] === 'ON_CRM_DEAL_UPDATE' && $event['data']['FIELDS']['STAGE_ID'] === 'C7:NEW') {
    $dealId = $event['data']['FIELDS']['ID'];
    // Get deal data via REST
    $deal = $this->bitrix24->call('crm.deal.get', ['id' => $dealId]);
    // Create invoice in Kontur
    $this->kontur->createInvoice($deal);
}