批量码核销

接口用途 

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

 接口说明 

 一次可以多码核销,一次最多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"

 }

 ],

 "remark": {

 "oms": "test001"

 }

} 

 返回参数， 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 

 其他异常