חיבור ווקומרס ל-eHouse: שידור הזמנות אוטומטי למרכז הפולפילמנט

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

תוסף WM eHouse Dispatch מבית WeManage נבנה כדי לפתור את האתגר הזה. התוסף מקשר את חנות הווקומרס למערכת eHouse דרך ממשק ה-REST API הרשמי. הוא משדר את ההזמנות אוטומטית ברגע שהתשלום מאושר ומבצע אישור סופי, כך שההזמנה נקלטת במערכת הפולפילמנט ללא צורך בהתערבות ידנית.

מהי מערכת eHouse ולמה נדרש חיבור מותאם?

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

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

יכולות מרכזיות של התוסף ממשוק

1. שידור אוטומטי מבוסס סטטוס תשלום

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

2. בחירת מוצרים סלקטיבית לשידור

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

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

• הזמנות ללא מוצרי eHouse: לא יועבר שידור ולא ייווצרו התראות שגיאה.

• וריאציות מוצר: וריאציות (כגון מידה או צבע) יורשות את ההגדרה ממוצר האב, ללא צורך בסימון פרטני.

3. אישור סופי אוטומטי ב-API

בממשק ה-API של eHouse, יצירת ההזמנה הראשונית אינה מספיקה — הזמנה ללא שיוך שיטת משלוח נשארת במצב "ממתין". התוסף מריץ תהליך דו-שלבי: לאחר יצירת ההזמנה נשלחת בקשת עדכון (PATCH) הכוללת את סוג המשלוח ומסגרת הזמן. שלב זה מקביל לבלחיצת "שמור" בממשק, ומעביר את ההזמנה ישירות לתור הליקוט.

4. זיהוי ומיפוי סוג המשלוח

התוסף קורא את שיטת המשלוח שנבחרה בקופה וממפה אותה למערכת eHouse:

• איסוף עצמי (PICKUP): משויך אוטומטית כאשר נבחרת שיטת Local Pickup, נקודות חלוקה, או שיטות הכוללות את המילים "איסוף" / "pickup". ניתן להוסיף מזהים מותאמים אישית מתוספי משלוח צד-שלישי.

• משלוח עד הבית (HOME): מוגדר כברירת מחדל לכל יתר השיטות.

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

5. הגדרת מסגרת זמן למשלוח (Delivery Timeframe)

ניתן לבחור בהגדרות בין רמת דחיפות רגילה (STANDARD), מהירה (EXPRESS) או מהיום להיום (SAME_DAY). הנתון נשלח בבקשת היצירה והעדכון כדי להבטיח טיפול ב-SLA המתאים.

6. העברת נתוני נמען מלאים

הפרטים הנשלחים ל-eHouse כוללים:

• שם מלא (מכתובת למשלוח, עם גיבוי מכתובת לחיוב).

• טלפון וכתובת דואר אלקטרוני.

• כתובת מלאה (רחוב, דירה/כניסה, עיר, מיקוד, מדינה).

• שם חברה (עבור הזמנות עסקיות).

• הערות הלקוח בקופה (מועברות כהערות להזמנה במחסן).

7. סנכרון פרטי מוצרים מורחבים

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

8. מניעת שידור כפול (Idempotency)

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

9. תיבת ניהול וכפתור "שדר שוב"

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

• אם ההזמנה טרם שודרה — הבלחיצה תבצע יצירה ושידור.

• אם ההזמנה כבר קיימת ב-eHouse — הבקשה תבצע עדכון אישור בלבד, ללא כפילות.

10. מנגנון ניסוי חוזר חכם (Tolerant Retry)

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

11. תיעוד ולוגים

• הערות הזמנה בווקומרס: תיעוד בזמן אמת של סטטוס השידור, מזהה ההזמנה שנוצר או הודעות שגיאה.

• יומן טכני: רישום מלא של קריאות ה-API תחת WooCommerce > סטטוס > יומנים (מקור: wm-ehouse-dispatch), כולל מזהה ייחודי (correlation ID) לכל בקשה.

12. התאמה טכנולוגית ואבטחה

• HPOS: תמיכה מלאה ב-High-Performance Order Storage ובאחסון נתונים קלאסי.

• דרישות מערכת: PHP 7.4 ומעלה, WooCommerce 6.0 ומעלה.

• אבטחה: אימות HTTP Basic מול ה-API, תקשורת מוצפנת ב-HTTPS, והגנה על פעולות ידניות באמצעות nonces והרשאות מנהל.

• ממשק: תמיכה מלאה בכיווניות מימין לשמאל (RTL) בעברית.

• Hooks למפתחים: אפשרות להתאמת ה-payload ושינוי לוגיקת המשלוח באמצעות פילטרים מובנים (wm_ehouse_order_payload, wm_ehouse_confirm_payload, wm_ehouse_is_pickup_order).

זרימת העבודה (Workflow)

1. הגדרה ראשונית: הזנת מפתחות ה-API, בחירת סטטוס הטריגר ומסגרת זמן המשלוח.

2. סימון מוצרים: סימון המוצרים המיועדים לטיפול ב-eHouse.

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

שאלות נפוצות

האם כל מוצר בהזמנה משודר ל-eHouse?

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

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

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

האם נדרש אישור ידני בממשק eHouse לאחר השידור?

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

כיצד מטופלים מוצרים עם וריאציות (גודל/צבע)?

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

האם התוסף תומך ב-HPOS?

כן, התוסף מותאם לעבודה עם HPOS וגם עם מבנה בסיס הנתונים הקלאסי של ווקומרס.

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

למידע נוסף והתקנת התוסף בחנות הווקומרס שלכם, צרו קשר עם WeManage.