微信小程序 即时配送接口(商家查看)·开发必读
作者: --时间: 2025-05-17 19:53:06
阅读量：
微信小程序即时配送接口（商家查看）·开发必读
1. 商家接入准备
在接入即时配送服务之前，商家需要进行以下步骤：
- 完成微信认证；
- 设置事件地址并开通事件推送；
- 选择安全模式作为消息加密方式，并将数据格式选为JSON；
- 如已授权给第三方，则无需完成第二步；
- 在配送公司注册账号，并将其与小程序授权绑定。
2. 名称解释
下面是一些相关术语的解释：
- appkey：商家在登录配送公司开放平台后分配的appkey值；
- AppSecret：商家在登录配送公司开放平台后分配的对应秘钥；
- shopid：微信平台字段，对应配送公司的appkey；
- shop_no：商家对不同门店进行的编号，需在配送公司系统中登记；
- shop：下单请求中包含了商家信息，会展示到物流通知消息中。
3. 调用API接口说明
下单请求需要使用绑定的shopid和AppSecret，其中shopid为配送公司账号的appkey值，AppSecret为配送公司账号的对应秘钥。除此之外，请注意以下几点：
- 编码方式为UTF-8；
- 数据格式为JSON；
- 提交方式为POST；
- 所有调用订单相关的API接口都需要带上运力侧签名delivery_sign。
运力侧签名规则如下：
- 如果接口请求里有字段shop_order_id，则delivery_sign=SHA1(shopid + shop_order_id + AppSecret)；
- 如果请求里没有shop_order_id字段，则delivery_sign=SHA1(shopid + AppSecret)。
举个例子：当shopid=“test_shop_id”，shop_order_id =“test_shop_order_id”，AppSecret=“test_app_secrect”时， delivery_sign=“a93d8d6bae9a9483c1b1d4e8670e7f6226ec94cb”。
4. 错误码说明
在调用API接口发生错误时，请根据错误码来确定具体原因。以下是可能出现的错误码和对应的错误描述：
| 错误码 | 错误描述 |
|---|---|
| 930555 | 微信平台系统错误 |
| 930556 | 配送公司超时 |
| 930557 | 配送公司系统错误 |
| 930558 | 配送公司逻辑错误 |
| 930559 | openid无效 |
| 930560 | 未绑定的商户号 |
| 930561 | 参数错误 |
扫码免费领取运营资料包
多用户商城平台系统