Skip to main content

电子凭证批量核销

接口用途

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

接口地址

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

action

  • ecouponsVerify

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

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
totalAmountPrice是交易总金额单位：元
undiscountAmountPrice是不可打折金额单位：元，没有填写0
activityProductNoString否活动产品编号二次交互时填写
sceneString否支付场景条码:bar_code, 二维码:qr_code
orderSubjectString否订单标题最长256
orderDescriptionString否订单描述最长256
ecouponsList<codeInfo>是批量核销劵码批量核销必填,一次最多10张券
goodsDetailList<goodsDetail>否产品明细验证产品明细时必填
memberDetailObject<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
    }
}

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

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复
orderNoString是交易订单号易百生成
transDateString是交易时间格式为：yyyyMMddHHmmss
returnCodeString是返回码00表示交易成功，其他表示失败
returnDescString是返回信息交易结果描述或错误原因
ecouponsDataList<ecouponsData>是返回批量核销结果对应批量核销劵

返回报文举例

{
"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