# 核销信息以及城市范围查询

#### **接口用途**

- 核销信息以及城市范围查询

#### **接口地址**

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

#### **action**

- queryVerifyInfo

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

<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="height: 177px; width: 809px;"><thead><tr style="height: 29px;"><th style="width: 101px; height: 29px;">字段</th><th style="width: 63px; height: 29px;">类型</th><th style="width: 78px; height: 29px;">是否必填</th><th style="width: 103px; height: 29px;">字段意义</th><th style="width: 464px; height: 29px;">备注</th></tr></thead><tbody><tr style="height: 29px;"><td style="width: 101px; height: 29px;">traceNo</td><td style="width: 63px; height: 29px;">String</td><td style="width: 78px; height: 29px;">是</td><td style="width: 103px; height: 29px;">收银机流水号</td><td style="width: 464px; height: 29px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29px;"><td style="width: 101px; height: 29px;">qrcode</td><td style="width: 63px; height: 29px;">String</td><td style="width: 78px; height: 29px;">是</td><td style="width: 103px; height: 29px;">二维码内容</td><td style="width: 464px; height: 29px;">券号code</td></tr><tr style="height: 61px;"><td style="width: 101px; height: 61px;">businessType</td><td style="width: 63px; height: 61px;">Integer</td><td style="width: 78px; height: 61px;">是</td><td style="width: 103px; height: 61px;">业务类型</td><td style="width: 464px; height: 61px;">当businessType=12时为新逻辑支持箱的概念，返回的数据中包含箱的结构，该字段不传或者不等于12则为原来的逻辑不做任何变动，返回数据中不包含箱的结构</td></tr></tbody></table>

**请求报文举例**

```
{
    "traceNo": "9900000910001010720150201",
    "qrcode": "10085748356738476396436",
    "businessType": 12
}

```

**返回参数，易百后台===&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="height: 273px; width: 809px;"><thead><tr style="height: 45px;"><th style="width: 92px; height: 45px;">字段</th><th style="width: 130px; height: 45px;">类型</th><th style="width: 71px; height: 45px;">是否必填</th><th style="width: 104px; height: 45px;">字段意义</th><th style="width: 412px; height: 45px;">备注</th></tr></thead><tbody><tr style="height: 45px;"><td style="width: 92px; height: 45px;">traceNo</td><td style="width: 130px; height: 45px;">String</td><td style="width: 71px; height: 45px;">是</td><td style="width: 104px; height: 45px;">收银机流水号</td><td style="width: 412px; height: 45px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29px;"><td style="width: 92px; height: 29px;">transDate</td><td style="width: 130px; height: 29px;">String</td><td style="width: 71px; height: 29px;">是</td><td style="width: 104px; height: 29px;">交易时间</td><td style="width: 412px; height: 29px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 45px;"><td style="width: 92px; height: 45px;">returnCode</td><td style="width: 130px; height: 45px;">String</td><td style="width: 71px; height: 45px;">是</td><td style="width: 104px; height: 45px;">返回码</td><td style="width: 412px; height: 45px;">H00表示可核销；H01表示该券未激活；H02表示该券已核销；H03表示券号有误</td></tr><tr style="height: 29px;"><td style="width: 92px; height: 29px;">returnDesc</td><td style="width: 130px; height: 29px;">String</td><td style="width: 71px; height: 29px;">是</td><td style="width: 104px; height: 29px;">返回信息</td><td style="width: 412px; height: 29px;">交易结果描述或错误原因</td></tr><tr style="height: 51px;"><td style="width: 92px; height: 51px;">voucherPkg</td><td style="width: 130px; height: 51px;">List&lt;[voucherPkg](https://book.e-buy.com/books/e-buy-B6z/page/854d9)&gt;</td><td style="width: 71px; height: 51px;">否</td><td style="width: 104px; height: 51px;">电子券包信息</td><td style="width: 412px; height: 51px;">返回电子券包信息</td></tr><tr style="height: 45px;"><td style="width: 92px; height: 45px;">orderRemark</td><td style="width: 130px; height: 45px;">String</td><td style="width: 71px; height: 45px;">否</td><td style="width: 104px; height: 45px;">订单备注</td><td style="width: 412px; height: 45px;">订单备注信息，除基本信息，也用于部分透传字段场景使用，如品牌核销渠道等。</td></tr></tbody></table>

**返回报文举例**

```
{
    "transDate":"20190107143930",
    "returnDesc":"success",
    "orderRemark": "天猫",
    "voucherBox":[
        {
            "boxId":"X1123-6430582-102F5",
            "voucherPkg":[
                {
                    "pkgId":"B1123-6430582-102F5",
                    "voucherReel":[
                        {
                            "codeDetail":[
                                {
                                    "createTime":"20190107100500",
                                    "saleChannelOrderId":"a1c4efb107df46f0ba230de6477bd337",
                                    "remainTimes":2,
                                    "status":"03",
                                    "ticketName":"买N赠M券[望湘园_储值卡]",
                                    "code":"1001901070000000258-M4DEDSfV",
                                    "activityId":500706,
                                    "validEnd":"00000000000000",
                                    "sendChannelName":"测试易百制码",
                                    "ticketId":500811,
                                    "saleChannelName":"望湘园_储值卡",
                                    "validStart":"00000000000000",
                                    "faceValue":"0.0",
                                    "createDate":"20190107",
                                    "activityName":"【吉野家】 黏贴板主题-2018第6期",
                                    "statusDesc":"未激活"
                                }
                            ],
                            "reelId":"R112102F-0000242-2585"
                        }
                    ]
                }
            ]
        }
    ],
    "paidAmount":0,
    "invoiceAmount":0,
    "returnCode":"P00",
    "receiptAmount":0,
    "printDetail":{
        "content":"00||"
    },
    "orderNo":"179031014530",
    "traceNo":"ccs2037815468431420150201"
}
```