微信小程序 运力方使用·onOrderCancel
作者: --时间: 2022-09-29
阅读量:
使用微信小程序的运力方onOrderCancel来取消订单,以下为详细说明:
1. 消息参数
服务器端接收的消息或事件,详见消息推送。
Object 类型参数包括:
- ToUserName(string类型):快递公司小程序 UserName。
- FromUserName(string类型):微信团队的OpenID(固定值)。
- CreateTime(number类型):事件时间,Unix时间戳。
- MsgType(string类型):消息类型,固定为event。
- Event(string类型):事件类型,固定为transport_cancel_order,不区分大小写。
- shopid(string类型):商家id,由配送公司分配,可以是dev_id或者appkey。
- shop_order_id(string类型):唯一标识订单的ID,由商户生成。
- shop_no(string类型):商家门店编号,在配送公司侧登记。
- waybill_id(string类型):配送单ID。
- delivery_sign(string类型):用配送公司侧提供的appSecret加密的校验串。
- cancel_reason_id(number类型):取消原因ID。
- cancel_reason(string类型):取消原因。
cancel_reason_id 的合法值参照下表:
| 值 | 说明 | 最低版本 |
|---|---|---|
| 1 | 暂时不需要邮寄 | |
| 2 | 价格不合适 | |
| 3 | 订单信息有误,重新下单 | |
| 4 | 骑手取货不及时 | |
| 5 | 骑手配送不及时 | |
| 6 | 其他原因( 如果选择6,需要填写取消原因,否则不需要填写 ) |
2. 消息返回
返回消息的属性包括:
- ToUserName(string类型):原样返回请求中的FromUserName。
- FromUserName(string类型):快递公司小程序 UserName。
- CreateTime(number类型):事件时间,Unix时间戳。
- MsgType(string类型):消息类型,固定为 event。
- Event(string类型):事件类型,固定为 transport_cancel_order,不区分大小写。
- resultcode(number类型):错误码。
- resultmsg(string类型):错误描述。
- deduct_fee(number类型):扣除的违约金(单位:元),可能没有。
- desc(string类型):扣费说明。
3. 功能介绍
运力方onOrderCancel功能可以实现取消订单操作,取消逻辑参照各配送公司取消规则。
在使用微信小程序的运力方onOrderCancel前需要注意:
- 商家id需要由配送公司分配并在侧登记。
- 唯一标识订单ID由商户生成。
- 商家门店编号需要在配送公司侧登记。
- 取消原因选择时按照上述表格填写。
- 如选择其他原因,则需要填写取消原因,否则不需填写。

