# 常見問題
# 什麼是 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
。