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

במדריך הזה נסביר:

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

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

תרחישים לדוגמה לשימוש בעמלות ובזמן האספקה

תרחישים לדוגמה לשימוש בעמלות

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

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

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

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

תרחישים לדוגמה מסוג זמן אספקה

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

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

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

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

ציון מועד אספקת ההזמנה דרך פידים

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

זמן אספקה קבוע

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

הודעה זו צריכה להיות בפורמט הבא:

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

זמן האספקה של הטווח

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

ההודעה צריכה להיות בפורמט הבא:

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

ציון עמלות באמצעות פידים

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

merchant.action_link.food_ordering_metadata.fee_details

בהמשך מפורטות כמה דוגמאות לתרחישים שונים לדוגמה.
  • דמי משלוח קבועים בסך 1.99$: 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • דמי משלוח באחוזים של 5.6%. 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]
  • עמלת שירות נעה בין 1.99 $ל-9.99 $
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]
  • שיעור עמלת השירות באחוזים נע בין 1.2% ל-2.7% 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]
  • שתי עמלות, עמלת שירות של $5 ודמי משלוח של 1.2%. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

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

דיוק העמלות

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

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

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

הדיוק של מועד מימוש ההזמנה

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

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

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

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

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