immediateDelivery.onOrderStatus

本文档描述服务器端接收的消息或事件,详细说明参见消息推送

配送单配送状态更新通知接口

消息参数

Object

属性类型说明
ToUserNamestring快递公司小程序 UserName
FromUserNamestring微信团队的 OpenID (固定值)
CreateTimenumber事件时间,Unix时间戳
MsgTypestring消息类型,固定为 event
Eventstring事件类型,固定为 update_waybill_status,不区分大小写
shopidstring商家id, 由配送公司分配的appkey
shop_order_idstring唯一标识订单的 ID,由商户生成
shop_nostring商家门店编号, 在配送公司侧登记
waybill_idstring配送单id
action_timenumberUnix时间戳
order_statusnumber配送状态,枚举值
action_msgstring附加信息
agentObject骑手信息

agent 的结构

属性类型说明
namestring骑手姓名
phonestring骑手电话
reach_timenumber预计送达时间戳, 配送中返回

消息返回

属性类型默认值必填说明
ToUserNamestring原样返回请求中的 FromUserName
FromUserNamestring快递公司小程序 UserName
CreateTimenumber事件时间,Unix时间戳
MsgTypestring消息类型,固定为 event
Eventstring事件类型,固定为 update_waybill_status,不区分大小写
resultcodenumber错误码
resultmsgstring错误描述

使用场景

当配送公司更新订单配送状态时,微信会通过本接口同步通知商户

消息数据包示例

JSON 格式

  1. {
  2. "ToUserName": "toUser",
  3. "FromUserName": "fromUser",
  4. "CreateTime": 1546924844,
  5. "MsgType": "event",
  6. "Event": "update_waybill_status",
  7. "shopid": "123456",
  8. "shop_order_id": "123456",
  9. "waybill_id": "123456",
  10. "action_time": 1546924844,
  11. "order_status": 102,
  12. "action_msg": "",
  13. "shop_no": "123456",
  14. "agent": {
  15. "name": "xxx",
  16. "phone": "1234567"
  17. }
  18. }