更新配送单状态
接口应在服务器端调用，详细说明参见服务端API。
接口说明
接口英文名
updateOrder
功能描述
该接口用于配送公司更新配送单状态。
调用方式
HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/express/local/delivery/update_order?access_token=ACCESS_TOKEN
请求参数
| 属性 | 类型 | 必填 | 说明 | |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证，该参数为 URL 参数，非 Body 参数。使用getAccessToken | |
| wx_token | string | 是 | 下单事件中推送的wx_token字段 | |
| order_status | number | 是 | 订单状态，枚举值，下附枚举值列表及说明 | |
| waybill_id | string | 是 | 配送单id | |
| action_msg | string | 否 | 附加信息 | |
| action_time | number | 是 | 状态变更时间点，Unix秒级时间戳 | |
| agent | object | 否 | 骑手信息, 骑手接单时需返回 | |
| 属性类型必填说明namestring是骑手姓名phonestring是骑手电话is_phone_encryptednumber否电话是否加密。默认是0不加密，1表示加密。 | ||||
| shopid | string | 是 | 商家id， 由配送公司分配，可以是dev_id或者appkey | |
| shop_order_id | string | 是 | 唯一标识订单的 ID，由商户生成 | |
| shop_no | string | 否 | 商家门店编号， 在配送公司侧登记 | |
| wxa_path | string | 是 | 配送公司小程序跳转路径，用于用户收到消息会间接跳转到这个页面 | |
| expected_delivery_time | number | 否 | 预计送达时间戳， 骑手接单时需返回 |
返回参数
| 属性 | 类型 | 说明 |
|---|---|---|
| resultcode | number | 错误码 |
| resultmsg | string | 错误描述 |
调用示例
示例说明: HTTPS调用
请求数据示例
{"wx_token":"","shopid":0,
"shop_order_id":"C1638702836167U4v252",
"shop_no":"6261889268017",
"waybill_id":"3436608931550646273",
"action_time":1638703215,
"order_status":202,
"action_msg":"",
"agent":{
"name":"李x利",
"phone":"1358xxxx",
"lng":112.2248390000000029,
"lat":22.690728000000000009
},
"wxa_path":"pages\/index\/index",
"expected_delivery_time":1638705236
}
返回数据示例
{
"resultcode": 0,
"resultmsg": "ok"
}
错误码
| 错误码 | 错误码取值 | 解决方案 |
|---|---|---|
| -1 | system error | 系统繁忙，此时请开发者稍候再试 |