批量码核销
接口用途
- 多码批量核销时，调用此接口
接口说明
- 一次可以多码核销,一次最多10个码。
action
BatchCodesVerify
请求参数，CHANNEL===>WHALE
| 字段 | 类型 | 是否必填 | 字段意义 | 备注 |
|---|---|---|---|---|
| verifyScene | String | 是 | 交易场景.offline线下,online线上 | 线上也可以传抖音、美团等 |
| codes | List | 是 | 码号数组 | |
| verifyCodes | List<codeArr> | 否 | 指定券码阶梯价序号 | |
| isProductCheck | String | 是 | 是否校验订单产品规则 | 是Y，否N |
| requestId | String | 是 | 请求流水号确保永久唯一性 | 32位长度 |
| refNo | String | 否 | 系统参考号 | 12位长度 |
| cashierTransNo | String | 否 | 收银机流水号 | 最长64位长度 |
| storeInfo | Object<storeInfo> | 否 | 此信息为线下门店核销时上送 | 线下核销必填 |
| cashTotalAmount | Number | 否 | 订单总金额 | 单位：分 |
| goodsDetail | List<goodsDetail> | 否 | (只有在收银POS上发起交易时才上送) | |
| remark | String | 否 | 备注（在核销撤销、核销查询等接口原样返回） |
请求报文举例
{
"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"
}]
}
返回参数，WHALE===>CHANNEL
| 字段 | 类型 | 是否必填 | 字段意义 | 备注 |
|---|---|---|---|---|
| returnCode | String | 是 | 请求返回码 | 返回码32时，请调用单码核销查询接口CodeVerifyQuery，确认核销结果 |
| returnMsg | String | 是 | 请求返回信息 | |
| data/checkResult | Object<data/checkResult> | 是 | 券码核销信息明细返回 |
返回报文举例
{
"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枚举
| 字段 | 字段意义 | 备注 |
|---|---|---|
| 00 | 可使用 | |
| 01 | 已使用 | |
| 03 | 未激活 | 未激活的码需调用激活接口才能 |
| 04 | 已冻结 | |
| 05 | 已作废 | |
| 06 | 已过期 | |
| 07 | 未生效 | 当制码时选择次日生效，核销时会返回该状态 |
| 09 | 码不存在 | |
| 10 | 券码状态异常，券码无效 | |
| 23 | 商户商品号传送错误 | |
| 26 | 券码不能在本门店使用 | |
| C1 | 商户号门店信息有误 | |
| C2 | 商户无权限 | |
| T2 | 易百调用第三方失败 | |
| A4 | 其他异常 |
No Comments