# 后台管理类接口



# 新增活动接口

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

- 当有新的电子凭证活动时，ERP调用此接口

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

- PM做电子凭证立项后，3.0系统的活动Id绑定到电子凭证活动中，做一一对应关系

#### **action**

- `activityInsert`

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

<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-a"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>activityName</td><td>String</td><td>是</td><td>活动名称</td><td>小于100个字符</td></tr><tr><td>ebuyActivityId</td><td>String</td><td>是</td><td>易百活动ID</td><td>小于40个字符</td></tr><tr><td>saleChannelId</td><td>String</td><td>是</td><td>取码方</td><td> </td></tr><tr><td>validStart</td><td>String</td><td>是</td><td>活动有效开始时间</td><td> </td></tr><tr><td>validEnd</td><td>String</td><td>是</td><td>活动有效结束时间</td><td> </td></tr><tr><td>isActive</td><td>String</td><td>否</td><td>是否启用（Y/N）</td><td>如不填，默认情况是启用</td></tr><tr><td>createUser</td><td>String</td><td>否</td><td>创建人</td><td> </td></tr><tr><td>createTime</td><td>String</td><td>是</td><td>创建时间</td><td>yyyyMMddHHmmss</td></tr><tr><td>updateTime</td><td>String</td><td>是</td><td>更新时间</td><td>yyyyMMddHHmmss</td></tr><tr><td>activityConfig</td><td>Object&lt;activityConfig&gt;</td><td>否</td><td>活动配置</td></tr></tbody></table>

**请求报文举例**

```
{
    "activityName": "中信电子凭证活动",
    "ebuyActivityId": "2018090500",
    "saleChannelId":"10002401"
    "validStart": "20180905112600",
    "validEnd": "20181005112600",
    "createUser": "xiedonglei",
    "createTime": "20180905112600",
    "activityConfig": {
        "channelPublicKey": "publicKey",
        "whalePublicKey": "publlicKey",
        "verifyNotifyURL": "www.baidu.com"
    }
}

```

**返回参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;ERP**

<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-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td> </td></tr><tr><td>returnMsg</td><td>String</td><td>是</td><td>返回信息</td></tr></tbody></table>

**返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "SUCCESS"
}
```

# 制码通知查询接口

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

- 当需要页面中展示制码通知时，ERP调用此接口

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

- 如果销售渠道此次制码需要[whale](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")进行短信通知，则生成一条制码通知数据。
- 制码通知以渠道方订单编号为分表位，每次调用时必须有明确的订单编号

#### **action**

- `makeNotifyQuery`

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

<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-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>销售渠道制码订单id</td><td>小于64个字符</td></tr></tbody></table>

**请求报文举例**

```
{
    "saleChannelOrderId": "20180905000"
}

```

**返回参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;ERP**

<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-n"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>notifyId</td><td>String</td><td>是</td><td>数据库通知id</td><td> </td></tr><tr><td>orderId</td><td>String</td><td>是</td><td>数据库订单id</td><td> </td></tr><tr><td>saleChannelId</td><td>Long</td><td>是</td><td>销售渠道id</td><td> </td></tr><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>销售渠道制码订单号</td><td> </td></tr><tr><td>createDate</td><td>String</td><td>是</td><td>订单创建日期</td><td>YYYYmmdd</td></tr><tr><td>createTime</td><td>String</td><td>是</td><td>订单创建时间</td><td>YYYYmmddHHMMSS</td></tr><tr><td>orderMobile</td><td>String</td><td>否</td><td>制码时上送手机号</td><td> </td></tr><tr><td>codeNum</td><td>int</td><td>是</td><td>订单制码总数</td><td> </td></tr><tr><td>orderExtend</td><td>String</td><td>否</td><td>订单扩展</td><td> </td></tr><tr><td>isNotify</td><td>String</td><td>是</td><td>是否通知</td><td>已通知，未通知</td></tr><tr><td>isCanVoid</td><td>String</td><td>是</td><td>是否可撤销</td><td>可撤销，不可撤销</td></tr><tr><td>returnCode</td><td>String(2)</td><td>是</td><td>订单返回码</td><td>00为成功，其他均为失败</td></tr><tr><td>updateDate</td><td>String</td><td>是</td><td>订单更新日期</td><td>YYYYmmdd</td></tr><tr><td>updateTime</td><td>String</td><td>是</td><td>订单更新时间</td><td>YYYYmmddHHMMSS</td></tr><tr><td>status</td><td>String</td><td>是</td><td>状态描述</td></tr></tbody></table>

**返回报文举例**

```
{
    "orderId": "99000009100010101732123",
    "requestId": "171698602301",
    "saleChannelId": 123456,
    "saleChannelOrderId":"10101732123",
    "createDate":"20180905",
    "createTime":"20180905160911",
    "orderMobile":"13524121212",
    "codeNum":1,
    "isNotify":"已通知",
    "isCanVoid":"可撤销",
    "createDate":"20180905",
    "createTime":"20180905160911",
    "returnCode": "00",
    "status": "订单初始状态"
}
```

# 制码通知重试接口

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

- 当需要对制码重新通知时，ERP调用此接口

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

- 如果销售渠道此次制码需要[whale](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")进行短信通知，则生成一条制码通知数据。
- 制码通知以渠道方订单编号为分表位，每次调用时必须有明确的订单编号

#### **action**

- `makeNotifyRetry`

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

<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-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>销售渠道制码订单id</td><td>小于64个字符</td></tr></tbody></table>

**请求报文举例**

```
{
    "saleChannelOrderId": "20180905000"
}

