אינטגרציה מול קומקס: לחבר ERP קמעונאי לחנות

קומקס היא מערכת ERP קמעונאית ישראלית, ורוב הפרויקטים סביבה הם אותו פרויקט: לחבר אותה לחנות מקוונת כך שהקטלוג, המלאי וההזמנות יזרמו בין השתיים. הממשק חושף ווב-שירותים בכתובת ws.comax.co.il, עם אימות בזוג LoginID ו-LoginPassword.

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

מה הצורה הזו אומרת

פעולות בשם, לא משאבים

זהו ממשק בסגנון ווב-שירותים: פעולות בשם - למשל שליפת פרטי לקוח לפי חיפוש - ולא משאבים עם פעלי HTTP. אין GET /customers/123 ואין DELETE.

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

אימות ארוך-חיים

זוג פרטי התחברות שנשלח בכל קריאה אינו טוקן שפג. שתי השלכות:

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

משתני סביבה או מנהל סודות בלבד. לא בקוד המקור, לא בלוגים, ולא בשום דבר שרץ בדפדפן.

ארבעת הזרמים

אינטגרציה קמעונאית מתפרקת לארבעה זרמים חד-כיווניים, ורק אחד דחוף:

הפירוט המלא של הדפוס נמצא בלחבר ERP ישראלי לכל מערכת אחרת. מה שייחודי לקמעונאות מופיע למטה.

מה שמייחד קמעונאות: הקופה

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

בעסק קמעונאי, אותו מלאי נמכר בשני מקומות בו-זמנית - באתר ובקופה הפיזית. הקופה לא מחכה לסנכרון שלך.

שלוש שאלות שקובעות אם הסנכרון יעבוד:

1. איזה מלאי החנות מוכרת? מלאי פיזי או מלאי זמין למכירה? למכירה מקוונת רוצים את הזמין - אחרת תמכור פריטים שכבר מוקצים.
2. מאילו סניפים? סכימה עיוורת של כל הסניפים מייצרת התחייבות למלאי שנמצא במקום אחר.
3. מה קורה בפריט אחרון? אם נשארה יחידה אחת והיא נמכרה בקופה, כמה זמן עובר עד שהאתר יודע? זה הפער שבו מוכרים מלאי שאין.

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

מפתח החיבור: ברקוד

צריך מזהה יציב שקושר פריט בקומקס לפריט בחנות. הברקוד או המק"ט הם הבחירה הטבעית - אבל רק אם הם באמת ייחודיים.

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

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

מה שחייב להיות

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

התאמת לקוחות

אחת הפעולות שהממשק חושף היא שליפת פרטי לקוח לפי חיפוש - וזה בדיוק המקום שדורש זהירות.

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

צ'קליסט לפני התמחור

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