שילוב EDI נייד עם חתימה בענן ו-API של Diadoc

שילוב EDI נייד עם חתימה בענן ו-API של Diadoc

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

שילוב מערכת EDI באפליקציה ניידת אינו רק חיבור API. מדובר בבחירת הספק, סוג החתימה, פורמט המסמך ועמידה ברגולציה. הניסיון שלנו: למעלה מ-50 שילובים מוצלחים עם Diadoc, SPHERE, 1C-EDO. בואו נפרק את הנקודות המרכזיות.

כיצד חתימה בענן מפשטת EDI בעל תוקף משפטי?

EDI בעל תוקף משפטי דורש חתימה אלקטרונית כשירה (QES) או חתימה אלקטרונית לא כשירה (UES) בהתאם לסוג המסמך. זהו הבדל מרכזי מלחיצת "אישור" בממשק המשתמש. במכשיר נייד, ניתן ליישם חתימה בכמה דרכים.

• חתימה בענן (מומלצת לנייד): QES מאוחסנת בכספת המאובטחת של הספק. האפליקציה מבקשת חתימה דרך API—המשתמש מאשר באמצעות SMS או push. המפתח הפרטי לעולם לא עוזב את הענן, מה שהופך אותו לבטוח פי 10 מאחסון המפתח במכשיר. Diadoc מספקת חתימה בענן דרך Kontur.Crypto.
• עבודה עם טוקן/כרטיס חכם: חיבור טוקן USB באמצעות מתאם Lightning/USB-C אפשרי אך נדיר בנייד. זה דורש SDKs מיוחדים ותמיכת MFi.
• חתימה אלקטרונית פשוטה (SES): לאישורים פנימיים, SES מספקת תוקף משפטי ברמה נמוכה יותר, המספיקה לתהליכי עבודה בתוך החברה.

כיצד בנוי שילוב עם API של Diadoc?

אימות—OAuth 2.0 עם פרטי לקוח או דרך Kontur.ID. עבור האפליקציה הניידת, אנו משתמשים ב-Authorization Code Flow:

GET https://auth.kontur.ru/api/authorization/v5.7/oauth/login
?client_id={client_id}
&response_type=code
&redirect_uri=myapp://auth/callback
&scope=diadoc

לאחר קבלת GET https://auth.kontur.ru/api/authorization/v5.7/oauth/login ?client_id={client_id} &response_type=code &redirect_uri=myapp://auth/callback &scope=diadoc , אנו מחליפים אותו ב-code. לטוקן יש אורך חיים מוגבל—אנו מיישמים חידוש אוטומטי באמצעות access_token.

קבלת רשימת מסמכים:

GET https://diadoc-api.kontur.ru/V3/GetDocuments
?boxId={boxId}&filterCategory=Any.Incoming
Authorization: DiadocAuth ddauth_api_client_id={client_id},ddauth_token={token}

התשובה היא XML או JSON בהתאם לכותרות refresh_token. עבור נייד, JSON מועדף.

עבודה עם מסמכים במכשיר

צפייה ב-PDF. Diadoc מחזירה מסמכים בפורמט PDF או TIFF (עבור מסמכים פורמליים—XML). ב-iOS, אנו מציגים PDF דרך PDFKit, עבור TIFF דרך UIImage. באנדרואיד—PdfRenderer או ספריית AndroidPdfViewer. עבור מסמכי XML פורמליים (UPD, חשבונית), נדרש עיבוד דרך תבנית XSLT—Diadoc מספקת טפסים להדפסה דרך API.

חתימה. לחתימה בענן: GET https://diadoc-api.kontur.ru/V3/GetDocuments ?boxId={boxId}&filterCategory=Any.Incoming Authorization: DiadocAuth ddauth_api_client_id={client_id},ddauth_token={token} עם Accept ואישור משתמש. ה-API מחזיר את סטטוס החתימה באופן אסינכרוני—נדרשת בדיקה תקופתית או webhook.

יצירת מסמך יוצא. עבור מסמכים לא פורמליים: המשתמש מצרף PDF/DOCX ממערכת הקבצים, אנו מבצעים POST /V3/PostSignatures עם תוכן קובץ מקודד base64 ומטא-דאטה.

מסמכים פורמליים (UPD, TORG-12, אישורים)

מסמכים פורמליים הם XML לפי פורמטים של שירות המס הפדרלי (צווים ММВ-7-15/820@, ЕД-7-26/736@). לא ניתן לצרף אותם כקובץ—יש ליצור את ה-XML מנתונים. Diadoc מספקת יצירת XML דרך DocumentId, POST /V3/PostMessagePatch ושיטות דומות.

בנייד, משתמשים ממעטים ליצור UPD מאפס—הם מאשרים או חותמים על מסמכים קיימים. יצירת מסמכים פורמליים עדיף לבצע באינטרנט או ב-ERP.