```

**返回参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;ERP**

<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-n"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>notifyId</td><td>String</td><td>是</td><td>数据库通知id</td><td> </td></tr><tr><td>orderId</td><td>String</td><td>是</td><td>数据库订单id</td><td> </td></tr><tr><td>saleChannelId</td><td>Long</td><td>是</td><td>销售渠道id</td><td> </td></tr><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>销售渠道制码订单号</td><td> </td></tr><tr><td>createDate</td><td>String</td><td>是</td><td>订单创建日期</td><td>YYYYmmdd</td></tr><tr><td>createTime</td><td>String</td><td>是</td><td>订单创建时间</td><td>YYYYmmddHHMMSS</td></tr><tr><td>orderMobile</td><td>String</td><td>否</td><td>制码时上送手机号</td><td> </td></tr><tr><td>codeNum</td><td>int</td><td>是</td><td>订单制码总数</td><td> </td></tr><tr><td>orderExtend</td><td>String</td><td>否</td><td>订单扩展</td><td> </td></tr><tr><td>isNotify</td><td>String</td><td>是</td><td>是否通知</td><td>已通知，未通知</td></tr><tr><td>isCanVoid</td><td>String</td><td>是</td><td>是否可撤销</td><td>可撤销，不可撤销</td></tr><tr><td>returnCode</td><td>String(2)</td><td>是</td><td>订单返回码</td><td>00为成功，其他均为失败</td></tr><tr><td>updateDate</td><td>String</td><td>是</td><td>订单更新日期</td><td>YYYYmmdd</td></tr><tr><td>updateTime</td><td>String</td><td>是</td><td>订单更新时间</td><td>YYYYmmddHHMMSS</td></tr><tr><td>status</td><td>String</td><td>是</td><td>状态描述</td></tr></tbody></table>

**返回报文举例**

```
{
    "orderId": "99000009100010101732123",
    "requestId": "171698602301",
    "saleChannelId": 123456,
    "saleChannelOrderId":"10101732123",
    "createDate":"20180905",
    "createTime":"20180905160911",
    "orderMobile":"13524121212",
    "codeNum":1,
    "isNotify":"已通知",
    "isCanVoid":"可撤销",
    "createDate":"20180905",
    "createTime":"20180905160911",
    "returnCode": "00",
    "status": "订单初始状态"
}
```

# 新增销售渠道接口

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

- 当有新的销售渠道对接时，ERP调用此接口

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

- 每个第三取码方均为一个销售渠道，ERP调用此接口后能新增一个销售渠道供日后取码使用

#### **action**

- `saleChanneInsert`

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

<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-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>saleChannelName</td><td>String</td><td>是</td><td>销售渠道名称</td><td>小于100个字符</td></tr><tr><td>isActive</td><td>String</td><td>否</td><td>是否启用（Y/N）</td><td>如不填，默认情况是启用</td></tr><tr><td>remark</td><td>String</td><td>否</td><td>备注</td><td> </td></tr><tr><td>creatorName</td><td>String</td><td>否</td><td>创建人</td><td> </td></tr><tr><td>createTime</td><td>String</td><td>是</td><td>创建时间</td><td>yyyyMMddHHmmss</td></tr><tr><td>updateTime</td><td>String</td><td>是</td><td>更新时间</td><td>yyyyMMddHHmmss</td></tr><tr><td>saleChannelConfig</td><td>Object&lt;[saleChannelConfig](https://book.e-buy.com/books/e-buy-40/page/65b9e "sendChannelConfig")&gt;</td><td>否</td><td>销售渠道配置</td></tr></tbody></table>

**请求报文举例**

```
{
    "sendChannelName": "中信银行",
    "isActive": "Y",
    "remark":"备注信息",
    "saleChannelConfig": {
        "channelPublicKey": "publicKey",
        "whalePublicKey": "publlicKey",
        "verifyNotifyURL": "www.baidu.com"
    }
}

