immediateDelivery.onOrderStatus
本文档描述服务器端接收的消息或事件,详细说明参见消息推送。
配送单配送状态更新通知接口
消息参数
Object
属性 | 类型 | 说明 |
---|---|---|
ToUserName | string | 快递公司小程序 UserName |
FromUserName | string | 微信团队的 OpenID (固定值) |
CreateTime | number | 事件时间,Unix时间戳 |
MsgType | string | 消息类型,固定为 event |
Event | string | 事件类型,固定为 update_waybill_status,不区分大小写 |
shopid | string | 商家id, 由配送公司分配的appkey |
shop_order_id | string | 唯一标识订单的 ID,由商户生成 |
shop_no | string | 商家门店编号, 在配送公司侧登记 |
waybill_id | string | 配送单id |
action_time | number | Unix时间戳 |
order_status | number | 配送状态,枚举值 |
action_msg | string | 附加信息 |
agent | Object | 骑手信息 |
agent 的结构
属性 | 类型 | 说明 |
---|---|---|
name | string | 骑手姓名 |
phone | string | 骑手电话 |
reach_time | number | 预计送达时间戳, 配送中返回 |
消息返回
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
ToUserName | string | 是 | 原样返回请求中的 FromUserName | |
FromUserName | string | 是 | 快递公司小程序 UserName | |
CreateTime | number | 是 | 事件时间,Unix时间戳 | |
MsgType | string | 是 | 消息类型,固定为 event | |
Event | string | 是 | 事件类型,固定为 update_waybill_status,不区分大小写 | |
resultcode | number | 是 | 错误码 | |
resultmsg | string | 是 | 错误描述 |
使用场景
当配送公司更新订单配送状态时,微信会通过本接口同步通知商户
消息数据包示例
JSON 格式
{
"ToUserName": "toUser",
"FromUserName": "fromUser",
"CreateTime": 1546924844,
"MsgType": "event",
"Event": "update_waybill_status",
"shopid": "123456",
"shop_order_id": "123456",
"waybill_id": "123456",
"action_time": 1546924844,
"order_status": 102,
"action_msg": "",
"shop_no": "123456",
"agent": {
"name": "xxx",
"phone": "1234567"
}
}