Skip to main content

电子凭证查询

电子凭证查询

接口用途

  • 在中间件未收到后台返回时查询电子凭证的产品信息，可抵用的金额以调用此接口查询原交及所属的活动，支持易的状态百自有电子凭证和第三方电子凭证。

接口地址

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

action

  • inquiryecouponInquiry

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

字段 类型 是否必填 字段意义 备注
traceNo String 是 收银机流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
originalTraceNoqrcode String 是 原收银机流水电子凭证号 传入需要查询的原交易收银机流水电子凭证号
originalDateString否原交易日期传入需要查询的原交易日期，不传默认为当天格式为yyyyMMdd

请求报文举例

{
    "traceNo": "9900000910001014320150201"9900000910001013620150201",
    "originalTraceNo"qrcode": "9900000910001014220150201",
    "originalDate": "20170912"HDCP00000000001235"
}

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

字段 类型 是否必填 字段意义 备注
traceNo String 是 收银机流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
orderNo String 是 交易订单号 单位：元
transDate String 是 交易时间 格式为：yyyyMMddHHmmss
returnCode String 是 返回码 00表00，C3表示交易成功券码可用，其他表示失败不可用
returnDesc String 是 返回信息 交易结果描述或错误原因
paidAmountcanPayAmount Price 是 支付成功可抵用的总金额 单位：元
receiptAmountPrice否商户实收金额单位：元
invoiceAmountPrice否商户开票金额单位：元
exchangeRateNumber(8,6)否汇率1外币等于多少人民币
currencyString否货币类型例如:CNY
discountCodeString否折扣编码由收银机分配，用于入账计折扣类型
discountNumNumber否固定金额折扣数量用于入账计折扣类型的数量
tenderCodeString否支付方式编码由收银机分配，用于入账计支付方式
activityProductNo String 否 活动产品编号  该电子凭证所属的活动产品编号
activityProductName String 否 活动产品名称  
needSameCardBoolean否同一张卡支付如满额立减类该电子凭证所属的活动，需要同一张银行卡支付剩余金额
goodsDetailList<goodsDetail>否折抵产品明细返回后台已抵扣成功的产品明细
fundChannelList<fundChannel>否资金渠道 
printDetailObject<printDetail>否打印信息如需要在收银小票上打印信息时必填
memberDetailObject<memberDetail>否会员信息返回本次交易的会员信息
voucherDetailList<voucherDetail>否优惠券信息返回本次交易的优惠券信息名称
extendsData Object<extendsData> 否 扩展信息 与ebuy约定

返回报文举例

{
    "traceNo": "9900000910001014420150201"9900000910001013720150201",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "paidAmount"canPayAmount": 40.8,
    "receiptAmount": 40.8,
    "invoiceAmount": 40.8,
    "exchangeRate": 6.0939,
    "currency": "CNY",
    "discountCode": "0001",
    "discountNum": 20,
    "tenderCode": "8001",
    "activityProductNo": "2016123102"2016123101",
    "activityProductName": "支付宝支付",
    "needSameCard": true,
    "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",
        "pointSale": "20000",
        "qrCode1": "htt://www.api-location-url.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": "信365权益"
},
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    },
    "voucherDetail": [
        {
            "voucherId": "001",
            "voucherName": "现金优惠券",
            "voucherType": "现金",
            "voucherCode": "123456789",
            "channelAmount": "20.8"
        },
        {
            "voucherId": "002",
            "voucherName": "买一赠一优惠券",
            "voucherType": "买赠",
            "voucherCode": "1232136781",
            "channelAmount": "20.8"
        }
    ]
}

支持查询的交易

  • cardPayment
  • cardRedemption
  • qrcodeSale
Back to top