שילוב Bitrix24 ו-Kontur.Accounting

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

אנו מתקינים תווך (middleware) שמחבר בין Bitrix24 ל-Kontur.Accounting דרך REST API. תוך 5-10 ימים אנו מגדירים את הסנכרון: צדדים שכנגד, חשבוניות, תשלומים, מסמכים סוגרים. עיבוד ידני של עסקה אחת אורך עד 15 דקות, אוטומטי — 2-3 שניות. האוטומציה מפחיתה את עלויות יצירת החשבונית מ-$2–3 ל-$1–1 — חיסכון של עד $2.7k–3.9k בשנה עם 100 עסקאות.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שלבי יישום

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

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

אבטחה וניטור

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

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

// Пример обработчика вебхука на 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'];
    // Получаем данные сделки через REST
    $deal = $this->bitrix24->call('crm.deal.get', ['id' => $dealId]);
    // Создаём счёт в Контуре
    $this->kontur->createInvoice($deal);
}