# 单码核销通知

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

- 用于实现易百券核销成功后将核销状态通知到第三方系统

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

- 接口异步通知第三方

**请求参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===>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="width: 86.9136%; height: 476.75px;"><thead><tr style="height: 29.7969px;"><th style="width: 17.0055%; height: 29.7969px;">字段</th><th style="width: 7.5506%; height: 29.7969px;">类型</th><th style="width: 10.3693%; height: 29.7969px;">是否必填</th><th style="width: 32.2443%; height: 29.7969px;">字段意义</th><th style="width: 32.6372%; height: 29.7969px;">备注</th></tr></thead><tbody><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">requestId</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">核销流水号</td><td style="width: 32.6372%; height: 29.7969px;">小于64个字符</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">channelId</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">通知渠道</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">ticketId</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">券ID</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">ticketName</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">券名称</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">thirdActivityId</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">第三方活动id</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">code</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">券号</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">shopNo</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">否</td><td style="width: 32.2443%; height: 29.7969px;">门店编号</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">shopName</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">否</td><td style="width: 32.2443%; height: 29.7969px;">门店名称</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">verifyRefno</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">否</td><td style="width: 32.2443%; height: 29.7969px;">线下核销机具流水号</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">verifyTime</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">券核销时间</td><td style="width: 32.6372%; height: 29.7969px;">格式：yyyyMMddHHmmss</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">verifyType</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">核销类型</td><td style="width: 32.6372%; height: 29.7969px;">1表示POS机验证； 2表示接口验证；

999 表示不用通知上下游

</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">orderNo</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">制码订单号</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">orderItemId</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">是</td><td style="width: 32.2443%; height: 29.7969px;">制码子订单号，对接方唯一识别码</td><td style="width: 32.6372%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 17.0055%; height: 29.7969px;">discountAmount</td><td style="width: 7.5506%; height: 29.7969px;">String</td><td style="width: 10.3693%; height: 29.7969px;">否</td><td style="width: 32.2443%; height: 29.7969px;">核销折抵金额</td><td style="width: 32.6372%; height: 29.7969px;">单位分</td></tr></tbody></table>

**请求报文举例**

```
{
    "requestId": "10000000000000000000001",
    "ticketId":"9000000021",
    "ticketName":"汉堡王皇堡/天椒皇堡套餐[bobo测试取码方]",
    "thirdActivityId": "20190226134100",
    "code":"10112504119074937195",
    "shopNo":"1870002",
    "shopName":"家有好面龙阳路店",
    "verifyRefno":"178491000582",
    "verifyTime":"20181016103223",
    "verifyType":"1",
    "orderNo":"a1b626f8b39b4852bfaedc69cc4dbff5",
    "orderItemId":"10191f7aee084db8915dd77293a65906",
    "discountAmount":"2000"
}

```

**返回参数，[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>09 券码不存在

01 券码已使用

00 券码核销成功

</td></tr><tr><td>returnMsg</td><td>String</td><td>是</td><td>请求返回信息</td><td>  
</td></tr><tr><td>requestId</td><td>String</td><td>是</td><td>原样返回</td></tr></tbody></table>

**返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "操作成功",
    "requestId": "10000000000000000000001"
}
```