# 电子凭证查询

### **接口用途**

- 查询电子凭证的产品信息，可抵用的金额以及所属的活动，支持易百自有电子凭证和第三方电子凭证。

### **接口地址**

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

### **action**

- `ecouponInquiry`

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

<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"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>收银机流水号</td><td>不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td>onlineTid</td><td>String</td><td>否</td><td>线上对接使用的统一终端号</td><td>对接前需提前和易百技术沟通</td></tr><tr><td>qrcode</td><td>String</td><td>是</td><td>电子凭证号</td><td>要查询的电子凭证号</td></tr></tbody></table>

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

```JSON
{
    "traceNo": "9900000910001013620150201",
    "qrcode": "HDCP00000000001235"
}

```

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

<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="width: 99.7531%; height: 392.206px;"><thead><tr style="height: 45.9191px;"><th style="width: 19.3069%; height: 45.9191px;">字段</th><th style="width: 19.802%; height: 45.9191px;">类型</th><th style="width: 6.55941%; height: 45.9191px;">是否必填</th><th style="width: 14.8515%; height: 45.9191px;">字段意义</th><th style="width: 39.3564%; height: 45.9191px;">备注</th></tr></thead><tbody><tr style="height: 45.9191px;"><td style="width: 19.3069%; height: 45.9191px;">traceNo</td><td style="width: 19.802%; height: 45.9191px;">String</td><td style="width: 6.55941%; height: 45.9191px;">是</td><td style="width: 14.8515%; height: 45.9191px;">收银机流水号</td><td style="width: 39.3564%; height: 45.9191px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">orderNo</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">交易订单号</td><td style="width: 39.3564%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">transDate</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">交易时间</td><td style="width: 39.3564%; height: 29.4485px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">returnCode</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">返回码</td><td style="width: 39.3564%; height: 29.4485px;">00，C3表示券码可用，其他表示不可用</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">returnDesc</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">返回信息</td><td style="width: 39.3564%; height: 29.4485px;">交易结果描述或错误原因</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">canPayAmount</td><td style="width: 19.802%; height: 29.4485px;">Price</td><td style="width: 6.55941%; height: 29.4485px;">是</td><td style="width: 14.8515%; height: 29.4485px;">可抵用的总金额</td><td style="width: 39.3564%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">activityProductNo</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">否</td><td style="width: 14.8515%; height: 29.4485px;">活动产品编号</td><td style="width: 39.3564%; height: 29.4485px;">该电子凭证所属的活动产品编号</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">activityProductName</td><td style="width: 19.802%; height: 29.4485px;">String</td><td style="width: 6.55941%; height: 29.4485px;">否</td><td style="width: 14.8515%; height: 29.4485px;">活动产品名称</td><td style="width: 39.3564%; height: 29.4485px;">该电子凭证所属的活动产品名称</td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">useTimes</td><td style="width: 19.802%; height: 29.4485px;">int</td><td style="width: 6.55941%; height: 29.4485px;">否</td><td style="width: 14.8515%; height: 29.4485px;">总核销次数</td><td style="width: 39.3564%; height: 29.4485px;"> </td></tr><tr style="height: 29.4485px;"><td style="width: 19.3069%; height: 29.4485px;">remainTimes</td><td style="width: 19.802%; height: 29.4485px;">int</td><td style="width: 6.55941%; height: 29.4485px;">否</td><td style="width: 14.8515%; height: 29.4485px;">剩余可核销次数</td><td style="width: 39.3564%; height: 29.4485px;"> </td></tr><tr style="height: 35.3309px;"><td style="width: 19.3069%; height: 35.3309px;">extendsData</td><td style="width: 19.802%; height: 35.3309px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 6.55941%; height: 35.3309px;">否</td><td style="width: 14.8515%; height: 35.3309px;">扩展信息</td><td style="width: 39.3564%; height: 35.3309px;">与ebuy约定</td></tr></tbody></table>

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

```JSON
{
    "traceNo": "9900000910001013720150201",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "canPayAmount": 40.8,
    "activityProductNo": "2016123101",
    "activityProductName": "中信365权益",
    "useTimes":10,
    "remainTimes":7
}
```