זמן אספקה ועמלות

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

המדריך הזה עוסק בנושאים הבאים:

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

לדוגמת פיד מלאה שמציגה שימוש בזמן אספקת ההזמנה ובעמלות, ראו דוגמה של EPA להפניה אוטומטית מסוג Ordering Redirect.

עלויות

אנחנו מספקים כמה דרכים שונות לציין עמלות, למשל:

• עמלה קבועה: "דמי משלוח בסך 20 ש"ח" או "עמלת שירות בסך 20 ש"ח"
• עמלת אחוז: "דמי משלוח 5%" או "עמלת שירות 5%"
• טווחי עמלות: "דמי משלוח $2-$10" או "דמי שירות 3%-6%"
• טווחים פתוחים שהסתיימו "דמי משלוח החל מ-5%" או "עמלות שירות עד 80 ש"ח"

אפשר לציין עמלות כדמי משלוח או כדמי שירות. אפשר גם לציין כמה עמלות (למשל, 'עמלת שירות בסך 5% עד 10%, דמי משלוח בסך 20 ש"ח").

אין תמיכה בתרחישים לדוגמה שבהם צריך לשנות עמלות בהתאם למידע על המשתמש.

דוגמאות לעמלות

דמי משלוח ואיסוף

האפליקציה תומכת בסוגי העמלות 'delivery' ו-'SERVICE'.

משלוח

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

שירות

{
  "fee": {
    "fee_id": "12345/service_fee",
    "fee_type": "SERVICE",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

סוגי עמלות שונים

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

קבוע

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

אחוז עגלות הקניות

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "cart_percentage": {
      "base_value": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "percentage_of_cart_value": 10
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

טווח

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "range_amount": {
      "min_amount": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "max_amount": {
        "currency_code": "USD",
        "units": 5,
        "nanos": 600000000
      }
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

ימי אספקה

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

• זמנים קבועים: "משלוח בעוד 30 דקות" או "איסוף בעוד 15 דקות"
• טווחי זמן: "משלוח בתוך 30 דקות עד שעה" או "איסוף בעוד 15-20 דקות"

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

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

דוגמאות לזמן אספקה

זמן האספקה של ההזמנה לקישורים לפעולות כלול בהודעה של פיד השירותים ETA, כחלק מהשדה FoodOrderingService.

קבוע

{
    "service": {
        "service_id": "service-id",
        "service_type": "TAKEOUT",
        "parent_entity_id": "entity-id",
        "lead_time": {
            "min_lead_time_duration": "900s"
        },
        "action_link_id": "action-link-id"
    }
},

טווח זמן

{
    "service": {
        "service_id": "service-id",
        "service_type": "TAKEOUT",
        "parent_entity_id": "entity-id",
        "lead_time": {
            "min_lead_time_duration": "900s"
            "max_lead_time_duration": "1200s"

        },
        "action_link_id": "action-link-id"
    }
},

רמת הדיוק של העמלות וזמני האספקה

דיוק העמלות

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

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

אם לא ברור לך בדיוק מה נדרש במקרה שלך, עליך לפנות לאיש הקשר שלך ב-Actions Center.

דיוק במועד אספקת ההזמנה

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

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

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

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

אם לא ברור לך מה נדרש במקרה שלך, עליך לפנות לאיש הקשר שלך ב-Actions Center.

עדכונים קבועים בעמלות ובזמן ההגעה המשוער

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

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