本教學課程將逐步說明:
- 詳細說明支援的費用和出貨時間
- 如何針對服務動態饋給指定訂單出貨時間和費用。
- 準確率的期望
如要查看完整動態饋給範例,其中顯示訂單出貨時間和費用,請參閱訂購重新導向 EPA 範例。
費用
我們提供幾種指定費用的方式,例如:
- 固定費用:「運費 $5 美元」或「服務費 $5 美元」
- 百分比費用:「運費 5%」或「服務費 5%」
- 費用範圍:「運費 $2 至 $10 美元」或「服務費 3%-6%」
- 開放式範圍「運費:5% 起」或「服務費最多 $20 美元」
費用可指定為運費或服務費。 您也可以指定多項費用 (例如「服務費 5%-10%,運費 $5 美元」)。
不支援根據使用者相關資訊變更費用的用途。
費用範例
外送和自取費
應用程式支援「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 分 - 1 小時後送達」或「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" } },
出貨時間範圍
您可以使用 ServiceHours
針對特定時間範圍設定出貨時間。非服務時段時,系統會使用 FoodOrderingService
中設定的預設 lead_time
。
2400s
的 lead_time
會從上午 11:00 顯示至下午 1:30。1200s
的 lead_time
會在上午 11:00 前和下午 1:30 後顯示。{ "data": [ { "service": { "service_id": "merchant-1-service-delivery", "service_type": "DELIVERY", "parent_entity_id": "merchant-1", "lead_time": { "min_lead_time_duration": "1200s" }, "action_link_id": "merchant-1-takeout-delivery-action" } }, { "service_hours": { "hours_id": "merchant-1-advance-hours-delivery", "service_ids": ["merchant-1-service-delivery"], "asap_hours": [ { "time_windows": { "time_windows": { "open_time": { "hours": 11 }, "close_time": { "hours": 13, "minutes": 30 } } }, "lead_time": { "min_lead_time_duration": "2400s" } } ] } } ] }
費用和出貨時間準確性
費用準確性
為商家提供費用資料時,我們希望您能以正確的方式呈現費用。您應該加入訂單可能收取的所有運費和服務費。
我們瞭解使用者的費用可能隨時間而異。因此,我們支援以範圍 (包括開放式範圍) 指定費用範圍。如果費用可能大幅變動,請務必確保所提供的費用範圍涵蓋使用者在交易期間可能看見的費用。
如果不確定自己屬於哪個必要項目,請洽詢您的 Actions Center 聯絡人。
訂單出貨時間準確性
我們瞭解訂單出貨時間的具體細節會因為多項因素而改變。這些因素包括:
- 訂單出貨時間變更 (以訂單大小為依據)
- 根據完成下單和結帳所需的時間變更訂單出貨時間
- 透過動態饋給更新訂單出貨時間異動之間的延遲時間
- 使用者的寄送地址。
上述任一因素都可能導致系統一開始向使用者顯示的訂單出貨時間,與結帳時顯示的確切出貨時間不同。設定出貨時間的目標並非完全消除,而是盡可能為使用者提供明確資訊。
合作夥伴應提供實作方式,盡可能向使用者顯示準確的出貨時間。如果作業時間因這些因素而出現顯著變化,建議您指定一段時間內的變化範圍。 此外,如果出貨時間因訂單詳細資料而變動,則應在訂餐流程中向使用者清楚顯示這項資訊。
如果不確定自己屬於哪個必要項目,請洽詢您的 Actions Center 聯絡人。
費用和預計到達時間即時更新
使用一般動態饋給上傳的所有變更,最久可能需要 2 小時才能處理完畢。如果您打算經常變更預計到達時間,就必須特別注意這一點。
強烈建議合作夥伴導入即時更新,讓 API 呼叫在 5 分鐘內變更服務動態饋給 (包含費用和預計到達時間)。