התראות על מסמכים חדשים

התראות push למסמכים חדשים—תכונה מרכזית לאפליקציית EDI עובדת. Diadoc תומכת ב-webhooks (POST /GenerateTorg12XmlForSeller): באירוע חדש, המערכת שולחת POST לנקודת הקצה שלכם, והשרת שולח push FCM/APNs. לחיצה על ההתראה פותחת את רשימת הקבצים המסוננת לפי "דורש פעולה".

מצב לא מקוון וקאש

אנו שומרים מסמכים בקאש מקומי—משתמשים יכולים לצפות בקבצים שכבר הורדו ללא אינטרנט. עבור נתונים רגישים—הצפנת קאש דרך iOS Data Protection או Android Keystore + AES-256. ניתן לאחסן את רשימת המסמכים ב-Core Data / Room עם סנכרון כשהרשת זמינה.

תוצרי הפרויקט: מה אתם מקבלים

אנו מספקים שילוב מפתח ביד עם תיעוד וגישה. הנה מה שאתם מקבלים:

• ביקורת דרישות ובחירת ספק EDI.
• יישום אימות (OAuth 2.0) ורשימת מסמכים.
• צפייה במסמכים פורמליים PDF/TIFF/XML.
• חתימה באמצעות חתימה בענן או SES.
• התראות push למסמכים חדשים.
• קאש עם הצפנה (AES-256) לגישה לא מקוונת.
• תיעוד ופרטי גישה.
• הדרכת צוות.
• 3 חודשי תמיכה לאחר השחרור.

עלות השילוב מתחילה מ-$15,000 עבור הגדרה בסיסית; חתימה בענן מוסיפה $5,000. עלות פרויקט ממוצעת היא $15,000–$20,000, עם החזר השקעה תוך 6 חודשים. הלקוחות שלנו רואים בדרך כלל חיסכון של 60% בעלויות תפעול, השווה ל-$15,000 בשנה בהוצאות שליחים.

כיצד אנו מיישמים EDI: תהליך ולוח זמנים

1. ביקורת דרישות: אילו סוגי מסמכים, איזו חתימה, איזה ספק EDI.
2. בחירת שיטת חתימה: חתימה בענן היא האפשרות הסבירה היחידה למשתמשים ניידים ללא MDM ארגוני.
3. אב-טיפוס שילוב: סביבת בדיקה של Diadoc או ספק אחר, שאילתות בסיסיות.
4. פיתוח: אימות, רשימת מסמכים, צפייה, חתימה.
5. בדיקות: תרחישים משפטיים מאומתים עם ספק ה-EDI.
6. ביקורת אבטחה: אחסון טוקנים, הצפנת קאש, הגנה מפני יירוט.

לוחות הזמנים תלויים במורכבות: צפייה ואישור ללא יצירת מסמכים—3–4 שבועות. מחזור מלא עם יצירה, חתימה ושילוב QES בענן—2–3 חודשים. עבודה עם מסמכים פורמליים מוסיפה 2–4 שבועות.

שגיאות אופייניות בשילוב EDI:

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

מקרה בוחן: חברת לוגיסטיקה

שילבנו EDI עבור חברת לוגיסטיקה: 1,500 מסמכים ביום, חתימה על אישורים בטאבלטים של אנדרואיד על ידי נהגים. בחרנו חתימה בענן דרך Diadoc, יישמנו אימות דרך Kontur.ID, התראות push למסמכים נכנסים. צפייה ב-PDF דרך WebView, חתימה בלחיצת כפתור עם אישור SMS. זמן מפתיחה לחתימה—15 שניות. לפני היישום—3 ימים לנייר. זמן האישור השתפר פי 17,280 בהשוואה לתהליכי נייר. חיסכון בעלויות תפעול—עד 60%, השווה ל-$15,000 בשנה בהוצאות שליחים.

אילו ספקי EDI זמינים לשילוב?

לפרויקטים חדשים, אנו בדרך כלל בוחרים ב-Diadoc—ה-API השלם ביותר עם SLA של 99.9% זמינות וזמני תגובה מתחת ל-500ms.

מתי נדרשת חתימה כשירה?

לפי חוק פדרלי מס' 63-FZ, QES היא חובה להחלפה חיצונית עם צדדים עסקיים. אישורים פנימיים יכולים להשתמש ב-SES. חתימה בענן פותרת את בעיית האבטחה: אתם מקבלים תוקף משפטי ללא סיכון של אובדן מפתח. הפתרון שלנו משתמש בהצפנת TLS 1.2 ו-AES-256 עבור כל הנתונים במעבר ובמנוחה.

צרו קשר לייעוץ על בחירת ספק והערכת פרויקט—נמצא את הפתרון הטוב ביותר לעסק שלכם. בקשו הדגמה כדי לראות את השילוב בפעולה.