# 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 配送状态,详见order_status 枚举值
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"
  }
}