# 批量码作废

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

- 多码批量作废时，调用此接口

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

- 一次可以多码作废,一次最多20个码。

#### **action**

- `BatchCodeUpdate`

**请求参数，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-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>requestId</td><td>String</td><td>是</td><td>请求流水号</td><td>32个字符，用于标识唯一一笔交易</td></tr><tr><td>codeArray</td><td>List</td><td>是</td><td>码号数组</td><td> </td></tr><tr><td>saleChannelId</td><td>Long</td><td>否</td><td>取码方id</td><td> </td></tr><tr><td>saleChannelOrderId</td><td>String</td><td>否</td><td>取码方制码订单号</td><td>当codeArray无值时取该订单号下所有串码进行作废。当订单号有值时取码方id必填</td></tr><tr><td>callBackUrl</td><td>String</td><td>是</td><td>激活成功后的回调地址</td><td> </td></tr><tr><td>updateShopNo</td><td>String(10)</td><td>否</td><td>激活门店号</td><td> </td></tr><tr><td>updateOrg</td><td>String(10)</td><td>否</td><td>激活机构</td><td> </td></tr><tr><td>optTag</td><td>String(2)</td><td>是</td><td>操作分类</td><td>B1：批量作废</td></tr></tbody></table>

**请求报文举例**

```
{
    "requestId":"20181019112535100000000000000001",
    "codeArray": ["10215523190570712621"],
    "callBackUrl": "http://test.com/api/codeVoid",
    "optTag": "B1",
}

```

**同步返回参数，[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-0"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>returnCode</td><td>String</td><td>是</td><td>请求返回码</td><td> </td></tr><tr><td>returnMsg</td><td>String</td><td>是</td><td>请求返回信息</td><td> </td></tr><tr><td>data</td><td>Object&lt;[statusUpdateData](https://book.e-buy.com/books/e-buy-40/page/598b3 "statusUpdateData")&gt;</td><td>是</td><td>批量码作废初步校验返回</td></tr></tbody></table>

**同步返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "操作成功",
    "data": {
        "requestId": "10000000000000000000002",
        "tradeNo": "10000000000000000000002",
        "codeNum": 1
    }
}

```

**回调返回参数，[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-1" style="height: 122px;"><thead><tr style="height: 29px;"><th style="height: 29px; width: 87.0938px;">字段</th><th style="height: 29px; width: 238.734px;">类型</th><th style="height: 29px; width: 73px;">是否必填</th><th style="height: 29px; width: 143px;">字段意义</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: 238.734px;">String</td><td style="height: 29px; width: 73px;">是</td><td style="height: 29px; width: 143px;">请求返回码</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: 238.734px;">String</td><td style="height: 29px; width: 73px;">是</td><td style="height: 29px; width: 143px;">请求返回信息</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: 238.734px;">Object&lt;[statusUpdateCallbackData](https://book.e-buy.com/books/e-buy-40/page/15438 "statusUpdateCallbackData")&gt;</td><td style="height: 35px; width: 73px;">否</td><td style="height: 35px; width: 143px;">码状态更新返回数据</td></tr></tbody></table>

**回调返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "SUCCESS",
    "data": {
        "tradeNo": "9e22d9a9e532435db77bccdfd8a74ee5",
        "requestId": "20181019112535100000000000000008",
        "totalCodeNum": 1,
        "successCodeNum": 1,
        "codeArray": [{
            "codeId": "1212431432",
            "searchCode": "100***1234",
            "codeSecret": "100213321414112234",
            ...
            }],
    }
}
```