```

**返回参数，中间件===&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"><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>不允许重复</td></tr><tr><td>orderNo</td><td>String</td><td>是</td><td>交易订单号</td><td>单位：元</td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式为：YYYYmmddHHMMSS</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>rightsTimes</td><td>Integer</td><td>是</td><td>权益次数</td><td>返回可以享受的权益次数</td></tr><tr><td>moneyBalance</td><td>Price</td><td>是</td><td>现金余额</td><td>单位：元</td></tr><tr><td>pointBalance</td><td>Price</td><td>是</td><td>积分余额</td><td>单位：分</td></tr><tr><td>printDetail</td><td>Object&lt;printDetail&gt;</td><td>否</td><td>打印信息</td><td>如需要在收银小票上打印信息时必填</td></tr><tr><td>memberDetail</td><td>Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-40/page/04511 "memberDetail")&gt;</td><td>否</td><td>会员信息</td><td>返回本次交易的会员信息</td></tr></tbody></table>

**返回报文举例**

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "rightsTimes": 1,
    "moneyBalance": 40.8,
    "pointBalance": 40000,
    "printDetail": {
        "cardNo64": "622562****8888",
        "bank": "中信银行",
        "paymentOrderNo": "201612315689412157458787",
        "pointSale": "0",
        "qrCode1": "htt://www.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
```

# 新增制码渠道接口

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

- 当有新的制码渠道对接时，ERP调用此接口

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

- 每个第三制码方均为一个制码渠道，ERP调用此接口后能新增一个制码渠道供日后制码使用

#### **action**

- `sendChanneInsert`

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

