阅读(3031) (0)

微信小程序 小程序使用·onOrderStatus

2020-07-29 13:38:29 更新

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 格式

{
  "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"
  }
}