Skip to main content

新增券模板接口

接口用途

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

接口说明

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

action

  • templateInsert

请求参数,ERP===>WHALE

字段 类型 是否必填 字段意义 备注
templateName String 是 券模板名称  
sendChannelId Long 是 制码渠道ID  
brandId Long 是 品牌ID  
productId Long 是 易百产品ID  
ticketType int 是 券类型 1:代金券,2:折抵券,3:产品抵用券,4:复合产品券
faceValue String 是 面值 12位字符串,分为单位
sendType String 是 券模板名称 1:接口,2:批导
isActive String 否 是否启用(Y/N) 如不填,默认情况是启用
remark String 否 备注  
createUser String 否 创建人  
createTime String 是 创建时间 yyyyMMddHHmmss
updateTime String 是 更新时间 yyyyMMddHHmmss
templateConfig Object<templateConfig> 否 券模板配置

请求报文举例

{
    "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"
    }
}

返回参数,中间件===>收银机

字段 类型 是否必填 字段意义 备注
traceNo String 是 收银机流水号 不允许重复
orderNo String 是 交易订单号 单位:元
transDate String 是 交易时间 格式为:YYYYmmddHHMMSS
returnCode String 是 返回码 00表示交易成功,其他表示失败
returnDesc String 是 返回信息 交易结果描述或错误原因
rightsTimes Integer 是 权益次数 返回可以享受的权益次数
moneyBalance Price 是 现金余额 单位:元
pointBalance Price 是 积分余额 单位:分
printDetail Object<printDetail> 否 打印信息 如需要在收银小票上打印信息时必填
memberDetail Object<memberDetail> 否 会员信息 返回本次交易的会员信息

返回报文举例

{
    "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
    }
}