微信小程序 即時配送接口(商家查看)·開發(fā)必讀

開發(fā)必讀

商家接入準(zhǔn)備

1. 小程序進(jìn)行微信認(rèn)證
2. 開通事件推送，設(shè)置事件地址：登錄小程序后臺，開發(fā)->開發(fā)設(shè)置->消息推送->啟用
3. 消息加密方式使用安全模式，數(shù)據(jù)格式選JSON
4. 如果授權(quán)給第三方，則不需要步驟2
5. 在配送公司注冊帳號，并在小程序后臺進(jìn)行授權(quán)綁定

名稱解釋

1. appkey: 一般為商家在登錄配送公司開放平后分配的相應(yīng)的appkey值
2. AppSecret: 一般為商家在登錄配送公司開放平后分配的相應(yīng)的秘鑰
3. shopid：微信平臺字段，對應(yīng)配送公司的appkey
4. shop_no：商家對不同門店進(jìn)行的編號，需要在配送公司系統(tǒng)有過登記，比如商家自己門店系統(tǒng)中有100個門店，編號是1-100，在順豐同城的系統(tǒng)中有登記過這100個門店，且在順豐同城登記的編號也是1-100，那么下單的時候傳shop_no=1，就是編號為1 的門店下的配送單
5. shop：下單請求的一個字段，商家信息，會展示到物流通知消息中，如下圖所示
6. 下單請求的取貨碼和收貨碼：取貨碼是指騎手在商家這里取貨時，商家出示取貨碼，騎手才能完成取貨；收貨碼指騎手送達(dá)給用戶時，用戶出示收貨碼，騎手才算配送完成。商家可在配送公司開放平臺設(shè)置是否需要開啟取貨碼和收貨碼

調(diào)用api接口說明

1. 編碼方式：UTF-8
2. 數(shù)據(jù)格式：JSON
3. 提交方式：POST
4. 下單需要使用綁定的shopid和AppSecret，其中shopid即配送公司帳號的appkey，AppSecret即配送公司帳號對應(yīng)的秘鑰
5. resultcode錯誤碼和resultmsg錯誤描述由運(yùn)力方定義，微信側(cè)負(fù)責(zé)透傳，只統(tǒng)一定義code=0表示成功
6. 除了平臺本身的加解密和簽名，和訂單相關(guān)的請求還需要帶上運(yùn)力側(cè)簽名delivery_sign，簽名規(guī)則為
7. 如果接口請求里有字段shop_order_id ，則delivery_sign=SHA1(shopid + shop_order_id + AppSecret)，其中shopid對應(yīng)運(yùn)力側(cè)的appkey，shop_order_id對應(yīng)訂單id，AppSecret即配送公司帳號對應(yīng)的秘鑰
8. 如果請求里沒有字段shop_order_id ，則delivery_sign=SHA1(shopid + AppSecret)，其中shopid對應(yīng)運(yùn)力側(cè)的appkey，AppSecret即配送公司帳號對應(yīng)的秘鑰
9. 示例：shopid=“test_shop_id”，shop_order_id =“test_shop_order_id”， AppSecret=“test_app_secrect”，則delivery_sign=“a93d8d6bae9a9483c1b1d4e8670e7f6226ec94cb”

錯誤碼說明