# 单码核销

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

- 券码进行核销时，调用此接口

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

- 一次只能对一个码进行核销。

#### **action**

- `CodeVerify`

**请求参数，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"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>verifyScene</td><td>String</td><td>是</td><td>交易场景.offline线下,online线上</td><td> </td></tr><tr><td>code</td><td>String</td><td>是</td><td>码号</td><td> </td></tr><tr><td>isProductCheck</td><td>String</td><td>是</td><td>是否校验订单产品规则</td><td>是Y，否N</td></tr><tr><td>requestId</td><td>String</td><td>是</td><td>请求流水号确保永久唯一性</td><td>32位长度</td></tr><tr><td>refNo</td><td>String</td><td>否</td><td>系统参考号</td><td>12位长度</td></tr><tr><td>cashierTransNo</td><td>String</td><td>否</td><td>收银机流水号</td><td>最长64位长度</td></tr><tr><td>requestId</td><td>String</td><td>是</td><td>请求流水号确保永久唯一性</td><td>32位长度</td></tr><tr><td>storeInfo</td><td>Object&lt;[storeInfo](https://book.e-buy.com/books/e-buy-40/page/6f492 "storeInfo")&gt;</td><td>否</td><td>门店核销时上送，组合劵必填</td><td> </td></tr><tr><td>cashTotalAmount</td><td>Number</td><td>否</td><td>订单总金额（收银机总金额也是用此字段）</td><td>单位：分</td></tr><tr><td>goodsDetail</td><td>List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-40/page/1d7f7-Fbe "goodsDetail")&gt;</td><td>否</td><td>(只有在收银POS上发起交易时才上送)</td><td> </td></tr><tr><td>remark</td><td>String</td><td>否</td><td>备注（在核销撤销、核销查询等接口原样返回）</td><td> </td></tr></tbody></table>

**请求报文举例**

```
{
    "verifyScene":"offline",
    "code": "10215523190570712621",
    "requestId": "20181019112535100000000000000001",
    "refNo": "181215430700",
    "cashierTransNo": "42441908138100007498001",
    "storeInfo": {
        "cityId":"1012",
        "swift": "00105",
        "tid": "99000014",
        "mid": "99000013341001",
        "shopNo": "C00001",
        "storeName": "上海浦东测试门店",
        "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"
    }]
}

```

**返回参数，[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</td><td>Object&lt;[data](https://book.e-buy.com/books/e-buy-40/page/f7490 "data")&gt;</td><td>是</td><td>券码核销订单明细返回</td></tr></tbody></table>

**返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "操作成功",
    "requestId": "10000000000000000000002",
    "data": {
        "cashTotalAmount": 17800,
        "faceValue": 50000,
        "fundsChannel": {
            "totalAmount": 50000,
            "discountAmount": 50000,
            "merchantRealAmount": 40000,
            "channelBenefit": 10000,
            "merchantBenefit": 10000,
            "userRealAmount": 30000
        },
        "goodsDetail": [{
            "sku": "1212342",
            "qty": 1,
            "price": 3500,
            "type": "03",
            "spec": "03"
        }],
        "code": "10215523190570712621",
        "ticketId": "3",
        "ticketName": "50 元现金抵价券 ",
        "activityNo": "2017071951",
        "activityName": "联动优势电子凭证",
        "thirdActivityId": "20190226134100",
        "returnCashParam":{
            "tenderCode":"132"
        },
        "printData": "00|产品：测试券|00|团购价：100|00|订单号：100000000002100002|00|兑换码：101105********4289|"
    }
}
```