שילוב Bitrix24 עם שירותי חתימה אלקטרונית

התקנת CryptoPro CSP על כל מחשב נייד, חלוקת טוקנים, מרדף אחר באגים בתוספי דפדפן אחרי עדכונים—כל מנהל מכיר את הכאב הזה. בממוצע, חברה מבזבזת 2-3 ימים על חתימת מסמך בודד באמצעות שליח, בעוד שחתימה בענן מצמצמת את זה ל-3-5 דקות. חברה טיפוסית מעבדת 50 עד 200 מסמכים בחודש—כל אחד דורש 2 עד 4 שעות של עבודה ידנית. על ידי מעבר לחתימה בענן, ניתן לחסוך 3,000 עד 12,000 דולר בחודש רק בעלויות עבודה. אנו מציעים דרך אחרת: שירותי חתימה אלקטרונית בענן. הם מסירים את התלות בתחנת עבודה ספציפית ומאפשרים זרימות חתימה גמישות עם משתתפים מרובים, כולל צדדים מתקשרים. החיסכון במסמך בודד מגיע ל-95%—מ-2.50 דולר למסמך באופן מסורתי ל-0.10 דולר עם חתימה בענן. הזמינו אינטגרציה סוהר תוך 2-3 שבועות—צרו קשר לייעוץ.

באיזה שירות חתימה אלקטרונית לבחור עבור Bitrix24?

למסמכים פורמליים (UPI, חשבוניות) עם צדדים מתקשרים רוסיים—Diadoc או SBIS. לחתימה פנימית ללא טוקנים—CryptoPro DSS. לחוזים בינלאומיים—DocuSign. חתימה בענן דרך API מהירה פי 3 מהחתימה המסורתית—אין צורך לחכות לשליח או לסרוק מסמכים.

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

התכנית הכללית זהה לכל השירותים; רק ה-API שונה:

1. המסמך נוצר ב-Bitrix24 באמצעות מחולל המסמכים (crm.documentgenerator).
2. handler מחלץ את הקובץ דרך Bitrix24 REST API ומעביר אותו לשירות החתימה האלקטרונית.
3. השירות מתחיל את זרימת החתימה—מודיע לחתומים.
4. החתומים עובדים בממשק שירות החתימה האלקטרונית (או באפליקציה הניידת).
5. webhook מהשירות מדווח על השלמה.
6. המסמך החתום + קובץ החתימה מועלים חזרה ל-Bitrix24.

חוליית החיבור היא handler בצד השרת (מקבל webhook). במקרה פשוט—סקריפט PHP על אירוח. לפעולה אמינה בעומס גבוה—תור משימות באמצעות Redis או RabbitMQ עם אספקה מובטחת וניסיונות חוזרים בשגיאות. לפי הנתונים שלנו, יישום אינטגרציה מקצר את מחזור סגירת העסקה הכולל ב-30–40%.

אינטגרציה עם Kontur.Diadoc: מחזור מלא

Diadoc הוא מפעיל ה-EDI הגדול ברוסיה, והוא זה שמחובר לרוב עם Bitrix24. REST API זמין בכתובת https://api.kontur.ru/diadoc/v1/. נבחן את היישום בפירוט.

אימות

דו-שלבי: ראשית POST /Authenticate עם שם משתמש/סיסמה או תעודה, ולאחר מכן הטוקן שהושג מועבר בכותרת Authorization: DiadocAuth ddauth_api_client_id={client_id}, ddauth_token={token}. הטוקן חי למשך שעה. ב-middleware, אנו שומרים אותו במטמון ומחדשים אותו אוטומטית 5 דקות לפני פקיעתו—אחרת בקשות יתחילו להיכשל עם 401 באמצע יום העבודה.

שליחת מסמך לחתימה

1. קבלת הקובץ מ-Bitrix24: crm.documentgenerator.document.get.
2. זיהוי תיבת הארגון: GET /GetMyOrganizations.
3. איתור הצד המתקשר ב-Diadoc: GET /GetCounteragent?myOrgId={id}&counteragentOrgId={id}.
4. למסמכים פורמליים (UPI, חשבונית, קבלה)—POST /GenerateTitleXml, Diadoc דורש XML בפורמט של שירות המס הפדרלי.
5. שליחה: POST /PostMessage עם המסמך המצורף והסוג.

למסמכים לא פורמליים (חוזים, הסכמים נוספים) אין צורך ב-XML—הקובץ מועבר כפי שהוא.

מעקב אחר סטטוס

Diadoc תומך בשני מנגנונים:

• Polling—GET /GetDocflowEvents?afterEventId={id}—קבלת אירועים אחרי מזהה נתון.
• מינויים ל-webhook—הודעות כאשר הסטטוס משתנה דרך גישת שותף.

