本教學課程將逐步說明：
- 簡要說明支援的費用和履行時間用途
- 服務動態饋給的訂單出貨時間和費用具體指定方式。
- 準確度期望
如需完整動態饋給範例，瞭解如何使用訂單出貨時間和費用，請參閱訂購重新導向 EPA 範例。
費用
我們提供多種指定費用的方式，例如：
- 固定費用：「運送費 $5」或「服務費 $5」
- 百分比費用：「外送費 5%」或「服務費 5%」
- 費用範圍：「運費 $2-$10」
- 無上限範圍「服務費最高 $20 美元」
費用可指定為運費或服務費。 你也可以指定多項費用 (例如「服務費 5%，運費 $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。
lead_time 的 2400s 會在上午 11 點到下午 1 點 30 分顯示。lead_time會在上午 11 點前和下午 1 點 30 分後顯示。1200s
{ "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 小時才能處理完畢。如果您打算經常變更預計到達時間，請務必注意這一點。
我們強烈建議合作夥伴導入即時更新，以便在 5 分鐘內透過 API 呼叫變更服務動態饋給 (包括費用和預計抵達時間)。