API

Webhook להזמנות

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

עם 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 }
  ]
}
שורות עם מספר מוצר שלילי ב-Cart אינן מוצרים: -1 הוא המשלוח, -2 הקופון ו--6 המבצע. הרשימה המלאה של השדות - בתיעוד של Coi API.

אם המערכת השנייה לא זמינה, Coi מנסה לשלוח שוב, עד 7 פעמים במשך 3 שעות. ההזמנה עצמה נקלטת בחנות בכל מקרה. כל Webhook נשלח עם חתימה בכותרת X-Coi-Signature, ואת סוד החתימה מוצאים מתחת לשדה ה-Webhook.

4. Webhook לרישום לקוחות

בחנות שמאפשרת ללקוחות להירשם, אפשר לקבל גם כל לקוח חדש: בהגדרות החנות, בלשונית "כללי", בשדה "Webhook לאחר רישום משתמש". השדה מופיע כשהאפשרות "אפשר רישום ללקוחות" מופעלת.

לכתובת נשלחים ב-POST השם, האימייל, הטלפון, והאם הלקוח אישר לקבל דיוור (name, email, phone, getNewsletter).

מדיניות פרטיותהצהרת נגישות
Coi בניית אתרים

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