Webhook להזמנות
עם Webhook להזמנות, Coi שולחת את פרטי ההזמנה, בפורמט JSON, לכתובת שתגדירו, ברגע שההזמנה נקלטת. כך אפשר להעביר הזמנות למערכת אחרת בלי להקליד אותן מחדש.
1. איפה מגדירים
בממשק הניהול, היכנסו ל"חנות" ← "הגדרות החנות" ← לשונית "רכישה". הדביקו את הכתובת בשדה "Webhook להזמנות" ושמרו.
השדה מופיע רק כשהאפשרות "אפשר רכישה/הזמנה בחנות" מופעלת. ההזמנה נשלחת תמיד ב-POST.
2. מתי ההזמנה נשלחת
1 תשלום באשראי, בביט או ב-PayPal: רק אחרי שהתשלום אושר. הזמנה שלא שולמה לא נשלחת.
2 הזמנה טלפונית ("השלמת פרטים טלפונית"): מיד עם ההזמנה, עם הסימון שהיא עוד לא שולמה.
3 עריכת הזמנה או שינוי הסטטוס שלה לא שולחים אותה שוב. ההזמנה נשלחת פעם אחת, כשהיא נקלטת.
3. מה נשלח
אלה השדות העיקריים בהזמנה:
| שדה | תוכן |
|---|---|
| OrderNumber | מספר ההזמנה, כפי שמוצג לכם וללקוח |
| CreateDate | תאריך ושעת ההזמנה |
| FullName, Phone, Email, Address | פרטי הלקוח |
| UserNotes | הערות הלקוח להזמנה |
| Total | הסכום לתשלום |
| DeliveryName, DeliveryPrice | אפשרות המשלוח שנבחרה והמחיר שלה |
| CouponCode | קוד הקופון, אם הוזן |
| PayType, Paid | אמצעי התשלום, והאם ההזמנה שולמה |
| StatusName | סטטוס ההזמנה |
| Cart | רשימת המוצרים: שם, מק"ט, אפשרויות, מחיר וכמות |
| Form | השדות שהלקוח מילא בטופס ההזמנה |
לדוגמה, בקיצור:
"OrderNumber": "1234",
"FullName": "ישראל ישראלי",
"Phone": "050-1234567",
"Total": 930.00,
"PayType": "credit_card",
"Paid": true,
"Cart": [
{ "ProductID": 777, "Name": "סמארטפון", "Sku": "sm8887", "Price": 900, "Quantity": 1 },
{ "ProductID": -1, "Name": "משלוח עד הבית", "Price": 30, "Quantity": 1 }
]
}
אם המערכת השנייה לא זמינה, Coi מנסה לשלוח שוב, עד 7 פעמים במשך 3 שעות. ההזמנה עצמה נקלטת בחנות בכל מקרה. כל Webhook נשלח עם חתימה בכותרת X-Coi-Signature, ואת סוד החתימה מוצאים מתחת לשדה ה-Webhook.
4. Webhook לרישום לקוחות
בחנות שמאפשרת ללקוחות להירשם, אפשר לקבל גם כל לקוח חדש: בהגדרות החנות, בלשונית "כללי", בשדה "Webhook לאחר רישום משתמש". השדה מופיע כשהאפשרות "אפשר רישום ללקוחות" מופעלת.
לכתובת נשלחים ב-POST השם, האימייל, הטלפון, והאם הלקוח אישר לקבל דיוור (name, email, phone, getNewsletter).
