# 取消订单

> 本文档描述服务器端接收的消息或事件，详细说明参见[消息推送](/miniprogram/dev/framework/server-ability/message-push.md)。

事件英文名：cancel_single_waybill

当用户取消订单，会发送此事件通知

## 1. 消息参数

### 请求体 `Request Payload`

```json
[
  {
    "参数名": "ToUserName",
    "类型": "string",
    "说明": "快递公司小程序 UserName",
    "枚举": "-"
  },
  {
    "参数名": "FromUserName",
    "类型": "string",
    "说明": "微信团队的 OpenID （固定值）",
    "枚举": "-"
  },
  {
    "参数名": "CreateTime",
    "类型": "number",
    "说明": "事件时间，Unix时间戳",
    "枚举": "-"
  },
  {
    "参数名": "MsgType",
    "类型": "string",
    "说明": "消息类型，固定为 event",
    "枚举": "-"
  },
  {
    "参数名": "Event",
    "类型": "string",
    "说明": "事件类型，固定为 cancel_single_waybill，不区分大小写",
    "枚举": "-"
  },
  {
    "参数名": "Token",
    "类型": "string",
    "说明": "下单接口传的Token",
    "枚举": "-"
  },
  {
    "参数名": "WXAppId",
    "类型": "string",
    "说明": "商户在微信端的appid",
    "枚举": "-"
  },
  {
    "参数名": "OrderID",
    "类型": "string",
    "说明": "商户订单 ID，可以使用token而不用这个字段",
    "枚举": "-"
  },
  {
    "参数名": "WayBillID",
    "类型": "string",
    "说明": "运单 ID，不一定有",
    "枚举": "-"
  },
  {
    "参数名": "CancelID",
    "类型": "number",
    "说明": "取消原因Id",
    "枚举": "枚举值"
  },
  {
    "参数名": "CancelReason",
    "类型": "string",
    "说明": "取消原因说明",
    "枚举": "-"
  }
]
```

## 2. 消息返回

### 返回体 `Response Payload`

```json
[
  {
    "参数名": "ToUserName",
    "类型": "string",
    "必填": "是",
    "说明": "原样返回请求中的 FromUserName"
  },
  {
    "参数名": "FromUserName",
    "类型": "string",
    "必填": "是",
    "说明": "快递公司小程序 UserName"
  },
  {
    "参数名": "CreateTime",
    "类型": "number",
    "必填": "是",
    "说明": "事件时间，Unix 时间戳"
  },
  {
    "参数名": "MsgType",
    "类型": "string",
    "必填": "是",
    "说明": "消息类型，固定为 event"
  },
  {
    "参数名": "Event",
    "类型": "string",
    "必填": "是",
    "说明": "事件类型，固定为 cancel_single_waybill，不区分大小写"
  },
  {
    "参数名": "ResultCode",
    "类型": "number",
    "必填": "是",
    "说明": "处理结果错误码"
  },
  {
    "参数名": "ResultMsg",
    "类型": "string",
    "必填": "否",
    "说明": "处理结果的详细信息"
  }
]
```

## 3. 枚举信息

### Body.CancelID `Enum`

取消原因Id

```json
[
  {
    "枚举值": "1",
    "描述": "不想寄了"
  },
  {
    "枚举值": "2",
    "描述": "下错单"
  },
  {
    "枚举值": "3",
    "描述": "重复下单"
  },
  {
    "枚举值": "4",
    "描述": "运费太贵"
  },
  {
    "枚举值": "5",
    "描述": "无人联系"
  },
  {
    "枚举值": "6",
    "描述": "取件太慢"
  },
  {
    "枚举值": "7",
    "描述": "态度差"
  },
  {
    "枚举值": "8",
    "描述": "其他原因"
  }
]
```

## 4. 注意事项

本事件无特殊注意事项

## 5. 代码示例

本事件无代码示例