微信小程序开发文档 微信小程序 小程序使用·onOrderStatus

2024-02-25 开发教程 微信小程序开发文档 匿名 3

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