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> 是 返回批量核销结果 对应批量核销劵
extendsData Object<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