# 批量码核销

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

- 多码批量核销时，调用此接口

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

- 一次可以多码核销,一次最多10个码。

#### **action**

- `BatchCodesVerify`

**请求参数，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-v" style="height: 302px; width: 690px;"><thead><tr style="height: 29px;"><th style="height: 29px; width: 173px;">字段</th><th style="height: 29px; width: 89px;">类型</th><th style="height: 29px; width: 73px;">是否必填</th><th style="height: 29px; width: 251px;">字段意义</th><th style="height: 29px; width: 104px;">备注</th></tr></thead><tbody><tr style="height: 29px;"><td style="height: 29px; width: 173px;">verifyScene</td><td style="height: 29px; width: 89px;">String</td><td style="height: 29px; width: 73px;">是</td><td style="height: 29px; width: 251px;">交易场景.offline线下,online线上</td><td style="height: 29px; width: 104px;">线上也可以传抖音、美团等</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 173px;">codes</td><td style="height: 29px; width: 89px;">List</td><td style="height: 29px; width: 73px;">是</td><td style="height: 29px; width: 251px;">码号数组</td><td style="height: 29px; width: 104px;"> </td></tr><tr><td style="width: 173px;">verifyCodes</td><td style="width: 89px;">List&lt;[codeArr](https://book.e-buy.com/books/e-buy-40/page/cfa08)&gt;</td><td style="width: 73px;">否</td><td style="width: 251px;">指定券码阶梯价序号</td><td style="width: 104px;">  
</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 173px;">isProductCheck</td><td style="height: 29px; width: 89px;">String</td><td style="height: 29px; width: 73px;">是</td><td style="height: 29px; width: 251px;">是否校验订单产品规则</td><td style="height: 29px; width: 104px;">是Y，否N</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 173px;">requestId</td><td style="height: 29px; width: 89px;">String</td><td style="height: 29px; width: 73px;">是</td><td style="height: 29px; width: 251px;">请求流水号确保永久唯一性</td><td style="height: 29px; width: 104px;">32位长度</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 173px;">refNo</td><td style="height: 29px; width: 89px;">String</td><td style="height: 29px; width: 73px;">否</td><td style="height: 29px; width: 251px;">系统参考号</td><td style="height: 29px; width: 104px;">12位长度</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 173px;">cashierTransNo</td><td style="height: 29px; width: 89px;">String</td><td style="height: 29px; width: 73px;">否</td><td style="height: 29px; width: 251px;">收银机流水号</td><td style="height: 29px; width: 104px;">最长64位长度</td></tr><tr style="height: 35px;"><td style="height: 35px; width: 173px;">storeInfo</td><td style="height: 35px; width: 89px;">Object&lt;[storeInfo](https://book.e-buy.com/books/e-buy-40/page/6f492 "storeInfo")&gt;</td><td style="height: 35px; width: 73px;">否</td><td style="height: 35px; width: 251px;">此信息为线下门店核销时上送</td><td style="height: 35px; width: 104px;">线下核销必填</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 173px;">cashTotalAmount</td><td style="height: 29px; width: 89px;">Number</td><td style="height: 29px; width: 73px;">否</td><td style="height: 29px; width: 251px;">订单总金额</td><td style="height: 29px; width: 104px;">单位：分</td></tr><tr style="height: 35px;"><td style="height: 35px; width: 173px;">goodsDetail</td><td style="height: 35px; width: 89px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-40/page/1d7f7-Fbe "goodsDetail")&gt;</td><td style="height: 35px; width: 73px;">否</td><td style="height: 35px; width: 251px;">(只有在收银POS上发起交易时才上送)</td><td style="width: 104px;"> </td></tr><tr><td style="width: 173px;">remark</td><td style="width: 89px;">[String](https://book.e-buy.com/books/c20ad/page/17d63)</td><td style="width: 73px;">否</td><td style="width: 251px;">备注（在核销撤销、核销查询等接口原样返回）</td><td style="width: 104px;"> </td></tr></tbody></table>

**请求报文举例**

```
{
    "verifyScene": "online",
    "codes": [
        "10215523190570712621"
    ],
    "requestId": "20181019112535100000000000000001",
    "refNo": "181215430700",
    "cashierTransNo": "42441908138100007498001",
    "storeInfo": {
        "cityId": "1012",
        "shopNo": "C00001",
        "shopName": "上海浦东测试门店",
        "manageCompany": "上海浦东测试店管理公司",
        "companyId": "218"
    },
    "cashTotalAmount": "20000",
    "goodsDetail": [
        {
            "sku": "1112343",
            "qty": 1,
            "price": 3000,
            "type": "03",
            "spec": "03"
        },
        {
            "sku": "1212342",
            "qty": 1,
            "price": 3500,
            "type": "03",
            "spec": "03"
        }
    ],
    "remark": {
        "oms": "test001"
    }
}
```

**返回参数，[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"><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>返回码32时，请调用单码核销查询接口CodeVerifyQuery，确认核销结果</td></tr><tr><td>returnMsg</td><td>String</td><td>是</td><td>请求返回信息</td><td> </td></tr><tr><td>data/checkResult</td><td>Object&lt;[data/checkResult](https://book.e-buy.com/books/e-buy-40/page/1afa3 "data")&gt;</td><td>是</td><td>券码核销信息明细返回</td></tr></tbody></table>

**返回报文举例**

```
{
    "requestId": "10000000000000000000002",
    "returnCode": "00",
    "returnMsg": "操作成功",
    "data": {
        "verifyResult":[{
              "code":"1021242013780905000",
              "saleChannelCode":"990001",
              "saleChannelCode":"易百码",
              "status":"00",
              "fundsChannel": {
                      "discountAmount": 3000,
                      "merchantRealAmount":0.0,
                      "channelBenefit": 0.0,
                      "merchantBenefit": 0.0
              },
              "faceValue":3000,
              "ticketId":"3",
              "ticketName":"30元现金抵价券",
              "returnCashParam":{
                    "tenderCode":"135"
              }
        },{
              "code":"1021242013780905000",
              "saleChannelCode":"990001",
              "saleChannelCode":"易百码",
              "status":"06",
              "fundsChannel": {
                    "discountAmount": 1000,
                    "merchantRealAmount":0.0,
                    "channelBenefit": 0.0,
                    "merchantBenefit": 0.0
              },
              "faceValue":1000,
              "ticketId":"6",
              "ticketName":"10元现金抵价券",
              "returnCashParam":{
                    "tenderCode":"132"
              }
        }]
    }
}

```

#### **status枚举**

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-00-%E5%8F%AF%E4%BD%BF%E7%94%A8-01"><thead><tr><th>字段</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>00</td><td>可使用</td></tr><tr><td>01</td><td>已使用</td></tr><tr><td>03</td><td>未激活</td><td>未激活的码需调用激活接口才能</td></tr><tr><td>04</td><td>已冻结</td></tr><tr><td>05</td><td>已作废</td></tr><tr><td>06</td><td>已过期</td><td> </td></tr><tr><td>07</td><td>未生效</td><td>当制码时选择次日生效，核销时会返回该状态</td></tr><tr><td>09</td><td>码不存在</td></tr><tr><td>10</td><td>券码状态异常，券码无效</td></tr><tr><td>23</td><td>商户商品号传送错误</td></tr><tr><td>26</td><td>券码不能在本门店使用</td></tr><tr><td>C1</td><td>商户号门店信息有误</td></tr><tr><td>C2</td><td>商户无权限</td></tr><tr><td>T2</td><td>易百调用第三方失败</td></tr><tr><td>A4</td><td>其他异常</td></tr></tbody></table>