Skip to main content

电子凭证批量核销

接口用途

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

接口地址

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

action

  • ecouponsVerify

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

字段 类型 是否必填 字段意义 备注
traceNo String 是 收银机流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
onlineTid String 否 线上对接使用的统一终端号 对接前需提前和易百技术沟通
totalAmount Price 是 交易总金额 单位：元
undiscountAmount Price 是 不可打折金额 单位：元，没有填写0
verifyType String 是 核销类型 请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景
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表示本次核销有券码核销失败

返回报文举例

{
  "transDate": "20220726153110",
  "returnCode": "00",
  "extendsData": {},
  "orderNo": "191990113248",
  "invoiceAmount": 0,
  "ecouponsData": [
    {
      "returnCode": "00",
      "desc": "操作成功",
      "status": "00",
      "invoiceAmount": 0,
      "code": "10010605284819524875",
      "receiptAmount": 10,
      "activityProductNo": "00000000503057",
      "transType": "whaleAuth",
      "activityProductName": "85°C10元代金券",
      "goodsDetail": [
        {
          "goodsSpec": "00",
          "goodsId": "A00001",
          "activityNo": "EB11060200",
          "price": 1000,
          "memo": "10010605284819524875",
          "quantity": 1
        }
      ],
      "totalAmount": 68,
      "paidAmount": 10,
      "fundChannel": [
        {
          "channelName": "用户实际支付",
          "channelAmount": 0,
          "channelNo": "user_real_money"
        }
      ]
    },
    {
      "returnCode": "00",
      "desc": "操作成功",
      "status": "00",
      "invoiceAmount": 0,
      "code": "10010605171871824601",
      "receiptAmount": 10,
      "activityProductNo": "00000000503057",
      "transType": "whaleAuth",
      "activityProductName": "85°C10元代金券",
      "goodsDetail": [
        {
          "goodsSpec": "00",
          "goodsId": "A00001",
          "activityNo": "EB11060200",
          "price": 1000,
          "memo": "10010605171871824601",
          "quantity": 1
        }
      ],
      "totalAmount": 68,
      "paidAmount": 10,
      "fundChannel": [
        {
          "channelName": "用户实际支付",
          "channelAmount": 0,
          "channelNo": "user_real_money"
        }
      ]
    }
  ],
  "paidAmount": 0,
  "traceNo": "20220726153107100000000SH20501",
  "uuid": "f3c32fa32ccb4ccd8f38c36800741682",
  "receiptAmount": 0,
  "returnDesc": "请求成功",
  "step": "01"
}
No Comments
Back to top
Entity Select