בסקירה הכללית הזו נסכם את התהליך המלא של ההזמנה ואת האינטראקציה שלו עם שירות האינטרנט שלך לטיפול בהזמנות.
סידור הסרטונים
ממשק המשתמש של תהליך ההזמנה מקצה לקצה מטפל בכל האינטראקציות עם המשתמש בזמן שהוא מוסיף פריטים מהתפריט להזמנה ומחליט אם לאסוף את ההזמנה או לקבל אותה במשלוח, בהתאם לשירותים שהמסעדה מציעה. החוויה הזו מבוססת על הישויות Restaurant, Service ו-Menu שנמצאות בפידים של הנתונים.
השלב הבא הוא שלב אימות עגלת הקניות, שבו שירות האינטרנט מעבד את הערך של Cart שנוצר על ידי המשתמש.
פעולת תשלום
פעולת התשלום היא הקריאה הראשונה ש-Google מבצעת לנקודת הקצה של שירות האינטרנט שלכם.
שירות האינטרנט שלכם אחראי על אימות ה-Cart. עליכם לאשר את הזמינות והמחירון של הפריטים, לחשב את המיסים, ההנחות והעמלות ולהחזיר אותם, ולאמת את הכתובת למשלוח ההזמנה.
תהליך התשלום מתבצע לפי הסדר הבא:
- השירות Ordering End-to-End שולח
CheckoutRequestMessageשמכילCartלנקודת הקצה של שירות האינטרנט של הטיפול בהזמנות. - שירות האינטרנט צריך לאמת את הפריטים ב-
Cartעל סמך המחירים, הזמינות וספקי השירות הנוכחיים. לאחר מכן מחשבים את המחיר הכולל, שכולל הנחות, מיסים ודמי משלוח. - נקודת הקצה תגיב עם
CheckoutResponseMessageשמכיל אתCartללא שינוי לבקשות שהצליחו. אפשר לכלולFoodErrorExtensionב-CheckoutResponseMessageכדי לדווח על שגיאת עיבוד או להציע שינויים קלים, במקרה הצורך.
אחרי שה-Cart מאומת, המשתמש יכול לבחור להמשיך לשלב שליחת ההזמנה בתהליך.
הפעולה 'שליחת הזמנה'
הפעולה 'שליחת הזמנה' מופעלת כשהמשתמש מבצע את ההזמנה. שירות האינטרנט צריך לאמת מחדש את עגלת הקניות, לעבד את אסימון הכרטיס אם התשלומים אונליין מופעלים ולבסוף לעדכן את סטטוס ההזמנה.
תהליך שליחת ההזמנה מתנהל לפי הסדר הבא:
- השירות Ordering End-to-End שולח
SubmitOrderRequestMessageשמכילOrderלנקודת הקצה של שירות האינטרנט של הטיפול בהזמנות. כדי להמשיך, הקצה העורפי צריך לבצע אימות נוסף שלCart. שירות האינטרנט מעבד את פרטי התשלום שמופיעים ב-
Order, בדרך כלל מבצע את הפעולות הבאות:- לבצע אימות של אסימונים, בדיקות של הונאות ובדיקות אחרות של כשירות.
- מאשרים את הכרטיס, ואם רוצים, גם מחייבים אותו.
נקודת הקצה תחזיר
SubmitOrderResponseMessageשמכילOrderUpdateעם המצבCREATED(סטטוס רכישה 'הוזמן'),CONFIRMED(סטטוס רכישה 'אושר') אוREJECTED(סטטוס רכישה 'נדחה').
אחרי שההזמנה תבוצע, המשתמש צפוי לקבל עדכונים לגבי סטטוס ההזמנה גם מכם וגם מממשק המשתמש של Ordering End-to-End. אתם נדרשים לשלוח למשתמש הודעת אישור על ההזמנה באימייל. בנוסף, אתם משתמשים ב-Asynchronous Order Update API כדי לשלוח ל-Google עדכונים רלוונטיים לגבי ההזמנות.
פעולת עדכון אסינכרוני של הזמנה
ללא קשר להתרעות למשתמשים מצדכם, עליכם גם לשלוח ל-Google עדכונים לגבי סטטוס ההזמנות במקרים הבאים:
- שינויים ב-
OrderState, כמו מעברים מ-CREATEDל-CONFIRMEDומ-CONFIRMEDל-IN_TRANSIT. - שינויים בפריטים בהזמנה, כמו מחיר או זמינות.
- בכל פעם שהמשתמש שולח בקשת תמיכה מאחת מהערוצים של תמיכת הלקוחות.
העדכונים נשלחים מנקודת הקצה של שירות האינטרנט בתור AsyncOrderUpdateRequestMessage שמכיל OrderUpdate. Google תגיב עם AsyncOrderUpdateResponseMessage.
תרשים רצף
באיור הבא מוצגת האינטראקציה בין פעולות המילוי לבין שירות האינטרנט שלכם. לוחצים כדי להגדיל.
הגדרת נקודת הקצה לטיפול בהזמנות
הפעולות של תהליך ההזמנה מקצה לקצה מתבססות על הודעות JSON כדי לתקשר עם שירות האינטרנט שלכם ולטפל בעיבוד, באישור ובעדכונים של הזמנות של אוכל. כשאתם מתכננים את שירות האינטרנט של Ordering End-to-End, עליכם להגדיר נקודת קצה של כתובת URL שמקבלת הודעות בקשה משירות Ordering End-to-End ויכולה להחזיר הודעות בחזרה לשירות Google. ההטמעה צריכה לעמוד בדרישות הבאות:
- שירות האינטרנט שלכם צריך להיות מסוגל לקבל הודעת JSON כבקשת
POSTמהשירות של תהליך ההזמנה מקצה לקצה. - שירות האינטרנט שלכם חייב לספק נקודת קצה של כתובת URL שגלויה לכולם, שנקראת כתובת URL לטיפול בהזמנות, שמציינים במרכז הפעולות. כתובת ה-URL לטיפול בהזמנות משמשת לביצוע תשלום ושליחת הזמנות. ההטמעה שלכם צריכה לטפל בשני סוגי הבקשות.
- שירות האינטרנט שלכם צריך להיות מסוגל לאמת הודעות מ-Google באמצעות השיטה אימות הודעות.
- ההטמעה של נקודת הקצה של כתובת ה-URL צריכה לאפשר לכם לטפל גם בתשלום וגם בהשלמת ההזמנה באמצעות נקודת קצה אחת. אי אפשר להשתמש בנקודת קצה אחת של כתובת URL לתשלום ובנקודת קצה נפרדת לשליחת הזמנה.
ספריות לקוח
הכלי ליצירת קוד לקוח בקטע 'כלים' זמין לאימות שירות האינטרנט שלכם בהתאם למפרט של Fulfillment API.