# 配送相關
# 配送流程
以下是 Zeek 外賣配送的基本流程:
- 由 Zeek 指派店鋪(派店)
- 獲取報價
- 用戶在 App 下單
- 創建配送訂單
- Zeek 指派配送員
- 配送員接單
- 配送員前往發件地(商家/店鋪)
- 配送員到達發件地
- 配送中,配送員前往收件地 (用戶位置)
- 配送員到達收件地附近
- 用戶收件,訂單完成
# 標準 API 流程
請參考以下的標準API 流程圖,此圖展示一個外賣 App 下單的流程,以及過程中建議調用的接口。
]
# 訂單狀態碼
在外賣配送流程中,系統會以訂單狀態碼來記錄訂單當前的狀態。開發者可以透過訂單狀態回調接口來獲取即時的狀態,以下是狀態碼的說明。
訂單狀態碼 | 描述 | 在回調接口返回 |
---|---|---|
9001 | 訂單已創建 | No |
9005 | 配送員已接單 | Yes |
9010 | 配送員已到達店鋪附近 | Yes |
9011 | 配送員已到店 | Yes |
9015 | 訂單正在配送中 | Yes |
9017 | 配送員已到達目的地附近 | Yes |
9021 | 訂單已完成 | Yes |
9025 | 訂單已取消 - 取餐前 | Yes |
9026 | 訂單已取消 - 取餐後 | Yes |
8001 | 已指派另一位配送員 | No 如開發者需要這個回調狀態,請與 Zeek 團隊聯絡。 |
8012 | 配送員已離店 | Yes |
# 訂單取消碼
當訂單被取消時,系統會以取消碼標示取消原因。取消碼 可以在 API-3.4.1 訂單查詢、API-3.4.1 訂單查詢 - 以用戶電話查詢 和 API-3.9.1 訂單狀態更新回調 中獲取。
取消碼 | 描述 |
---|---|
7001 | 指派超時 |
7002 | 寄方原因 |
7003 | 收方原因 |
7004 | 配送方原因 |
7005 | 訂單資料錯誤 |
7006 | 測試訂單 |
7007 | 其他原因 |
# 預測配送時間 (ETA)
在配送流程中,商家通常需要獲取流程中各時段的預計時長,以協助實際營運操作。另一方面,透過提供預計配送時間,用戶可以知道所預訂的餐飲會在何時送達,提升用戶體驗。故此,Zeek 建立了以下機器學習預計時間模型,以滿足商家產品需求。開發者可以透過調用 Open API,以獲取即時預計時間結果。
# 預計接單時間 (Accept time)
定義:在商家創建訂單前,假若向 Zeek 平台發佈一個訂單,預計需要多少時間才有配送員接下該訂單。
建議使用場景:在店內的下單介面顯示,讓店員知道預計接單時間。
接口:API-3.2.3
# 預計到店時間 (Showup time)
定義:在配送員接單後,預計配送員需要多少時間到達發件地 (商家/店鋪)。
建議使用場景:在店內的下單介面顯示,讓店員知道預計到店時間。
接口:API-3.4.2
# 預計完成時間 (Quote time)
定義:在商家創建訂單前,假若向 Zeek 平台發佈一個訂單,預計該訂單需要多少時間送達收件地 (用戶位置)。
建議使用場景:在給用戶的介面上顯示,讓他在下單前知道預計完成時間。
接口:API-3.2.2
# 預計送達時間 (Delivery time)
定義:在訂單創建後,預計當前訂單需要多少時間送達收件地 (用戶位置)。
建議使用場景:在給用戶的介面上顯示,他的訂單在何時送達。
接口:API-3.4.3
← Zeek斑馬即送簡介 開發說明 →