语法

模板采用 freemarker 引擎解析，所以原生支持所有的 freemarker 语法，你可以自行百度一下 freemarker 语法的简单使用，包括如何判断、如何循环、如何格式化处理数据等等

标签支持

打印机使用标签(类似 html 格式)来格式化输出内容，具体说明如下：

<BR> ：换行符
<CUT> ：切刀指令(主动切纸,仅限切刀打印机使用才有效果) 
<LOGO> ：打印LOGO指令(前提是预先在机器内置LOGO图片)
<PLUGIN> ：钱箱或者外置音响指令
<CB></CB>：居中放大
<B></B>：放大一倍
<C></C>：居中
<L></L>：字体变高一倍
<W></W>：字体变宽一倍
<QR></QR>：二维码（单个订单，最多只能打印一个二维码）
<RIGHT></RIGHT>：右对齐
<BOLD></BOLD>：字体加粗

参考模板

<CB>${order.id} 号</CB><BR>
<RIGHT>${.now?datetime}</RIGHT><BR>
名称                数量 金额<BR>
--------------------------------<BR>
<#list goods as test>
${test.goodsName} ${test.property!""}   ${test.number}  ${test.amount}
</#list>
--------------------------------<BR>
合计：${order.amountReal}元<BR>
订单号：${order.orderNumber}<BR>
联系电话：0571-28180512<BR>
<QR>https://www.it120.cc/</QR>

可用变量

打印时间

${.now?string('yyyy-MM-dd HH:mm:ss')}

时间格式化参数说明：

yyyy 为4位数的年份
MM 为2位数的月份
dd 为日期
HH 为24小时制的小时数
mm 为分钟数
ss 为秒数

具体可以查阅 freemarker 的使用手册

订单相关变量引用

${order.XXXXX}

后台订单详情接口返回的json数据中的 order 对象里的值都可以调用，比如：

${order.qudanhao} 将会打印出取餐号；

${order.orderNumber} 将会打印出订单号；

${order.amountReal} 将会打印出订单实际支付金额；

{
  "amount": 500, // 商品货款金额，不包含运费
  "amountLogistics": 0, // 运费价格
  "amountReal": 500, // 订单实际金额
  "dateAdd": "2020-02-25 11:43:40", // 下单时间
  "goodsNumber": 1, // 商品数量
  "id": 464320, // 订单ID
  "qudanhao": "0006", // 取餐号
  "orderNumber": "20022511439510006", // 订单号
  "isNeedLogistics": true, // 是否需要快递
  "isPay": true, // 是否已支付
  "pingtuanOpenId": false, // 拼团团号
  "isSuccessPingtuan": false, // 是否已成团
  "payNumber": "ZF2002251642338367", // 微信支付订单号
  "remark": "不要麻也不要辣", // 备注
}

订单的商品明细

<#list goods as test>
...  （这里面就可以调用 ${test.XXXX} 来显示商品数据）
</#list>

上面代码遍历打印所有的订单商品，后台订单详情接口返回的json数据中的 goodsList 对象里的值都可以调用

{
  "amount": 500, // 商品总价
  "amountSingle": 500, // 单价
  "goodsName": "WIFI 58mm 热敏打印机工厂定制版", // 商品名称
  "number": 1, // 商品数量
  "pic": "https://cdn.it120.cc/apifactory/2019/03/07/133eb6294e3853ebe4eb8551359a26dc.png", // 商品图片
}

收货地址

${logistics.XXXXXX}

后台订单详情接口返回的json数据中的 apiExtOrderLogistics 对象里的值都可以调用

{
  "address": "详细地址",
  "areaStr": "南岸区",
  "cityId": "500100000000",
  "cityStr": "市辖区",
  "code": "322000", // 邮编
  "districtId": "500108000000",
  "linkMan": "收件人姓名",
  "mobile": "手机号码",
  "provinceId": "500000000000", // 省份编号
  "provinceStr": "重庆市",
  "shipperName": "其他快递公司",
  "trackingNumber": "快递单号",
  "type": 0 // 0 快递，1 达达配送, 2 美团配送， 3 快跑者
}

所属门店数据

${shopInfo.XXXXXX}

如果当前订单有归属门店，那么你就可以调用上面的变量直接打印门店数据；

后台门店详情接口返回的json数据中变量都可以调用

订单扩展属性

${extJson.XXXXXX}

后台订单详情接口返回的json数据中的 extJson 对象里的值都可以调用

"api工厂" 使用手册

云打印机模板变量详细说明

语法