אוטומציה של החלפת דוחות התאמה בין 1C ל-Bitrix24

בעיה: דוחות התאמה נשארים ב-1C, אבל נדרשים ב-CRM

מנהל מטפל בעסקה ב-Bitrix24 וצריך לבדוק את היתרה הנוכחית של צד שכנגד. הוא פותח את 1C, ממתין לטעינה, מפיק דוח — 10–15 דקות. עם 10 בקשות כאלה ביום, מדובר באובדן של 2–3 שעות. והצדדים שכנגד מבקשים דוחות לתקופות שרירותיות, מה שמאלץ את רואה החשבון לחזור ל-1C. אנחנו פותרים זאת: אנו מקימים החלפה ישירה של דוחות התאמה בין 1C ל-Bitrix24 כך שהנתונים זמינים בלחיצה אחת. ניסיון אינטגרציה: מעל 50 פרויקטים, אחריות לעבודה.

מה המשמעות של דוח התאמה בהקשר של אינטגרציה

דוח התאמה ב-1C נוצר מהרישום ВзаиморасчётыСКонтрагентами לתקופה. המסמך מכיל רשימת עסקאות (משלוחים, קבלות, החזרות), יתרה סופית ושדות חתימה. ב-1C, זה או דוח (АктСверкиВзаиморасчётов) או מסמך נפרד. לצורך אינטגרציה, עלינו להוציא נתונים אלה בפורמט קריא למכונה — דרך REST API.

למה דוחות נדרשים ב-Bitrix24

תרחיש 1: CRM. המנהל רואה את היתרה הנוכחית בכרטיס החברה ללא מעבר ל-1C. דוח ההתאמה מוצג דרך וידג'ט או בכרטיסייה נפרדת.

תרחיש 2: פורטל לקוחות. לקוח B2B נכנס לחשבון האישי שלו באתר, בוחר תקופה ומוריד PDF. אין יותר פניות לרואה החשבון.

תרחיש 3: שליחה אוטומטית. פעם בחודש, דוחות התאמה נשלחים לכל הצדדים שכנגד עם יתרה שאינה אפס — בדוא"ל או באמצעות הודעות Bitrix24.

איך דוחות התאמה מגיעים מ-1C ל-CRM?

אנו יוצרים שירות HTTP ב-1C — נקודת קצה עם אימות מפתח API. השירות מקבל GUID של צד שכנגד ותקופה, ומחזיר JSON עם נתוני דוח ו/או PDF ב-base64.

GET /hs/reconciliation/act?counterparty_guid=abc-123&date_from=2024-01-01&date_to=2024-03-31 Authorization: Bearer {api_key} 

{ "counterparty": "ООО Ромашка", "period": {"from": "2024-01-01", "to": "2024-03-31"}, "opening_balance": -15000.00, "transactions": [ {"date": "2024-01-15", "document": "Реализация №12", "debit": 45000, "credit": 0}, {"date": "2024-01-20", "document": "Платёж №456", "debit": 0, "credit": 45000} ], "closing_balance": -15000.00, "pdf_base64": "JVBERi0xLjQ..." } 

ב-Bitrix24, הנתונים מוצגים דרך וידג'ט (iframe) בכרטיס החברה. כתובת הווידג'ט מצביעה על שירות ה-HTTP של 1C, שמציג טבלת HTML. חלופה היא שימוש בפריטי Activity או Timeline דרך REST API, אבל הווידג'ט פשוט ומהיר יותר.

השוואת שיטות תצוגה ב-CRM

הווידג'ט הוא הבחירה האופטימלית: המנהל רואה מידע עדכני ללא טעינת עמוד מחדש.

יצירה ושליחה אוטומטית של דוחות

משימה מתוזמנת רצה פעם בחודש:

1. קבלת רשימת צדדים שכנגד עם יתרות שאינן אפס.
2. לכל אחד, הפקת דוח התאמה ב-PDF (באמצעות הפונקציה GET /hs/reconciliation/act?counterparty_guid=abc-123&date_from=2024-01-01&date_to=2024-03-31 Authorization: Bearer {api_key} ב-1C).
3. העלאת ה-PDF ל-Drive של Bitrix24 דרך REST API ({ "counterparty": "ООО Ромашка", "period": {"from": "2024-01-01", "to": "2024-03-31"}, "opening_balance": -15000.00, "transactions": [ {"date": "2024-01-15", "document": "Реализация №12", "debit": 45000, "credit": 0}, {"date": "2024-01-20", "document": "Платёж №456", "debit": 0, "credit": 45000} ], "closing_balance": -15000.00, "pdf_base64": "JVBERi0xLjQ..." } ).
4. יצירת משימה למנהל או שליחת דוא"ל מיידית.

דוגמת העלאה ב-PHP:

$bitrix24->call('disk.folder.uploadFile', [ 'id' => ACTS_FOLDER_ID, 'data' => ['NAME' => "Акт сверки {$company} {$period}.pdf"], 'fileContent' => base64_encode($pdfContent), ]); 

למה להפוך את שליחת הדוחות לאוטומטית?

שליחה ידנית מבזבזת 3–4 ימים בחודש עבור רואה החשבון. אוטומציה מצמצמת זאת ל-15–20 דקות לניטור. בנוסף, הצדדים שכנגד מקבלים דוחות ללא עיכובים, מה שמפחית את זרם הפניות למחלקת המכירות.

מקרה מהניסיון שלנו: פורטל שירות עצמי B2B

ספק סיטונאי עם 500 צדדים שכנגד פעילים. לפנינו, רואה החשבון בילה 3–4 ימים בחודש על שליחה ידנית של דוחות. הצדדים שכנגד התקשרו כל הזמן וביקשו דוחות לתקופות לא סטנדרטיות. יישמנו חשבון אישי באתר (Bitrix) עם כרטיסיית "דוחות התאמה". הצד שכנגד בוחר תקופה → לוחץ על "צור" → שירות ה-HTTP של 1C מחזיר PDF. אוטומטית ב-1 בכל חודש, נוצרים 500 קבצי PDF (12 דקות), מועלים ל-Drive, ונוצרות משימות למנהלים (עוד 8 דקות דרך REST). רואה החשבון הפסיק לבזבז ימים על עבודה שגרתית.