בפועל, webhooks של Diadoc עלולים להתעכב בדקות בעומסי שיא. תכנית אמינה: webhook כטריגר לבדיקה מיידית, polling כל 5 דקות כגיבוי. כך אירועים לא הולכים לאיבוד וה-API לא עמוס בבקשות מיותרות.

קבלת המסמך החתום

GET /GetMessage?boxId={boxId}&messageId={msgId}&entityId={entityId} 

התשובה מכילה את כל הגרסאות של המסמך, חתימות של כל צד, וחותמות זמן. אנו מחלצים את הגרסה החתומה ואת קובץ החתימה (.sig), מעלים ל-Bitrix24 דרך GET /GetMessage?boxId={boxId}&messageId={msgId}&entityId={entityId} , ומצרפים לעסקה.

דחיית חתימה

הצד המתקשר יכול לבקש הבהרה או לדחות את המסמך. Diadoc מעביר את האירוע עם הערה. ה-handler יוצר משימה למנהל ב-Bitrix24 (disk.file.upload) עם טקסט הדחייה ומחזיר את העסקה לשלב העריכה דרך tasks.task.add.

זרימות חתימה עם משתתפים מרובים

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

חתימה מקבילה: שני הצדדים חותמים על דוח איזון באופן עצמאי.

חתימה עם אישור פנימי: לפני שהמנהל חותם, המסמך מאושר על ידי עורך דין וסמנכ"ל כספים. האישור משתמש ב-UNS (חתימה אלקטרונית לא מוסמכת), החתימה הסופית משתמשת ב-QES. בפרויקט טיפוסי, מוגדרים עד 5–7 שלבי אישור.

ב-API של השירותים, זרימה מתוארת על ידי קבוצת שלבים עם משתתפים, סוג פעולה וסדר:

{
  "document_id": "doc-456",
  "workflow": [
    {
      "step": 1,
      "action": "approve",
      "participants": ["[email protected]"],
      "type": "sequential"
    },
    {
      "step": 2,
      "action": "sign",
      "participants": ["[email protected]"],
      "type": "sequential"
    },
    {
      "step": 3,
      "action": "sign",
      "participants": ["[email protected]"],
      "type": "sequential"
    }
  ]
}

מה נשמר ב-Bitrix24 לאחר החתימה?

לאחר סיום המחזור, ה-CRM צריך להכיל:

• מסמך מקורי (PDF)
• קובץ חתימה נפרד (.sig)—CAdES או XAdES
• פרוטוקול חתימה—מי, מתי, עם איזו תעודה

הקבצים מועלים ל-Bitrix24.Disk במבנה crm.deal.update. שדות מותאמים אישית של העסקה מתעדים את תאריך החתימה, מספר המסמך במערכת ה-EDI, והסטטוס.

מדוע חתימה בענן משתלמת יותר מהמסורתית?

חתימה בענן דרך API מקצרת את זמן החתימה מ-2–3 ימים ל-3–5 דקות, חוסכת 80% מעלויות העבודה, ואינה דורשת התקנת CryptoPro CSP על כל מחשב. עם נפחים חודשיים טיפוסיים של 50–200 מסמכים, החיסכון בעלויות נע בין 2,500 ל-10,000 דולר בחודש.

הודעות ואוטומציה של pipeline

כל שינוי בסטטוס מסמך בשירות החתימה האלקטרונית משתקף ב-Bitrix24:

• הודעה בצ'אט ({ "document_id": "doc-456", "workflow": [ {"step": 1, "action": "approve", "participants": ["[email protected]"], "type": "sequential"}, {"step": 2, "action": "sign", "participants": ["[email protected]"], "type": "sequential"}, {"step": 3, "action": "sign", "participants": ["[email protected]"], "type": "sequential"} ] } )—למנהל האחראי
• הזזת שלב העסקה (Подписанные документы / [Год] / [Месяц] / [Номер сделки])—אוטומטית כאשר שני הצדדים חותמים
• תגובה בציר הזמן (im.notify.system.add)—עם פרטי האירוע
• משימה על דחייה (crm.deal.update)—למנהל לצורך תיקון המסמך

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

מה כלול בעבודה בעת הזמנת אינטגרציה?

• ניתוח דרישות ובחירת שירות
• הגדרת מפתחות API והגדרת סביבת בדיקות
• פיתוח handlers לשליחה וקבלת webhooks
• אינטגרציה של כפתור "שלח לחתימה" בכרטיס העסקה
• יצירת סקריפטים לזרימות עם משתמשים מרובים
• בדיקות מלאות עם מסמכים וצדדים מתקשרים אמיתיים
• הכנת תיעוד והדרכת משתמשים
• תמיכה טכנית למשך 30 יום לאחר ההשקה

שלבי יישום

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