Skip to main content

电子凭证批量核销

接口用途

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

接口地址

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

action

  • ecouponsVerify

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

字段 类型 是否必填 字段意义 备注
traceNo String 是 收银机流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
totalAmount Price 是 交易总金额 单位：元
undiscountAmount Price 是 不可打折金额 单位：元，没有填写0
verifyType String 是 核销类型 请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景
activityProductNo String 否 活动产品编号 二次交互时填写
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> 是 返回批量核销结果 对应批量核销劵
extendsDataObject<extendsData>是扩展信息与ebuy约定  allSuccess=false表示本次核销有券码核销失败

返回报文举例

{
"traceNo": "99000009100010101732123",
"orderNo": "171698602301",
"transDate": "20161231120533",
"returnCode": "00",
"returnDesc": "SUCCESS",
"ecouponsData":[
        {
                    "code":"10019041500000071521",
                    "status":"00",
                    "desc":"核销成功",
                    "paidAmount":40.8,
                    "receiptAmount":40.8,
                    "invoiceAmount":40.8,
                    "lockTime":"300",
                    "afterLock":"0",
                    "exchangeRate":6.0939,
                    "currency":"CNY",
                    "discountCode":"0001",
                    "discountNum":20,
                    "tenderCode":"8002",
                    "activityProductNo":"2016123102",
                    "activityProductName":"产品劵核销",
                    "goodsDetail":[
                        {
                            "goodsCategory":"001",
                            "goodsId":"P00001",
                            "goodsName":"牙膏",
                            "price":8,
                            "quantity":2,
                            "rebateCode":"000",
                            "activityNo":"2016123101",
                            "memo":"100123456789"
                        },
                        {
                            "goodsCategory":"101",
                            "goodsId":"P00002",
                            "goodsName":"洗发水",
                            "price":24.8,
                            "quantity":1,
                            "rebateCode":"000",
                            "activityNo":"2016123101",
                            "memo":"100123456789"
                        }
                    ],
                    "fundChannel":[
                        {
                            "channelNo":"001",
                            "channelName":"用户实付现金",
                            "channelAmount":"20.8"
                        },
                        {
                            "channelNo":"002",
                            "channelName":"用户积分支付",
                            "channelAmount":"20"
                        }
                    ],
                    "printDetail":{
                        "cardNo64":"622562****8888",
                        "bank":"中国银行",
                        "paymentOrderNo":"201612315689412157458787",
                        "paymentUser":"139****@163.com",
                        "pointSale":"20000",
                        "qrCode1":"htt://www.api-location-url.com/url",
                        "qrCode2":"",
                        "qrCode3":"",
                        "barCode1":"12345679",
                        "barCode2":"",
                        "barCode3":""
                    },
                    "memberDetail":{
                        "memberId":"M000001545",
                        "memberName":"TONY",
                        "grade":"1",
                        "status":"1",
                        "balance":1000,
                        "pointBalance":30000
                    }
        }
    ]
}
Back to top