<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-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>sendChannelName</td><td>String</td><td>是</td><td>制码渠道名称</td><td>小于100个字符</td></tr><tr><td>isActive</td><td>String</td><td>否</td><td>是否激活（Y/N）</td><td>如不填，默认情况是激活</td></tr><tr><td>sendChannelConfig</td><td>Object&lt;[sendChannelConfig](https://book.e-buy.com/books/e-buy-40/page/fc221 "sendChannelConfig")&gt;</td><td>是</td><td>制码渠道配置</td><td>必填</td></tr></tbody></table>

**请求报文举例**

```
{
    "sendChannelName": "资和信",
    "isActive": "Y",
    "sendChannelConfig": {
        "thirdChannelNo": "M000001545",
        "makeCodeURL": "www.baidu.com",
        "verifyURL": "www.baidu.com",
        "verifyNotifyURL": "www.baidu.com"
    }
}

```

**返回参数，中间件===&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"><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>不允许重复</td></tr><tr><td>orderNo</td><td>String</td><td>是</td><td>交易订单号</td><td>单位：元</td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式为：YYYYmmddHHMMSS</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>rightsTimes</td><td>Integer</td><td>是</td><td>权益次数</td><td>返回可以享受的权益次数</td></tr><tr><td>moneyBalance</td><td>Price</td><td>是</td><td>现金余额</td><td>单位：元</td></tr><tr><td>pointBalance</td><td>Price</td><td>是</td><td>积分余额</td><td>单位：分</td></tr><tr><td>printDetail</td><td>Object&lt;printDetail&gt;</td><td>否</td><td>打印信息</td><td>如需要在收银小票上打印信息时必填</td></tr><tr><td>memberDetail</td><td>Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-40/page/04511 "memberDetail")&gt;</td><td>否</td><td>会员信息</td><td>返回本次交易的会员信息</td></tr></tbody></table>

**返回报文举例**

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "rightsTimes": 1,
    "moneyBalance": 40.8,
    "pointBalance": 40000,
    "printDetail": {
        "cardNo64": "622562****8888",
        "bank": "中信银行",
        "paymentOrderNo": "201612315689412157458787",
        "pointSale": "0",
        "qrCode1": "htt://www.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
```

# 新增券模板接口

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

- 当需要创建新的券模板时，ERP调用此接口

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

- 每个易百productId对应一个券模板，一个券模板可供多个活动使用

#### **action**

- `templateInsert`

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

<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>templateName</td><td>String</td><td>是</td><td>券模板名称</td><td> </td></tr><tr><td>sendChannelId</td><td>Long</td><td>是</td><td>制码渠道ID</td><td> </td></tr><tr><td>brandId</td><td>Long</td><td>是</td><td>品牌ID</td><td> </td></tr><tr><td>productId</td><td>Long</td><td>是</td><td>易百产品ID</td><td> </td></tr><tr><td>ticketType</td><td>int</td><td>是</td><td>券类型</td><td>1：代金券，2：折抵券，3：产品抵用券，4：复合产品券</td></tr><tr><td>faceValue</td><td>String</td><td>是</td><td>面值</td><td>12位字符串，分为单位</td></tr><tr><td>sendType</td><td>String</td><td>是</td><td>券模板名称</td><td>1：接口，2：批导</td></tr><tr><td>isActive</td><td>String</td><td>否</td><td>是否启用（Y/N）</td><td>如不填，默认情况是启用</td></tr><tr><td>remark</td><td>String</td><td>否</td><td>备注</td><td> </td></tr><tr><td>createUser</td><td>String</td><td>否</td><td>创建人</td><td> </td></tr><tr><td>createTime</td><td>String</td><td>是</td><td>创建时间</td><td>yyyyMMddHHmmss</td></tr><tr><td>updateTime</td><td>String</td><td>是</td><td>更新时间</td><td>yyyyMMddHHmmss</td></tr><tr><td>templateConfig</td><td>Object&lt;[templateConfig](https://book.e-buy.com/books/e-buy-40/page/1ff8a "templateConfig")&gt;</td><td>否</td><td>券模板配置</td></tr></tbody></table>

**请求报文举例**

```
{
    "templateName": "COSTA30元代金券",
    "sendChannelId":123L,
    "brandId":686L,
    "productId":12345L,
    "ticketType":1,
    "sendType":1,
    "faceValue":"000000003000"
    "isActive": "Y",
    "remark":"备注信息",
    "createUser":"xiedonglei",
    "templateConfig": {
        "channelPublicKey": "publicKey",
        "whalePublicKey": "publlicKey",
        "verifyNotifyURL": "www.baidu.com"
    }
}

```

**返回参数，中间件===&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"><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>不允许重复</td></tr><tr><td>orderNo</td><td>String</td><td>是</td><td>交易订单号</td><td>单位：元</td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式为：YYYYmmddHHMMSS</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>rightsTimes</td><td>Integer</td><td>是</td><td>权益次数</td><td>返回可以享受的权益次数</td></tr><tr><td>moneyBalance</td><td>Price</td><td>是</td><td>现金余额</td><td>单位：元</td></tr><tr><td>pointBalance</td><td>Price</td><td>是</td><td>积分余额</td><td>单位：分</td></tr><tr><td>printDetail</td><td>Object&lt;printDetail&gt;</td><td>否</td><td>打印信息</td><td>如需要在收银小票上打印信息时必填</td></tr><tr><td>memberDetail</td><td>Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-40/page/04511 "memberDetail")&gt;</td><td>否</td><td>会员信息</td><td>返回本次交易的会员信息</td></tr></tbody></table>

**返回报文举例**

```
{
    "traceNo": "99000009100010101732123",
    "orderNo": "171698602301",
    "transDate": "20161231120533",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "rightsTimes": 1,
    "moneyBalance": 40.8,
    "pointBalance": 40000,
    "printDetail": {
        "cardNo64": "622562****8888",
        "bank": "中信银行",
        "paymentOrderNo": "201612315689412157458787",
        "pointSale": "0",
        "qrCode1": "htt://www.xxx.com/url",
        "qrCode2": "",
        "qrCode3": "",
        "barCode1": "12345679",
        "barCode2": "",
        "barCode3": ""
    },
    "memberDetail": {
        "memberId": "M000001545",
        "memberName": "TONY",
        "grade": "1",
        "status": "1",
        "balance": 1000.00,
        "pointBalance": 30000
    }
}
```

# 核销通知查询接口

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

- 当需要页面中展示核销通知时，ERP调用此接口

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

- 如果销售渠道此次制码需要[whale](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")进行短信通知，则生成一条制码通知数据。
- 制码通知以渠道方订单编号为分表位，每次调用时必须有明确的订单编号

#### **action**

- `makeNotifyQuery`

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

<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-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>销售渠道制码订单id</td><td>小于64个字符</td></tr></tbody></table>

**请求报文举例**

```
{
    "saleChannelOrderId": "20180905000"
}

```

**返回参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;ERP**

<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-n"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>notifyId</td><td>String</td><td>是</td><td>数据库通知id</td><td> </td></tr><tr><td>orderId</td><td>String</td><td>是</td><td>数据库订单id</td><td> </td></tr><tr><td>saleChannelId</td><td>Long</td><td>是</td><td>销售渠道id</td><td> </td></tr><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>销售渠道制码订单号</td><td> </td></tr><tr><td>createDate</td><td>String</td><td>是</td><td>订单创建日期</td><td>YYYYmmdd</td></tr><tr><td>createTime</td><td>String</td><td>是</td><td>订单创建时间</td><td>YYYYmmddHHMMSS</td></tr><tr><td>orderMobile</td><td>String</td><td>否</td><td>制码时上送手机号</td><td> </td></tr><tr><td>codeNum</td><td>int</td><td>是</td><td>订单制码总数</td><td> </td></tr><tr><td>orderExtend</td><td>String</td><td>否</td><td>订单扩展</td><td> </td></tr><tr><td>isNotify</td><td>String</td><td>是</td><td>是否通知</td><td>已通知，未通知</td></tr><tr><td>isCanVoid</td><td>String</td><td>是</td><td>是否可撤销</td><td>可撤销，不可撤销</td></tr><tr><td>returnCode</td><td>String(2)</td><td>是</td><td>订单返回码</td><td>00为成功，其他均为失败</td></tr><tr><td>updateDate</td><td>String</td><td>是</td><td>订单更新日期</td><td>YYYYmmdd</td></tr><tr><td>updateTime</td><td>String</td><td>是</td><td>订单更新时间</td><td>YYYYmmddHHMMSS</td></tr><tr><td>status</td><td>String</td><td>是</td><td>状态描述</td></tr></tbody></table>

**返回报文举例**

```
{
    "orderId": "99000009100010101732123",
    "requestId": "171698602301",
    "saleChannelId": 123456,
    "saleChannelOrderId":"10101732123",
    "createDate":"20180905",
    "createTime":"20180905160911",
    "orderMobile":"13524121212",
    "codeNum":1,
    "isNotify":"已通知",
    "isCanVoid":"可撤销",
    "createDate":"20180905",
    "createTime":"20180905160911",
    "returnCode": "00",
    "status": "订单初始状态"
}
```

# 核销通知查询接口

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

- 当需要页面中展示核销通知时，ERP调用此接口

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

- 如果销售渠道此次制码需要[whale](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")进行短信通知，则生成一条制码通知数据。
- 制码通知以渠道方订单编号为分表位，每次调用时必须有明确的订单编号

#### **action**

- `makeNotifyQuery`

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

<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-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>销售渠道制码订单id</td><td>小于64个字符</td></tr></tbody></table>

**请求报文举例**

```
{
    "saleChannelOrderId": "20180905000"
}

```

**返回参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;ERP**

<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-n"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>notifyId</td><td>String</td><td>是</td><td>数据库通知id</td><td> </td></tr><tr><td>orderId</td><td>String</td><td>是</td><td>数据库订单id</td><td> </td></tr><tr><td>saleChannelId</td><td>Long</td><td>是</td><td>销售渠道id</td><td> </td></tr><tr><td>saleChannelOrderId</td><td>String</td><td>是</td><td>销售渠道制码订单号</td><td> </td></tr><tr><td>createDate</td><td>String</td><td>是</td><td>订单创建日期</td><td>YYYYmmdd</td></tr><tr><td>createTime</td><td>String</td><td>是</td><td>订单创建时间</td><td>YYYYmmddHHMMSS</td></tr><tr><td>orderMobile</td><td>String</td><td>否</td><td>制码时上送手机号</td><td> </td></tr><tr><td>codeNum</td><td>int</td><td>是</td><td>订单制码总数</td><td> </td></tr><tr><td>orderExtend</td><td>String</td><td>否</td><td>订单扩展</td><td> </td></tr><tr><td>isNotify</td><td>String</td><td>是</td><td>是否通知</td><td>已通知，未通知</td></tr><tr><td>isCanVoid</td><td>String</td><td>是</td><td>是否可撤销</td><td>可撤销，不可撤销</td></tr><tr><td>returnCode</td><td>String(2)</td><td>是</td><td>订单返回码</td><td>00为成功，其他均为失败</td></tr><tr><td>updateDate</td><td>String</td><td>是</td><td>订单更新日期</td><td>YYYYmmdd</td></tr><tr><td>updateTime</td><td>String</td><td>是</td><td>订单更新时间</td><td>YYYYmmddHHMMSS</td></tr><tr><td>status</td><td>String</td><td>是</td><td>状态描述</td></tr></tbody></table>

**返回报文举例**

```
{
    "orderId": "99000009100010101732123",
    "requestId": "171698602301",
    "saleChannelId": 123456,
    "saleChannelOrderId":"10101732123",
    "createDate":"20180905",
    "createTime":"20180905160911",
    "orderMobile":"13524121212",
    "codeNum":1,
    "isNotify":"已通知",
    "isCanVoid":"可撤销",
    "createDate":"20180905",
    "createTime":"20180905160911",
    "returnCode": "00",
    "status": "订单初始状态"
}
```

# 规则创建接口

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

- 创建规则

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

- 本接口用来后台管平台创建规则

#### **action**

- `createRule`

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

<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-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>ruleScenceKey</td><td>String</td><td>是</td><td>场景关键字</td><td>一般填写需要限制的表对象的表名</td></tr><tr><td>ruleSceneItemKey</td><td>String</td><td>否</td><td>场景对象ID</td><td>一般填写需要限制的表的ID</td></tr><tr><td>ruleScene</td><td>String</td><td>是</td><td>规则适用场景</td><td>自定义，例如制码和核销为不同的场景</td></tr><tr><td>ruleName</td><td>String</td><td>是</td><td>规则名称</td><td> </td></tr><tr><td>ruleKey</td><td>String</td><td>是</td><td>规则关键字</td><td>可理解为限制的类型，如BuyGet/ActivityLimit等</td></tr><tr><td>ruleValue</td><td>JSONObject</td><td>是</td><td>规则内容</td><td> </td></tr><tr><td>startTime</td><td>String</td><td>是</td><td>规则开始时间</td><td> </td></tr><tr><td>endTime</td><td>String</td><td>是</td><td>规则结束时间</td><td> </td></tr><tr><td>messageTpl</td><td>String</td><td>是</td><td>规则不满足提示消息模板</td><td>错误提示信息</td></tr><tr><td>isActive</td><td>String</td><td>否</td><td>是否启用</td><td>Y/N 默认Y</td></tr><tr><td>isContinue</td><td>String</td><td>否</td><td>规则不满足是否继续</td><td>Y/N 默认N</td></tr><tr><td>ruleOrder</td><td>Integer</td><td>否</td><td>规则执行顺序</td><td>默认0，数值越小优先级越高</td></tr></tbody></table>

**规则内容(ruleValue)说明**

**BuyGet 报文格式 根据不同的规则选择不同的字段**

<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>codeConfigList</td><td>String</td><td>否</td><td>配置规则sku分组</td><td>分组格式\["111,222","333,444"\]</td></tr><tr><td>codeType</td><td>String</td><td>否</td><td>code类型</td><td>分组类型支持SKU(sku)/品类(type)/规格(spec)</td></tr><tr><td>checkExpression</td><td>String</td><td>否</td><td>规则检查表达式</td><td>根据配置的分组检查上送产品是否满足</td></tr><tr><td>returnExpression</td><td>String</td><td>否</td><td>规则匹配返回产品表达式</td><td>检查表达式通过的情况下匹配返回产品是否满足</td></tr><tr><td>limitMinAmount</td><td>BigDecimal</td><td>否</td><td>满足规则的最小交易金额</td><td> </td></tr><tr><td>amountOff</td><td>BigDecimal</td><td>否</td><td>固定金额折扣</td><td>直接优惠折抵的金额</td></tr><tr><td>discountOff</td><td>BigDecimal</td><td>否</td><td>折扣</td><td>在规则匹配的金额基础上折扣</td></tr><tr><td>superposition</td><td>Integer</td><td>否</td><td>是否可以叠加使用</td><td>面100减20，如果可叠加就是满200减40</td></tr><tr><td>fixedAmount</td><td>BigDecimal</td><td>否</td><td>固定金额</td><td>例如：10元喝咖啡，将产品金额变为10元</td></tr><tr><td>setMealFixedAmount</td><td>BigDecimal</td><td>否</td><td>固定套餐金额</td><td>将匹配到多个产品设置为固定金额</td></tr><tr><td>sort</td><td>String</td><td>否</td><td>上送商品排序</td><td>例如：price/a 价格升序排列</td></tr><tr><td>isMerchant</td><td>String</td><td>否</td><td>是否为商户自由规则</td><td> </td></tr><tr><td>faceValue</td><td>BigDecimal</td><td>否</td><td>固定值</td><td>设置此值降直接替换规则计算的面值</td></tr><tr><td>netValue</td><td>BigDecimal</td><td>否</td><td>固定收银机入账金额</td><td> </td></tr><tr><td>netRadio</td><td>BigDecimal</td><td>否</td><td>固定收银机入账折扣</td><td> </td></tr><tr><td>reduceValue</td><td>BigDecimal</td><td>否</td><td>规定规则抵扣金额</td><td>对应元来的posPrice</td></tr><tr><td>cashierCode</td><td>String</td><td>否</td><td>收银机对接编号</td></tr></tbody></table>

**限制规则报文结构**

- 目前支持的炼制规则包括
- ScenceLimit 场景限制
- ActivityLimit 活动限制
- CardBinLimit 卡bin限制
- CardNoLimit 卡号限制
- CityLimit 城市限制
- PosTidLimit POS终端限制

<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-l"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>limitWay</td><td>String</td><td>是</td><td>限量方式</td><td>数量限制(Q)/金额显示(A)</td></tr><tr><td>limitType</td><td>String</td><td>是</td><td>限量类型</td><td>白名单(W)/黑名单(B)</td></tr><tr><td>retained</td><td>String</td><td>否</td><td>是否支持滚存</td><td> </td></tr><tr><td>binPrefixNum</td><td>Integer</td><td>否</td><td>bin码的前缀位数</td><td> </td></tr><tr><td>binSuffixNum</td><td>Integer</td><td>否</td><td>bin码的后缀位数</td><td> </td></tr><tr><td>description</td><td>String</td><td>否</td><td>规则描述</td><td> </td></tr><tr><td>limitItems</td><td>JSONArray</td><td>是</td><td>限量明细</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-l-0"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>limitKey</td><td>String</td><td>是</td><td>限量关键字</td><td>例如卡号、卡bin等</td></tr><tr><td>limitMaxDay</td><td>Long</td><td>是</td><td>日限量</td><td>0表示不限量</td></tr><tr><td>limitMaxWeek</td><td>Long</td><td>是</td><td>周限量</td><td>0表示不限量</td></tr><tr><td>limitMaxMonth</td><td>Long</td><td>是</td><td>月限量</td><td>0表示不限量</td></tr><tr><td>limitMaxYear</td><td>Long</td><td>是</td><td>年限量</td><td>0表示不限量</td></tr><tr><td>limitMaxTotal</td><td>Long</td><td>是</td><td>总限量</td><td>0表示不限量</td></tr><tr><td>startTime</td><td>String</td><td>是</td><td>开始时间</td><td>yyyyMMddHHmmss</td></tr><tr><td>endTime</td><td>String</td><td>是</td><td>结束时间</td><td>yyyyMMddHHmmss</td></tr></tbody></table>

**WeekTime 指定日限制**

<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-w"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>weekDay</td><td>String</td><td>是</td><td>指定日期</td><td>指定一周中的日期 格式为7位 \[0\]表示不可使用 \[1\]表示可以使用。eg:0000000 日一二三四五六</td></tr><tr><td>times</td><td>String</td><td>否</td><td>指定时间段</td><td>每12位表示一个时间区间，多个用","分割。eg:090000120000,220000235959</td></tr></tbody></table>

**请求报文举例**

```
暂无

```

**返回参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;ERP**

<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-r-0"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><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>

**返回报文举例**

```
暂无
```

# ESB制码订单

### Whale同步调用ESB制码接口

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

- 当[Whale](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")需要进行第三方制码时，[Whale](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")将请求报文发送给ESB，ESB再统一对不同制码方通信。

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

- 单产品制码时，为同步制码，需实时返回制码结果。

**请求参数，[WHALE](https://book.e-buy.com/books/e-buy-40/page/7f100 "易百电子凭证4.0系统的别称")===&gt;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-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>saleChannelId</td><td>String</td><td>是</td><td>取码方id</td><td> </td></tr><tr><td>sendChannelId</td><td>String</td><td>是</td><td>制码方id</td><td> </td></tr><tr><td>sendChannelOrderId</td><td>String(64)</td><td>是</td><td>制码方订单号</td><td> </td></tr><tr><td>whaleTradeNo</td><td>String(64)</td><td>是</td><td>易百唯一订单号，ESB可用于与制码方作3订单唯一标识</td><td> </td></tr><tr><td>channelMid</td><td>String</td><td>是</td><td>渠道商户编号</td><td>制码方分配的商编，存于sendChannel表中</td></tr><tr><td>channelTid</td><td>String</td><td>是</td><td>渠道终端编号</td><td>制码方分配的终端号，存于sendChannel表中</td></tr><tr><td>orderEncryptKey</td><td>String</td><td>是</td><td>制码方报文加密密钥</td><td>3DES加密时为密钥，公私钥对加密时为公钥字符串</td></tr><tr><td>createDate</td><td>String</td><td>是</td><td>制码日期</td><td>yyyyMMdd</td></tr><tr><td>createTime</td><td>String</td><td>是</td><td>制码时间</td><td>yyyyMMddHHmmss</td></tr><tr><td>items</td><td>&lt;[makeOrderItems](https://book.e-buy.com/books/e-buy-40/page/esb-HRQ "makeOrderItems")&gt;</td><td>是</td><td>制码明细</td></tr></tbody></table>

**请求报文举例**

```
{
    "saleChannelOrderId": "20181024154201",
    "requestId": "20181024154201",
    "notifyType": {
            "mobilePhone": "13524161800"
    },
    "item": {
        "saleChannelItemId":"20181024154201",
        "commissionDate":"1",
        "validDays": 10,
        "ticketId": 1,
        "makeFundsChannel": {
            "channelBenefit": 0,
            "merchantBenefit": 500,
            "userRealAmount": 2500
        }
    }
}

```

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

<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-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>returnCode</td><td>String</td><td>是</td><td>请求返回码</td><td> </td></tr><tr><td>returnMsg</td><td>String</td><td>是</td><td>请求返回信息</td><td> </td></tr><tr><td>data</td><td>Object&lt;[makeCodeResponseData](https://book.e-buy.com/books/e-buy-40/page/d61e4 "makeCodeResponseData")&gt;</td><td>否</td><td>码信息</td></tr></tbody></table>

**返回报文举例**

```
{
    "returnCode": "00",
    "returnMsg": "SUCCESS",
    "data": {
        "saleChannelOrderId": "20181120155110",
        "tradeNo": "c1eca7fbda51430cb5100ec0699a5b00",
        "createTime": "20181120155225",
        "isNotify": "1",
        "codeNum": 1,
        "items": [{
            "codeDetail": [{
                "codeURL": "http://qrcode.url.ag/make?0000001496A382FA4725D24FA27839FC1680D136CAFE515519B94B1D&type=QRCODE",
                "code": "10116574123700278846",
                "useTimes": 10,
                "status": "00",
                "statusDesc": "未使用"
            }],
            "validEnd": "20181201000000",
            "validStart": "20181121000000",
            "itemResultMsg": "SUCCESS",
            "itemResultCode": "00",
            "saleChannelItemId": "20181120155110",
            "ticketId": 9000000010,
            "ticketName":"星巴克30元代金券",
            "activityId":"1000000006",
            "activityName":"中信银行星巴克代金券活动"
        }],
        "createDate": "20181120"
    }
}
```