# 发码撤销

#### **接口用途**

- 当需要撤销某笔制码订单时，取码方调用此接口

#### **接口说明**

- 当对原制码订单进行撤销时，生成一个撤销订单。
- 对原订单进行撤销时，整单所制码都将被撤销。如需对单码撤销，调用电子凭证码状态更新接口。
- 此接口可对`同步单条发码`、`异步批量发码`下单接口订单进行撤销操作
- 对已撤销成功订单不能再次撤销
- 如果订单撤销部分成功时返回"tradeStatus"="P"
- 对订单中部分券码撤销成功时，可以按原制码订单号再次调用撤销接口，如还是部分撤销成功请联系易百技术方協助解决

#### **action**

- `MakeVoid`

**请求参数，CHANNEL===>[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-o"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>originalChannelOrderId</td><td>String</td><td>是</td><td>原取码方制码订单id</td><td>小于64个字符</td></tr><tr><td>requestId</td><td>String</td><td>是</td><td>请求流水号</td><td>32个字符，用于标识唯一一笔交易</td></tr></tbody></table>

**请求报文举例**

```
{
    "originalChannelOrderId": "20180912162026",
    "requestId":"20180912162026"
}

```

**返回参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;CHANNEL**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-r" style="height: 122px;"><thead><tr style="height: 29px;"><th style="height: 29px; width: 87.0938px;">字段</th><th style="height: 29px; width: 205.594px;">类型</th><th style="height: 29px; width: 73px;">是否必填</th><th style="height: 29px; width: 101px;">字段意义</th><th style="height: 29px; width: 45px;">备注</th></tr></thead><tbody><tr style="height: 29px;"><td style="height: 29px; width: 87.0938px;">returnCode</td><td style="height: 29px; width: 205.594px;">String</td><td style="height: 29px; width: 73px;">是</td><td style="height: 29px; width: 101px;">请求返回码</td><td style="height: 29px; width: 45px;"> </td></tr><tr style="height: 29px;"><td style="height: 29px; width: 87.0938px;">returnMsg</td><td style="height: 29px; width: 205.594px;">String</td><td style="height: 29px; width: 73px;">是</td><td style="height: 29px; width: 101px;">请求返回信息</td><td style="height: 29px; width: 45px;"> </td></tr><tr style="height: 35px;"><td style="height: 35px; width: 87.0938px;">data</td><td style="height: 35px; width: 205.594px;">List&lt;[makeVoidResponseData](https://book.e-buy.com/books/e-buy-40/page/05f97 "makeVoidResponseData")&gt;</td><td style="height: 35px; width: 73px;">否</td><td style="height: 35px; width: 101px;">码撤销信息</td></tr></tbody></table>

**返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "SUCCESS",
    "data": {
        "tradeNo": "9e22d9a9e532435db77bccdfd8a74ee5",
        "originalChannelOrderId": "20181018183139",
        "createDate": "20181018",
        "createTime": "20181018183454",
        "totalNum": 4,
        "tradeStatus": "A",
        "voidDetails": [{
            "ticketId": 1,
            "originalChannelItemId": "99000014001",
            "voidNum": 2
        }, {
            "ticketId": 2,
            "originalChannelItemId": "99000014002",
            "voidNum": 2
        }]
    }
}
```