Skip to main content

批量核销结果查询

接口用途

  • 当调用批量核销接口超时未收到服务端返回时,可以调本接口来查询批量核销结果;

接口地址

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

action

  • BatchCodeVerifyQuery

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

字段 类型 是否必填 字段意义 备注
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
      }
    }
  ]
}