> **特别提醒：在购买和使用此插件前请确认你已购买芯烨`小票云打印机`或`标签云打印机`。**
> 京东商城推荐：[芯烨（XINYE）XP-T58H全自动外卖接单小票打印机 美团饿了么百度热敏云打印机真人语音 收银票据无线WIFI版](https://www.62720.com/page/jump?url=https%3A%2F%2Funion-click.jd.com%2Fjdc%3Fe%3D618%257Cpc%257C%26p%3DJF8BARQJK1olXwQAVVdUAE8WBl8IGloUXQEFV1lYDUwnRzBQRQQlBENHFRxWFlVPRjtUBABAQlRcCEBdCUoWA2gPGFwQWAEdDRsBVXtuRxYOaQFqXGRnJlYtEhZxUxNMUB11UQoyVW5dCUoUBGgBG1oUbTYCU24fZgJWQDdXXg9WWg8HV1ldAHsWM28PE1kVVQIDUFpUDUInBG8BK10SXw8BXV1bFEMQBm4MH10RbTYyV25aCEIDBR1JSU8TLzYyVG5eOEsWA2YOGV4XXQYCSF5cDU0RAXMIHFMXXQ4GVVtcAUgWM20JGl8cbTYyUwIuUQ1gCjp2ZQddDVFiUlkneA9EWStwdVlcD11BUBsbVDVtYQhDZx1NWzY)
[](https://www.62720.com/page/jump?url=https%3A%2F%2Funion-click.jd.com%2Fjdc%3Fe%3D618%257Cpc%257C%26p%3DJF8BARQJK1olXwQAVVdUAE8WBl8IGloUXQEFV1lYDUwnRzBQRQQlBENHFRxWFlVPRjtUBABAQlRcCEBdCUoWA2gPGFwQWAEdDRsBVXtuRxYOaQFqXGRnJlYtEhZxUxNMUB11UQoyVW5dCUoUBGgBG1oUbTYCU24fZgJWQDdXXg9WWg8HV1ldAHsWM28PE1kVVQIDUFpUDUInBG8BK10SXw8BXV1bFEMQBm4MH10RbTYyV25aCEIDBR1JSU8TLzYyVG5eOEsWA2YOGV4XXQYCSF5cDU0RAXMIHFMXXQ4GVVtcAUgWM20JGl8cbTYyUwIuUQ1gCjp2ZQddDVFiUlkneA9EWStwdVlcD11BUBsbVDVtYQhDZx1NWzY "芯烨（XINYE）XP-T58H全自动外卖接单小票打印机")
# 1. 获取接口秘钥
第一步： 登录芯烨云开放平台 https://admin.xpyun.net/ ，没有账号请直接注册并登录。
第二步： 登录开放平台后，打开此链接：https://admin.xpyun.net/user-manage/identity-auth 完成实名认证。
第三步： 待实名认证审核通过后，打开此链接：https://admin.xpyun.net/user-manage/user-info 获取`开发者ID`和`开发者秘钥`。
第四步： 进入您的网站管理后台：系统 -> 系统管理 -> 应用管理页面，找到`芯烨云打印`应用，点击`配置`按钮，在弹出的表单里面填写第三步获取到的`开发者ID`和`开发者秘钥`即可。
# 2. 添加打印设备
# 3. 创建模板
示例模板内容如下：
```html
<CB> 自营外卖单 {:PHP_EOL}
<L><N>--------------------------------{:PHP_EOL}
<CB>--{$order['receive_method']==1?'骑手配送':($order['receive_method']==2?($order['dining_method']==1?'店内就餐':'打包带走'):($order['receive_method']==3?'到店自提':'定点取货'))}--{:PHP_EOL}
<L><N>下单时间:{:date('Y年m月d日 H时i分', strtotime($order['create_time']))}{:PHP_EOL}
订单编号:{$order['order_no']}{:PHP_EOL}
**************商品**************{:PHP_EOL}
{foreach name="$order['skus']" id="item"}{php}$len = 28-str_len($item['name'].$item['quantity'].$item['price']);{/php}<L><N>{$item['name']}{:str_repeat(' ', $len)} x{$item['quantity']} {$item['price']}</L>{:PHP_EOL}
{/foreach}
--------------------------------{:PHP_EOL}
配送费:￥{$order['delivery_fee']}{:PHP_EOL}
--------------------------------{:PHP_EOL}
小计:￥{$order['product_amount']+$order['delivery_fee']}{:PHP_EOL}
<L><N>********************************{:PHP_EOL}
<B>订单总价:￥{$order['order_amount']}{:PHP_EOL}
<N>地址：{$order['consignee_address']}{:PHP_EOL}
电话：{$order['consignee_name']} {$order['consignee_mobile']}{:PHP_EOL}
备注：{$order['buyer_memo']}{:PHP_EOL}
<C><HB>** 完 **{:PHP_EOL}
<L><N>请使用微信扫码{:PHP_EOL}
<L><QRCODE s=6 e=L l=center>二维码地址</QRCODE>
```
>模板内容支持直接使用TP内置的所有模板标签。
# 4. 如何调用？
| 参数名 | 类型 | 必须 | 默认值 | 说明 |
| :------------: | :------------: | :------------: | :------------: | :------------|
| order_no | int/string | 必须 | | 内部订单号 |
| template | string | 可选 | | 模板别名，通过后台模板管理页面获取，`当content参数为空时，此参数为必须` |
| content | string/array | 可选 | | 打印内容，`当template里面含有变量时，请传入数据集合` |
| sn | string | 可选 | | 设备号，不指定将自动提取可用设备号 |
| copies | int | 可选 | 1 | 打印份数 |
| cutter | int | 可选 | 0 | 切刀控制开关，1关闭云端切刀，若想自己设置切刀位置，可以通过 <CUT> 标签设置切刀 `仅用于支持切刀的芯烨云打印机` |
| voice | int | 可选 | 2 | 声音播放模式，0 取消订单，1 静音模式，2 来单播放，3 申请退单 |
| mode | int | 可选 | 0 | 打印模式：值为 0 或不指定则会检查打印机是否在线，如果不在线 则不生成打印订单，直接返回设备不在线状态码；如果在线则生成打印订单，并返回打印订单号。值为 1不检查打印机是否在线，直接生成打印订单，并返回打印订单号。如果打印机不在线，订单将缓存在打印队列中，打印机正常在线时会自动打印。 |
| expiresIn | int | 可选 | 0 | 订单有效期，单位：秒。订单打印时，超过该时间的订单将不会自动加载打印，当参数设置为 0 时，将采用系统默认设置值。`使用该参数时，需要将参数mode 设置为1`。取值范围：0 < expiresIn < 86400。 |
| payType | int | 可选 | | 支付方式：支付宝 41、微信 42、云支付 43、银联刷卡 44、银联支付 45、会员卡消费 46、会员卡充值 47、翼支付 48、成功收款 49、嘉联支付 50、壹钱包 51、京东支付 52、快钱支付 53、威支付 54、享钱支付55`仅用于支持金额播报的芯烨云打印机` |
| payMode | int | 可选 | | 支付与否：退款 59 到账 60 消费 61 `仅用于支持金额播报的芯烨云打印机` |
| money | float | 可选 | | 播报金额，最多允许保留2位小数 `仅用于支持金额播报的芯烨云打印机` |
>示例1：直接打印内容
```php
$param = [
'order_no' => 202301010101,
'voice' => 2,
'copies' => 1,
'payMode' => 60,
'payType' => 42,
'money' => 50,
'content' => '这是一张小票测试单',
];
$resp = $this->pluginXpyunLogicXpyun->printTicket($param);// 直接调用
// $resp = event('PrintTicket', $param, true);// 通过事件函数调用
if ($resp['code']) {// 成功
print_r($resp['data']);
} else {// 失败
echo $resp['msg'];
}
```
>示例2：通过模板打印
```php
$param = [
'order_no' => 202301010101,
'voice' => 2,
'copies' => 1,
'payMode' => 60,
'payType' => 42,
'money' => 50,
'template' => 'order',
'content' => [// 此处的示例数据是配合第三步的示例模板使用的
'order' => [
'order_no' => 2023082711185582242,
'receive_method' => 1,
'order_amount' => 115.00,
'delivery_fee' => 0.00,
'product_amount' => 115.00,
'buyer_memo' => '',
'consignee_name' => '张三',
'consignee_mobile' => 13888888888,
'consignee_address' => '花园小区一期 1 栋 1001',
'dining_method' => 0,
'create_time' => '2023-08-27 11:18:55',
'skus' => [
[
'name' => '猪脚饭',
'spec' => '',
'quantity' => 5,
'price' => 23.00,
],
],
]
],
];
$resp = $this->pluginXpyunLogicXpyun->printTicket($param);// 直接调用
// $resp = event('PrintTicket', $param, true);// 通过事件函数调用
if ($resp['code']) {// 成功
print_r($resp['data']);
} else {// 失败
echo $resp['msg'];
}
```
