# 常見問題

# 什麼是 client merchant id?在創建訂單時,需要傳入店鋪地址嗎?

client_merchant_id 是在對接方系統內店鋪的唯一 ID 。在對接前期,Zeek 團隊會向商家索取店鋪資料,例如店鋪 ID、名稱、地址等,client_merchant_id 包含其中。Zeek 團隊會把店鋪資料輸入到 Zeek 平台中。

在創建訂單時,開發者只需要在 API-3.3.1 訂單創建 傳入 client_merchant_id 參數,Zeek 平台會利用 client_merchant_id 配對 Zeek 平台內的店鋪資料,所以不需要傳入店鋪地址。

# 什麼是取件碼 (pickup code)

當配送員接受訂單時,他會在 Zeek Partner App 收到取件碼。當他到達店鋪時,店員需要利用取件碼來核對配送員是否正確。所以,在商家展示給店員的後台 (eg POS) 中,需要顯示取件碼。

取件碼必須是 4 位數字。另外,在同一個店鋪內,取件碼必須是唯一(或是足夠唯一,例如在同一天內的取件碼不會重覆)。

# 如何使用派店接口

"派店" 指由系統因應地理位置、商家營業狀態等條件,決定指派哪一間店鋪給用戶的程序,一般發生在創建訂單前。

派店程序涉及以下幾個 APIs:

# API 3.1.4 更新商家狀態

更新商家狀態,例如營業時間、營業狀態等等。這裡涉及的商家設置,只影響派店程序。在訂單創建時,系統不會檢查商家營業狀態。

# API 3.1.5 更新所有商家營業緩衝時間

更新旗下所有商家的營業緩衝時間。這裡涉及的商家設置,只影響派店程序。在訂單創建時,系統不會檢查商家營業狀態。

# API-3.2.4 可配送商家

用途:為用戶選取支持配送的商家。

接口操作:輸入一個用戶地理位置,因應派店邏緝,返回可以支持配送的商家(店鋪)。

# API-3.2.1 商家是否可配送

用途:檢查一個商家是否可以為用戶所在的地理位置配送。

接口操作:輸入一個用戶地理位置,以及一個商家 ID,因應派店邏緝,檢查並返回該商家是否可以配送。

# 如何傳入用戶位置和地址

在一些請求接口 (例如 API-3.3.1 訂單創建),開發者需要傳入 用戶地址 (user_address)用戶位置座標 (user_location)用戶地址ID (user_address_id) 等參數,這裡會說明如何傳入這些參數。

# 用戶地址 (user_address)

這是用戶的完整地址,其中用途是給予配送員前往收件地的指示。故此,地址內容應該是清晰完整,例子:"#12-456, Woodlands, Singapore, 730779"

# 用戶位置座標 (user_location)

Zeek 平台使用座標來計算配送所需的資訊,例如預計時間。一般來說,座標參數都是必傳的。

# 用戶地址ID (user_address_id)

user_address_id 是 Zeek 平台提供的指定地址 ID。如果接口支持 user_address_id 參數的話, Zeek 平台指定的開發者可以傳入user_address_id 代替傳入 user_location