תארו את האירוע העסקי לפני בחירת API
תהליך תשלום B2B יכול לכלול מחירים מוסכמים, הזמנות רכש, מגבלות אישור ותנאי תשלום. התחילו בתהליך עבודה אחד ונקבו בשמות המערכות המעורבות. לדוגמה: קונה מאושר מבצע הזמנה, מערכת הכספים רושמת אותה, והמחסן מחזיר ללקוח את סטטוס האספקה בפורטל.
מאמר זה מתאר דוגמה לתכנון, לא פרויקט לקוח שהושלם. אותה הכנה חלה על אינטגרציות CRM, תשלומים והזמנות: זהו את האירוע, את הנתונים המוסמכים ואת המשמעות של העברה מוצלחת.
הכינו תקציר אינטגרציה
- מערכות וגישה: נקבו בשם הפלטפורמה, תוכנית החשבון, גרסת ה-API, התיעוד והסביבת הבדיקה (sandbox). ודאו שנקודות הקצה וההרשאות המיועדות זמינות.
- בעלות על נתונים: החליטו איזו מערכת מחזיקה בזהות הלקוח, במחיר, במלאי, בסטטוס ההזמנה ובמצב התשלום. ספקו רשומות מייצגות ללא נתונים אישיים.
- מיפוי: הגדירו מזהים משותפים, שדות נדרשים, מטבע, טיפול במס ואזורי זמן. תעדו מה צריך לקרות כאשר מוצר או לקוח אינם תואמים.
- חריגים: כללו ביטול, אספקה חלקית, תשלום שנכשל, מחיר שהשתנה ומערכת במורד הזרם שאינה זמינה.
- תפעול: החליטו מי בודק כשלים, מי יכול לשחזר העברה ומי מאשר תיקון.
הניחו שהתראות עשויות לחזור על עצמן או להגיע באיחור
עיבוד webhook דורש מדיניות ברורה לניסיונות חוזרים ולטיפול בכפילויות. כדוגמה קונקרטית לפלטפורמה אחת, Stripe מתעדת אימות חתימה, אירועים כפולים וטיפול אסינכרוני ב מדריך ה-webhook שלה. התראת תשלום צריכה להיות מאומתת ומעובדת בהתאם לחוזה של הספק. לפלטפורמות אחרות יש כללי מסירה וניסיונות חוזרים משלהן; אמתו אותם בנפרד.
דוגמה לקבלה: שלחו הזמנת sandbox, מסרו את האירוע שלה פעמיים, ולאחר מכן השביתו זמנית את המערכת המקבלת. ודאו שההזמנה נוצרת פעם אחת, שההעברה שנכשלה גלויה ושניתן לשחזר אותה באמצעות שחזור. בדקו גם שלקוח אינו יכול לצפות בתמחור או בהזמנות של חברה אחרת.
הסכימו מה כולל המהדורה הראשונה
מסגרת ראשונה ריאלית עשויה לתמוך בסוג הזמנה אחד, מחסן אחד וקבוצת מצבים מוגדרת. הפרידו בין הגירת נתונים היסטוריים, הצטרפות ספקים וכללי תמחור חריגים אם הם מצריכים בדיקה נוספת. הסכימו מה יהיה ידני בתחילה וכיצד הצוות ימדוד האם האינטגרציה מפחיתה עבודה.
ההעברה צריכה לכלול מיפויי שדות, הוראות הגדרה, ניטור, נוהל שחזור ובעלות מוגדרת בשם על שדרוגי הפלטפורמה. תנאי התחזוקה תלויים במערכות ובהתקשרות המוסכמת. גלו עוד על פיתוח ואינטגרציית API, אוטומציה של תהליכי עבודה ו פיתוח מסחר אלקטרוני.
