# 电子凭证预核销

### **接口用途**

- 预核销电子凭证，模拟电子凭证核销交易提前获取核销结果信息；

### **接口地址**

- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/ecouponPreVerify`

### **action**

- `ecouponPreVerify`

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

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t" style="width: 809px;"><thead><tr><th style="width: 138px;">字段</th><th style="width: 171px;">类型</th><th style="width: 54px;">是否必填</th><th style="width: 136px;">字段意义</th><th style="width: 310px;">备注</th></tr></thead><tbody><tr><td style="width: 138px;">traceNo</td><td style="width: 171px;">String</td><td style="width: 54px;">是</td><td style="width: 136px;">收银机流水号</td><td style="width: 310px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 138px;">onlineTid</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">线上对接使用的统一终端号</td><td style="width: 310px;">对接前需提前和易百技术沟通</td></tr><tr><td style="width: 138px;">totalAmount</td><td style="width: 171px;">Price</td><td style="width: 54px;">是</td><td style="width: 136px;">交易总金额</td><td style="width: 310px;">单位：元</td></tr><tr><td style="width: 138px;">undiscountAmount</td><td style="width: 171px;">Price</td><td style="width: 54px;">是</td><td style="width: 136px;">不可打折金额</td><td style="width: 310px;">单位：元，没有填写0</td></tr><tr><td style="width: 138px;">verifyType</td><td style="width: 171px;">String</td><td style="width: 54px;">是</td><td style="width: 136px;">核销类型</td><td style="width: 310px;">请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景</td></tr><tr><td style="width: 138px;">activityProductNo</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">活动产品编号</td><td style="width: 310px;">二次交互时填写</td></tr><tr><td style="width: 138px;">scene</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">支付场景</td><td style="width: 310px;">条码:bar\_code, 二维码:qr\_code</td></tr><tr><td style="width: 138px;">orderSubject</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">订单标题</td><td style="width: 310px;">最长256</td></tr><tr><td style="width: 138px;">orderDescription</td><td style="width: 171px;">String</td><td style="width: 54px;">否</td><td style="width: 136px;">订单描述</td><td style="width: 310px;">最长256</td></tr><tr><td style="width: 138px;">qrcode</td><td style="width: 171px;">String</td><td style="width: 54px;">是</td><td style="width: 136px;">二维码内容</td><td style="width: 310px;">串号、一维码或二维码内容</td></tr><tr><td style="width: 138px;">goodsDetail</td><td style="width: 171px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 54px;">否</td><td style="width: 136px;">产品明细</td><td style="width: 310px;">验证产品明细时必填</td></tr><tr><td style="width: 138px;">memberDetail</td><td style="width: 171px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 54px;">否</td><td style="width: 136px;">会员信息</td><td style="width: 310px;">会员支付时必填</td></tr></tbody></table>

### **请求报文举例**

```JSON
{
  "traceNo": "9900000910001011320150201",
  "totalAmount": 40.8,
  "undiscountAmount": 0,
  "activityProductNo": "HDCP00000000001234",
  "qrcode": "280123121234567890",
  "lockTime": "300",
  "afterLock": "0",
  "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
  }
}
```

**返回参数，易百后台===&gt;中件间**

- 可能返回[活动产品选项](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-list/transaction-api/prompt-options.html "活动产品选项")，需要进行选择

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t-0" style="height: 743px; width: 812px;"><thead><tr style="height: 29px;"><th style="width: 147px; height: 29px;">字段</th><th style="width: 167px; height: 29px;">类型</th><th style="width: 50px; height: 29px;">是否必填</th><th style="width: 149px; height: 29px;">字段意义</th><th style="width: 299px; height: 29px;">备注</th></tr></thead><tbody><tr style="height: 45px;"><td style="width: 147px; height: 45px;">traceNo</td><td style="width: 167px; height: 45px;">String</td><td style="width: 50px; height: 45px;">是</td><td style="width: 149px; height: 45px;">收银机流水号</td><td style="width: 299px; height: 45px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">orderNo</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">交易订单号</td><td style="width: 299px; height: 29px;">易百生成</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">transDate</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">交易时间</td><td style="width: 299px; height: 29px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">returnCode</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">返回码</td><td style="width: 299px; height: 29px;">00表示交易成功，其他表示失败</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">returnDesc</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">返回信息</td><td style="width: 299px; height: 29px;">交易结果描述或错误原因</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">paidAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 50px; height: 29px;">是</td><td style="width: 149px; height: 29px;">支付成功总金额</td><td style="width: 299px; height: 29px;">单位：元</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">receiptAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">商户实收金额</td><td style="width: 299px; height: 29px;">单位：元</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">invoiceAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">商户开票金额</td><td style="width: 299px; height: 29px;">单位：元</td></tr><tr style="height: 45px;"><td style="width: 147px; height: 45px;">remainTimes</td><td style="width: 167px; height: 45px;">Number</td><td style="width: 50px; height: 45px;">是</td><td style="width: 149px; height: 45px;">券码当前可用次数</td><td style="width: 299px; height: 45px;">如果有限制每天使用多少次，代表当天可使用次数｜</td></tr><tr style="height: 19px;"><td style="width: 147px; height: 19px;">lockTime</td><td style="width: 167px; height: 19px;">String</td><td style="width: 50px; height: 19px;">否</td><td style="width: 149px; height: 19px;">锁定时间,单位（秒）</td><td style="width: 299px; height: 19px;">默认：300</td></tr><tr style="height: 45px;"><td style="width: 147px; height: 45px;">afterLock</td><td style="width: 167px; height: 45px;">String</td><td style="width: 50px; height: 45px;">否</td><td style="width: 149px; height: 45px;">锁定和解锁，锁定：1，解锁：0</td><td style="width: 299px; height: 45px;">默认：1，锁定返回校验参数</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">exchangeRate</td><td style="width: 167px; height: 29px;">Number(8,6)</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">汇率</td><td style="width: 299px; height: 29px;">1外币等于多少人民币</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">currency</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">货币类型</td><td style="width: 299px; height: 29px;">例如:CNY</td></tr><tr style="height: 26px;"><td style="width: 147px; height: 26px;">discountCode</td><td style="width: 167px; height: 26px;">String</td><td style="width: 50px; height: 26px;">否</td><td style="width: 149px; height: 26px;">折扣编码</td><td style="width: 299px; height: 26px;">由收银机分配，用于入账计折扣类型和折扣金额</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">discountNum</td><td style="width: 167px; height: 29px;">Number</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">固定金额折扣数量</td><td style="width: 299px; height: 29px;">用于入账计折扣类型的数量</td></tr><tr style="height: 45px;"><td style="width: 147px; height: 45px;">tenderCode</td><td style="width: 167px; height: 45px;">String</td><td style="width: 50px; height: 45px;">否</td><td style="width: 149px; height: 45px;">支付方式编码</td><td style="width: 299px; height: 45px;">由收银机分配，用于入账计支付方式和入账金额</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">activityProductNo</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">活动产品编号</td><td style="width: 299px; height: 29px;">  
</td></tr><tr style="height: 29px;"><td style="width: 147px; height: 29px;">activityProductName</td><td style="width: 167px; height: 29px;">String</td><td style="width: 50px; height: 29px;">否</td><td style="width: 149px; height: 29px;">活动产品名称</td><td style="width: 299px; height: 29px;">  
</td></tr><tr style="height: 20px;"><td style="width: 147px; height: 20px;">goodsDetail</td><td style="width: 167px; height: 20px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 50px; height: 20px;">否</td><td style="width: 149px; height: 20px;">折抵产品明细</td><td style="width: 299px; height: 20px;">返回后台已抵扣成功的产品明细</td></tr><tr style="height: 23px;"><td style="width: 147px; height: 23px;">fundChannel</td><td style="width: 167px; height: 23px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 50px; height: 23px;">否</td><td style="width: 149px; height: 23px;">资金渠道</td><td style="width: 299px; height: 23px;">  
</td></tr><tr style="height: 15px;"><td style="width: 147px; height: 15px;">printDetail</td><td style="width: 167px; height: 15px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 50px; height: 15px;">否</td><td style="width: 149px; height: 15px;">打印信息</td><td style="width: 299px; height: 15px;">如需要在收银小票上打印信息时必填</td></tr><tr style="height: 21px;"><td style="width: 147px; height: 21px;">memberDetail</td><td style="width: 167px; height: 21px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 50px; height: 21px;">否</td><td style="width: 149px; height: 21px;">会员信息</td><td style="width: 299px; height: 21px;">返回本次交易的会员信息</td></tr><tr style="height: 26px;"><td style="width: 147px; height: 26px;">voucherDetail</td><td style="width: 167px; height: 26px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 50px; height: 26px;">否</td><td style="width: 149px; height: 26px;">优惠券信息</td><td style="width: 299px; height: 26px;">返回本次交易的优惠券信息</td></tr><tr style="height: 36px;"><td style="width: 147px; height: 36px;">extendsData</td><td style="width: 167px; height: 36px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 50px; height: 36px;">否</td><td style="width: 149px; height: 36px;">扩展信息</td><td style="width: 299px; height: 36px;">与ebuy约定</td></tr></tbody></table>

### **返回报文举例**

```JSON
{
  "transDate": "20220726153110",
  "returnCode": "00",
  "extendsData": {},
  "orderNo": "191990113248",
  "ecouponsData": [
    {
      "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"
        }
      ]
    },
    {
      "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"
        }
      ]
    }
  ],
  "traceNo": "20220726153107100000000SH20501",
  "uuid": "f3c32fa32ccb4ccd8f38c36800741682",
  "returnDesc": "请求成功"
}
```