# 易百码核销转发

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

- 当电子凭证平台需要调用外部取码方进行查询时，调用该接口。

#### **接口说明**

- 该接口为电子凭证平台调用ESB做查询操作，ESB再根据不同制码方拼装报文并实时请求。

**请求参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===>ESB**

<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-v"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>verifyUrl</td><td>String</td><td>是</td><td>取码方核销地址</td><td> </td></tr><tr><td>saleChannelId</td><td>String</td><td>是</td><td>取码方渠道id</td><td> </td></tr><tr><td>code</td><td>String</td><td>是</td><td>串码号</td><td> </td></tr><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>取码方制码订单号</td><td> </td></tr><tr><td>verifyScene</td><td>String</td><td>是</td><td>核销场景</td><td>online：线上，offline：线下</td></tr><tr><td>brandId</td><td>String</td><td>否</td><td>品牌id</td></tr><tr><td>tid</td><td>String</td><td>否</td><td>易百终端id</td><td>线下核销场景存在机具信息时必填</td></tr><tr><td>shopNo</td><td>String</td><td>否</td><td>易百门店编号</td><td>线下核销场景存在机具信息时必填</td></tr><tr><td>shopName</td><td>String</td><td>否</td><td>易百门店名称</td><td>线下核销场景存在机具信息时必填</td></tr><tr><td>goodsDetail</td><td>List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-40/page/1d7f7-Fbe "goodsDetail")&gt;</td><td>否</td><td>(只有在收银POS上发起交易时才上送)</td><td> </td></tr><tr><td>messageFormat</td><td>String</td><td>是</td><td>核销转发报文格式</td><td>ebuy：易百标准报文，third：第三方自定义报文</td></tr></tbody></table>

**返回参数：易百码核销转发报文**

<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-c"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>channelId</td><td>String</td><td>是</td><td>电子凭证系统对接方id</td><td>对应请求报文中saleChannelOrderId字段</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00：成功，其他均为失败。两位数字和字母组合</td></tr><tr><td>returnMsg</td><td>String</td><td>是</td><td>返回信息</td></tr></tbody></table>