# 核销通知

## 基本信息

核销通知，易百将核销通知分发给渠道或者品牌，对接方需提供接口接收通知。

## 请求参数


### Headers

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D%E7%A7%B0-%E5%8F%82%E6%95%B0%E5%80%BC-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-conten" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr><td>参数名称</td><td>参数值</td><td>是否必填</td></tr><tr><td>Content-Type</td><td>application/json</td><td>是</td></tr><tr><td>  
</td><td>  
</td><td>  
</td></tr></tbody></table>

### Body

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D%E7%A7%B0-%E7%B1%BB%E5%9E%8B-%E5%BF%85%E5%A1%AB-%E9%BB%98%E8%AE%A4%E5%80%BC-%E5%A4%87%E6%B3%A8-%E5%85%B6%E4%BB%96" style="border-collapse: collapse; width: 100%; height: 1555.42px;"><colgroup><col style="width: 30.9796%;"></col><col style="width: 12.2862%;"></col><col style="width: 6.7938%;"></col><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col><col style="width: 16.6865%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">参数名称</td><td style="height: 29.7969px;">类型</td><td style="height: 29.7969px;">必填</td><td style="height: 29.7969px;">默认值</td><td style="height: 29.7969px;">备注</td><td style="height: 29.7969px;">其他信息</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">channelInfoList</td><td style="height: 29.7969px;">array</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">通知渠道列表</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_action</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">VerifyCodeNotify</td><td style="height: 46.5938px;">通知action</td><td style="height: 46.5938px;">最大长度：24  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_channelAppId</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">ebuy19915d0498cf</td><td style="height: 46.5938px;">通知渠道appId</td><td style="height: 46.5938px;">最大长度：24  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_channelId</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">ebuywha102410004</td><td style="height: 46.5938px;">通知渠道id</td><td style="height: 46.5938px;">最大长度：24  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_channelName</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">易百演示</td><td style="height: 46.5938px;">通知渠道名称</td><td style="height: 46.5938px;">最大长度：16  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_channelType</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">saleChannel</td><td style="height: 46.5938px;">通知渠道类型</td><td style="height: 46.5938px;">最大长度：12  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_messageType</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">ebuy</td><td style="height: 46.5938px;">通知消息格式</td><td style="height: 46.5938px;">最大长度：12  
最小长度：1</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_notifyType</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">Verify</td><td style="height: 46.5938px;">通知消息类型</td><td style="height: 46.5938px;">最大长度：12  
最小长度：1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_ticketIds</td><td style="height: 29.7969px;">array</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">券批次活动id</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_transferUrl</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">否</td><td style="height: 46.5938px;">通知渠道三方地址</td><td style="height: 46.5938px;">  
</td><td style="height: 46.5938px;">最大长度：255  
最小长度：1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">appId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">核销请求appid</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">uuid</td><td style="height: 63.3906px;">string</td><td style="height: 63.3906px;">是</td><td style="height: 63.3906px;">20220509-b485a27c80914357912b029a8a8f5f9b</td><td style="height: 63.3906px;">核销请求uuid</td><td style="height: 63.3906px;">最大长度：40  
最小长度：1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">verifyScene</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">online</td><td style="height: 29.7969px;">核销场景</td><td style="height: 29.7969px;">最大长度：8</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">items</td><td style="height: 29.7969px;">array</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_brandId</td><td style="height: 29.7969px;">number</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">4339</td><td style="height: 29.7969px;">品牌id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_brandTicketId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">品牌活动产品id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_cashierTransNo</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">收银机流水号</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_code</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">核销券码</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_outerOrderId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">外部制码订单号</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_outerOrderItemId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">外部制码子订单号</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_storeInfo</td><td style="height: 29.7969px;">object</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">核销上送门店信息</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_cityId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">城市id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_cityName</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">城市名称</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_companyId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">公司id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_companyName</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">工司名称</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_shopName</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">门店名称</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_shopNo</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">门店编号</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_terminalId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">核销终端id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_ticketId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">券批次id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_ticketName</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">券批次名称</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_userInfo</td><td style="height: 29.7969px;">object</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">制码用户信息</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"> |\_\_mobile</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">是</td><td style="height: 46.5938px;">  
</td><td style="height: 46.5938px;">制码上送用户手机号</td><td style="height: 46.5938px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_thirdUserId</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">制码上送用户id</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_thirdPlatformType</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">上送平台类型</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_uuid</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> |\_\_verifyTime</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">是</td><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">核销时间</td><td style="height: 29.7969px;">  
</td></tr></tbody></table>

