# 新增券模板接口

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

- 当需要创建新的券模板时，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
    }
}
```