בעיה: במהלך סנכרון דו-כיווני בין 1С:Document Management (1С:DO) ל-Bitrix24, וובהוקים יוצרים לולאה — עדכון מסמך ב-1С יוצר משימה ב-Bitrix24, עדכון המשימה שולח בקשה חזרה ל-1С, והמחזור חוזר על עצמו. ללא דגלי סנכרון, הדבר מוביל לשכפול נתונים ולהתראות אינסופיות. אנו פותרים זאת באמצעות סמני בקרה ומיפוי חכם, ומבטיחים פעילות יציבה של החיבור.
החיבור בין 1С:Document Management ל-Bitrix24 מגשר על הפער בין מעגל הנהלת החשבונות לסביבת העבודה של הצוות. מסמכים נשמרים ב-1С:DO עם תוקף משפטי וניהול גרסאות, בעוד העובדים עובדים עם משימות ואישורים בתוך Bitrix24 — ללא מעבר בין המערכות.
הניסיון שלנו באינטגרציה זו עולה על 5 שנים, עם למעלה מ-100 הטמעות, מה שמאפשר לנו להימנע משגיאות הגדרה אופייניות.
אנו מגדירים חילוף דו-כיווני כך ששינויים בכל אחת מהמערכות משתקפים כראוי בשנייה, קונפליקטים מטופלים אוטומטית, ומסלולי אישור אינם משוכפלים. הכל עובד במפתח סופי: מההגדרה הראשונית ועד לניטור בסביבת הייצור.
מה מסונכרן
החלפה בנויה בשלושה כיוונים:
- מסמכים ← Bitrix24 Drive. קבצים מ-1С:DO מפורסמים לתיקיות מוגדרות ב-Drive. כאשר גרסה מתעדכנת ב-1С:DO, הקובץ ב-Drive נדרס. העלאה הפוכה — באמצעות טריגר או לפי לוח זמנים.
- מטלות ↔ משימות. מטלה ב-1С:DO יוצרת משימה ב-Bitrix24 המקושרת לאחראי. סגירת המשימה ב-B24 משנה את סטטוס המטלה ב-1С:DO.
- אישורים באמצעות תהליכים עסקיים. מסלול האישור למסמך ב-1С:DO מתורגם לתהליך עסקי ב-Bitrix24 — המשתתפים מקבלים התראות ומצביעים בתוך הפורטל.
מחסנית אינטגרציה טכנית
ההחלפה מיושמת באמצעות Bitrix24 REST API. תיעוד רשמי ושירותי 1С:DO HTTP. תרשים אינטראקציה:
| רכיב | תפקיד |
|---|---|
| Bitrix24 REST API | יצירת משימות, העלאת קבצים ל-Drive, הפעלת תהליכים עסקיים |
| Webhooks נכנסים | קבלת אירועים מ-1С:DO — מסמך חדש, שינוי סטטוס |
| Webhooks יוצאים | הודעה ל-1С:DO על השלמת אישור ב-B24 |
| שירות 1С:DO HTTP | נקודת קצה לקבלת פקודות מ-Bitrix24 |
| תור הודעות | חציצה בעומסי שיא (אופציונלי — RabbitMQ) |
הרשאה — באמצעות OAuth 2.0 עבור אפליקציות שרת או webhook נכנס עם טוקן. בסביבת ייצור, אנו משתמשים באפליקציית שרת: הטוקן מתחדש אוטומטית, ללא תלות במשתמש ספציפי.
מיפוי שדות
ספריות ב-1С:DO וב-Bitrix24 אינן תואמות. אנו מגדירים טבלת התאמה:
- 1С:DO גורמים נגדיים → CRM חברות. התאמה לפי ח"פ או קוד חיצוני.
- סוגי מסמכים → תיקיות Drive. כל סוג מסמך מ-1С:DO מקושר לתיקייה ספציפית.
- מבצעים → B24 משתמשים. מיפוי לפי דוא"ל או מספר עובד בשדה מותאם אישית.
- סטטוסי אישור. "מאושר" / "נדחה" / "תיקון" ב-1С:DO תואמים לתוצאות הצבעה בתהליכים עסקיים ב-Bitrix24.
כיצד להגדיר מסלולי אישור?
זהו מרכיב מרכזי באינטגרציה. המסלול ב-1С:DO מכיל שלבים: ייזום, אישור סדרתי או מקבילי, חתימה. ב-Bitrix24, מסלול זה משוחזר באמצעות תבנית תהליך עסקי:
- ייזום. Webhook מ-1С:DO מפעיל תהליך עסקי ב-Bitrix24 עם מזהה המסמך, רשימת המאשרים ומועד היעד.
- שלב מקבילי. התהליך העסקי יוצר משימות לכל משתתפי השלב בו-זמנית. התוצאה נרשמת במשתני BP.
- שלב סדרתי. המשימה של המשתתף הבא נוצרת רק לאחר השלמת המשימה של הקודם.
- החזרת תוצאה. עם השלמת BP, Webhook יוצא שולח את הסטטוס הסופי ואת הערות המאשרים ל-1С:DO.
אם המסלול ב-1С:DO משתנה (נוסף שלב, הוחלף מאשר), תבנית BP מתעדכנת באופן ידני או באמצעות סקריפט יצירה מחדש. יצירה אוטומטית מלאה של תבניות BP מ-1С:DO אפשרית אך דורשת מאמץ פיתוח נפרד.
כיצד מטפלים בקונפליקטים?
בהחלפה דו-כיוונית, התנגשויות הן בלתי נמנעות. כללי פתרון:
- מסמכים. עדיפות ל-1С:DO כמערכת החשבונאות. אם קובץ שונה בשתי המערכות, הגרסה מ-1С:DO דורסת את גרסת ה-Drive; העותק המתנגש נשמר עם הסיומת
_conflict_YYYYMMDD. - משימות/הקצאות. עדיפות למערכת שבה התרחש השינוי האחרון (לפי חותמת זמן). אם הפער קטן מ-60 שניות — פתרון ידני באמצעות התראה למנהל.
- אישורים. קונפליקט בלתי אפשרי מבחינה מבנית: תוצאת ההצבעה נוצרת במערכת אחת ומועברת לשנייה.
כיצד להגדיר תזמון וניטור?
סנכרון מסמכים פועל לפי לוח זמנים (משימת cron בצד 1С, סוכן בצד B24) עם מרווח של 5 דקות ומעלה. משימות ואישורים — בזמן אמת באמצעות webhooks.
לצורך ניטור, אנו מגדירים:
- יומן החלפה ב-1С:DO (מרשם מידע עם היסטוריית שליחות)
- יומן webhooks נכנסים ב-Bitrix24
- התראת מנהל על שגיאות HTTP (סטטוסים 4xx/5xx) או timeout
בעיות אופייניות ופתרונות
| בעיה | פתרון |
|---|---|
| לולאת webhook | הוספת דגל סנכרון ובדיקת חותמות זמן |
| כפילות משימות | הגדרת מזהה ייחודי לכל הקצאה |
| אובדן גרסת מסמך | שימוש בתור הודעות לאספקה מובטחת |
לתוכנית אינטגרציה אישית, קבלו ייעוץ — ננתח את סכימת זרימת המסמכים שלכם.
מה תקבלו בסופו של דבר
עובדים מאשרים מסמכים בממשק המוכר של Bitrix24 מבלי להיכנס ל-1С:DO. רואי חשבון ועורכי דין ממשיכים לעבוד ב-1С:Document Management. שתי המערכות מכילות נתונים עדכניים בהשהיה של לא יותר מ-5-10 דקות עבור מסמכים וסנכרון מיידי עבור משימות ואישורים.
הגישה שלנו עם תורי הודעות (RabbitMQ) מטפלת בעד 5,000 מסמכים בשעה — פי 10 מהר יותר מפתרונות טיפוסיים ללא buffering.
העריכו את הפרויקט שלכם: נכין תוכנית אינטגרציה תוך יום אחד. צרו קשר לייעוץ — אנו מבטיחים פעולה יציבה של ההחלפה.