Skip to main content

电子凭证批量核销

接口用途

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

接口地址

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

action

  • ecouponsVerify

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

字段类型是否必填字段意义备注
traceNoString是收银机流水号不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
totalAmountPrice是交易总金额单位：元
undiscountAmountPrice是不可打折金额单位：元，没有填写0
verifyTypeString是核销类型请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景
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>是返回批量核销结果对应批量核销劵
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