# 配送相關

# 配送流程

以下是 Zeek 外賣配送的基本流程:

  1. 由 Zeek 指派店鋪(派店)
  2. 獲取報價
  3. 用戶在 App 下單
  4. 創建配送訂單
  5. Zeek 指派配送員
  6. 配送員接單
  7. 配送員前往發件地(商家/店鋪)
  8. 配送員到達發件地
  9. 配送中,配送員前往收件地 (用戶位置)
  10. 配送員到達收件地附近
  11. 用戶收件,訂單完成

# 標準 API 流程

請參考以下的標準API 流程圖,此圖展示一個外賣 App 下單的流程,以及過程中建議調用的接口。

image]

# 訂單狀態碼

在外賣配送流程中,系統會以訂單狀態碼來記錄訂單當前的狀態。開發者可以透過訂單狀態回調接口來獲取即時的狀態,以下是狀態碼的說明。

訂單狀態碼 描述 在回調接口返回
9001 訂單已創建 No
9005 配送員已接單 Yes
9010 配送員已到達店鋪附近 Yes
9011 配送員已到店 Yes
9015 訂單正在配送中 Yes
9017 配送員已到達目的地附近 Yes
9021 訂單已完成 Yes
9025 訂單已取消 - 取餐前 Yes
9026 訂單已取消 - 取餐後 Yes
8001 已指派另一位配送員 No
如開發者需要這個回調狀態,請與 Zeek 團隊聯絡。
8012 配送員已離店 Yes

image

# 訂單取消碼

當訂單被取消時,系統會以取消碼標示取消原因。取消碼 可以在 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

image

# 預計到店時間 (Showup time)

定義:在配送員接單後,預計配送員需要多少時間到達發件地 (商家/店鋪)。

建議使用場景:在店內的下單介面顯示,讓店員知道預計到店時間。

接口:API-3.4.2

image

# 預計完成時間 (Quote time)

定義:在商家創建訂單前,假若向 Zeek 平台發佈一個訂單,預計該訂單需要多少時間送達收件地 (用戶位置)。

建議使用場景:在給用戶的介面上顯示,讓他在下單前知道預計完成時間。

接口:API-3.2.2

image

# 預計送達時間 (Delivery time)

定義:在訂單創建後,預計當前訂單需要多少時間送達收件地 (用戶位置)。

建議使用場景:在給用戶的介面上顯示,他的訂單在何時送達。

接口:API-3.4.3

image