### 请求示例

```json
{
    "channelInfoList": [
        {
            "notifyType": "Verify",
            "whaleChannel": false,
            "messageType": "ebuy",
            "channelAppId": "402410046",
            "serviceProvider": "",
            "action": "VerifyCodeNotify",
            "channelName": "博时基金",
            "channelType": "saleChannel",
            "channelVersion": "paas",
            "channelId": "ebuywha402410046",
            "ticketIds": [
                1000030005007
            ]
        }
    ],
    "appId": "ebuy1d0c0a81a9a4",
    "verifyScene": "default",
    "items": [
        {
            "userInfo": {

            },
            "cashierTransNo": "ttCN051001320241103002000",
            "code": "10032880473026297020",
            "fineGrainedLimit": {
                "current": 1,
                "limitMaxValue": 1,
                "grainedKey": "total"
            },
            "brandTicketId": "",
            "remainUseTimes": 0,
            "returnCashParam": "{\"paymentParam\":\"{\\\"discountCode\\\":\\\"bankCoupon\\\"}\",\"identifierMap\":\"\"}",
            "printData": "00|兑换产品:CoCo都可20元代金券 X 1|",
            "redeemSerialNum": 1,
            "verifyTime": 1730600279144,
            "uuid": "20241103-b00b98fc29544bae8597098e25c70ff7",
            "outerOrderId": "2410071450574725193200",
            "verifyId": "d0085990ca8c4225a8189780d129d7b7",
            "outerOrderItemId": "2410071450574725193200",
            "brandId": "1458",
            "fundsChannel": {
                "merchantRealAmount": 1500,
                "benefitAmount": 0,
                "merchantCustomBenefit": -1,
                "totalAmount": 2800,
                "merchantCustomRealAmount": -1,
                "channelBenefit": 0,
                "merchantBenefit": 0,
                "discountAmount": 2000,
                "channelCustomBenefit": -1,
                "userRealAmount": 0
            },
            "totalUseTimes": 1,
            "storeInfo": {
                "companyId": "171882",
                "cityName": "连云港",
                "merchantId": "860051827866564",
                "companyName": "连云港创高餐饮管理有限公司巨龙南路店",
                "shopName": "CoCo都可连云港巨龙南路店",
                "cityId": "299",
                "terminalId": "27866564",
                "shopNo": "CN0510013",
                "swift": "0"
            },
            "requestGoods": [
                {
                    "rebateCode": "000",
                    "price": 1500,
                    "qty": 1,
                    "sku": "CNAFIBCAA",
                    "type": "A"
                },
                {
                    "rebateCode": "000",
                    "price": 1300,
                    "qty": 1,
                    "sku": "CNAABLCAA",
                    "type": "A"
                }
            ],
            "ticketId": "1000030005007",
            "ticketName": "易百CoCo20元代金券"
        }
    ],
    "uuid": "20241103-b00b98fc29544bae8597098e25c70ff7",
    "createDate": 1730600279174
}
```

## 响应

### 响应参数

<table border="1" id="bkmrk-%E5%8F%82%E6%95%B0%E5%90%8D%E7%A7%B0-%E7%B1%BB%E5%9E%8B-%E5%BF%85%E5%A1%AB-%E9%BB%98%E8%AE%A4%E5%80%BC-%E5%A4%87%E6%B3%A8-%E5%85%B6%E4%BB%96-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col></colgroup><tbody><tr><td>参数名称</td><td>类型</td><td>必填</td><td>默认值</td><td>备注</td><td>其他信息</td></tr><tr><td>code</td><td>string</td><td>是</td><td>  
</td><td>响应码</td><td>  
</td></tr><tr><td>message</td><td>string</td><td>否</td><td>  
</td><td>响应消息</td><td>  
</td></tr></tbody></table>

### 响应示例

```json
{"code":"EB_SUCCESS","message":"操作成功"}
```

注意：

响应码不为<span style="background-color: rgb(251, 238, 184);">EB\_SUCCESS 或 <span style="background-color: rgb(251, 238, 184);">EB\_FAIL</span></span> 易百将会进行重试，请保证接口幂等性。

- <span style="background-color: rgb(251, 238, 184);">{"code":"EB\_SUCCESS","message":"操作成功"} // 业务处理成功，不重试</span>
- <span style="background-color: rgb(251, 238, 184);">{"code":"EB\_FAIL","message":"操作失败"} // 业务处理失败，不重试</span>
- <span style="background-color: rgb(251, 238, 184);">其他未知失败 // 重试</span>