电子凭证批量核销

接口用途 

 批量核销电子凭证，多张电子凭证核销交易； 

 接口地址 

 https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/ecouponsVerify 

 action 

 ecouponsVerify 

 请求参数，中间件===>易百后台 

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 traceNo 

 String 

 是 

 收银机流水号 

 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 

 onlineTid 

 String 

 否 

 线上对接使用的统一终端号 

 对接前需提前和易百技术沟通 

 totalAmount 

 Price 

 是 

 交易总金额 

 单位：元 

 undiscountAmount 

 Price 

 是 

 不可打折金额 

 单位：元，没有填写0 

 verifyType 

 String 

 是 

 核销类型 

 请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景 

 scene 

 String 

 否 

 支付场景 

 条码:bar_code, 二维码:qr_code 

 orderSubject 

 String 

 否 

 订单标题 

 最长256 

 orderDescription 

 String 

 否 

 订单描述 

 最长256 

 ecoupons 

 List< codeInfo > 

 是 

 批量核销劵码 

 批量核销必填,一次最多10张券 

 goodsDetail 

 List< goodsDetail > 

 否 

 产品明细 

 验证产品明细时必填 

 memberDetail 

 Object< memberDetail > 

 否 

 会员信息 

 会员支付时必填 

 请求报文举例 

 {

 "traceNo": "99000009100010101732123",

 "totalAmount": 40.8,

 "undiscountAmount": 0,

 "activityProductNo": "HDCP00000000001234",

 "qrcode": "280123121234567890",

 "lockTime": "300",

 "afterLock": "0",

 "ecoupons": [

 {

 "code": "10019041500000071521",

 "ext": "test"

 }

 ],

 "goodsDetail": [

 {

 "goodsCategory": "001",

 "goodsId": "P00001",

 "goodsName": "牙膏",

 "price": 8,

 "quantity": 2,

 "rebateCode": "000"

 },

 {

 "goodsCategory": "101",

 "goodsId": "P00002",

 "goodsName": "洗发水",

 "price": 24.8,

 "quantity": 1,

 "rebateCode": "000"

 }

 ],

 "memberDetail": {

 "memberId": "M000001545",

 "memberName": "TONY",

 "grade": "1",

 "status": "1",

 "balance": 1000,

 "pointBalance": 30000

 }

} 

 返回参数，易百后台===>中件间 

 可能返回 活动产品选项 ，需要进行选择 

 字段 

 类型 

 是否必填 

 字段意义 

 备注 

 traceNo 

 String 

 是 

 收银机流水号 

 不允许重复 

 orderNo 

 String 

 是 

 交易订单号 

 易百生成 

 transDate 

 String 

 是 

 交易时间 

 格式为：yyyyMMddHHmmss 

 returnCode 

 String 

 是 

 返回码 

 00表示本次请求成功，并不代表所有码都核销成功 

 returnDesc 

 String 

 是 

 返回信息 

 交易结果描述或错误原因 

 ecouponsData 

 List< ecouponsData > 

 是 

 返回批量核销结果 

 对应批量核销劵 

 extendsData 

 Object< extendsData > 

 是 

 扩展信息 

 与ebuy约定  allSuccess=false表示本次核销有券码核销失败 

 返回报文举例 

 {

 "transDate": "20220726153110",

 "returnCode": "00",

 "extendsData": {},

 "orderNo": "191990113248",

 "invoiceAmount": 0,

 "ecouponsData": [

 {

 "returnCode": "00",

 "desc": "操作成功",

 "status": "00",

 "invoiceAmount": 0,

 "code": "10010605284819524875",

 "receiptAmount": 10,

 "activityProductNo": "00000000503057",

 "transType": "whaleAuth",

 "activityProductName": "85°C10元代金券",

 "goodsDetail": [

 {

 "goodsSpec": "00",

 "goodsId": "A00001",

 "activityNo": "EB11060200",

 "price": 1000,

 "memo": "10010605284819524875",

 "quantity": 1

 }

 ],

 "totalAmount": 68,

 "paidAmount": 10,

 "fundChannel": [

 {

 "channelName": "用户实际支付",

 "channelAmount": 0,

 "channelNo": "user_real_money"

 }

 ]

 },

 {

 "returnCode": "00",

 "desc": "操作成功",

 "status": "00",

 "invoiceAmount": 0,

 "code": "10010605171871824601",

 "receiptAmount": 10,

 "activityProductNo": "00000000503057",

 "transType": "whaleAuth",

 "activityProductName": "85°C10元代金券",

 "goodsDetail": [

 {

 "goodsSpec": "00",

 "goodsId": "A00001",

 "activityNo": "EB11060200",

 "price": 1000,

 "memo": "10010605171871824601",

 "quantity": 1

 }

 ],

 "totalAmount": 68,

 "paidAmount": 10,

 "fundChannel": [

 {

 "channelName": "用户实际支付",

 "channelAmount": 0,

 "channelNo": "user_real_money"

 }

 ]

 }

 ],

 "paidAmount": 0,

 "traceNo": "20220726153107100000000SH20501",

 "uuid": "f3c32fa32ccb4ccd8f38c36800741682",

 "receiptAmount": 0,

 "returnDesc": "请求成功",

 "step": "01"

}