微信小程序 即時(shí)配送接口(商家查看)·開(kāi)發(fā)必讀
微信小程序即時(shí)配送接口（商家查看）·開(kāi)發(fā)必讀
1. 商家接入準(zhǔn)備
在接入即時(shí)配送服務(wù)之前，商家需要進(jìn)行以下步驟：
- 完成微信認(rèn)證；
- 設(shè)置事件地址并開(kāi)通事件推送；
- 選擇安全模式作為消息加密方式，并將數(shù)據(jù)格式選為JSON；
- 如已授權(quán)給第三方，則無(wú)需完成第二步；
- 在配送公司注冊(cè)賬號(hào)，并將其與小程序授權(quán)綁定。
2. 名稱(chēng)解釋
下面是一些相關(guān)術(shù)語(yǔ)的解釋?zhuān)?
- appkey：商家在登錄配送公司開(kāi)放平臺(tái)后分配的appkey值；
- AppSecret：商家在登錄配送公司開(kāi)放平臺(tái)后分配的對(duì)應(yīng)秘鑰；
- shopid：微信平臺(tái)字段，對(duì)應(yīng)配送公司的appkey；
- shop_no：商家對(duì)不同門(mén)店進(jìn)行的編號(hào)，需在配送公司系統(tǒng)中登記；
- shop：下單請(qǐng)求中包含了商家信息，會(huì)展示到物流通知消息中。
3. 調(diào)用API接口說(shuō)明
下單請(qǐng)求需要使用綁定的shopid和AppSecret，其中shopid為配送公司賬號(hào)的appkey值，AppSecret為配送公司賬號(hào)的對(duì)應(yīng)秘鑰。除此之外，請(qǐng)注意以下幾點(diǎn)：
- 編碼方式為UTF-8；
- 數(shù)據(jù)格式為JSON；
- 提交方式為POST；
- 所有調(diào)用訂單相關(guān)的API接口都需要帶上運(yùn)力側(cè)簽名delivery_sign。
運(yùn)力側(cè)簽名規(guī)則如下：
- 如果接口請(qǐng)求里有字段shop_order_id，則delivery_sign=SHA1(shopid + shop_order_id + AppSecret)；
- 如果請(qǐng)求里沒(méi)有shop_order_id字段，則delivery_sign=SHA1(shopid + AppSecret)。
舉個(gè)例子：當(dāng)shopid=“test_shop_id”，shop_order_id =“test_shop_order_id”，AppSecret=“test_app_secrect”時(shí)， delivery_sign=“a93d8d6bae9a9483c1b1d4e8670e7f6226ec94cb”。
4. 錯(cuò)誤碼說(shuō)明
在調(diào)用API接口發(fā)生錯(cuò)誤時(shí)，請(qǐng)根據(jù)錯(cuò)誤碼來(lái)確定具體原因。以下是可能出現(xiàn)的錯(cuò)誤碼和對(duì)應(yīng)的錯(cuò)誤描述：
| 錯(cuò)誤碼 | 錯(cuò)誤描述 |
|---|---|
| 930555 | 微信平臺(tái)系統(tǒng)錯(cuò)誤 |
| 930556 | 配送公司超時(shí) |
| 930557 | 配送公司系統(tǒng)錯(cuò)誤 |
| 930558 | 配送公司邏輯錯(cuò)誤 |
| 930559 | openid無(wú)效 |
| 930560 | 未綁定的商戶號(hào) |
| 930561 | 參數(shù)錯(cuò)誤 |
立即掃碼關(guān)注
多用戶商城平臺(tái)系統(tǒng)