如何使用云打印
什么是云打印
云打印是一种通过网络将打印任务发送到远程打印机的方式。配置完成后，系统可直接将数据发送至云打印服务并转发到指定打印机，无需在本地电脑安装驱动或保持浏览器开启。
在 HAP 中启用后，可实现：
- 自动打印订单、小票、标签
- 无人值守打印
- 多门店统一打印管理
当前支持平台： 快麦云打印。
适用场景与硬件支持
适用场景：
- 标签打印：商品标签、资产标签
- 小票打印：门店订单、小票
支持设备：
- 标签打印机
- 小票打印机
注：具体型号以快麦云开放平台支持的设备为准。
一、快麦云平台配置
在 HAP 中使用云打印前，需先在快麦平台完成基础准备。
1. 注册快麦账号
登录或注册快麦账号：http://admin.iot.kuaimai.com/login
2. 获取 appID 和 appSecret
登录后进入【系统集成】页面，复制并妥善保存 appId 和 appSecret（用于 HAP 鉴权）。
3. 添加打印设备
- 进入 【设备管理】，点击 【添加设备】。
- 使用微信扫码。
- 输入设备序列号（SN）和密钥完成绑定。
4. 创建应用与字段
- 进入 【应用管理】，点击 【新增应用】 并填写名称与描述。
- 进入 【模板管理】 > 【字段管理】，选择对应应用。
- 点击 【新建字段】，依次填写 表名、字段名、中文名称 并保存。
二、HAP 服务配置
1. 连接快麦云服务
- 管理员进入 【组织管理】 > 【集成】 > 【系统服务】。
- 点击 【云打 印】 卡片，选择 “快麦云打印”。
- 填入快麦平台的 appId 和 appSecret 并保存。
2. 新建云打印模板
- 进入目标工作表的 【更多设置】 > 【打印模板】。
- 点击 【新建模板】，选择 【快麦云打印】。
三、标签打印配置
标签打印模板主要用于主表数据打印，如商品标签、资产标签、生产标签。
配置步骤:
-
在快麦平台的 【模板管理】> 【标签编辑】中新增公共标签模板并设计样式。
-
将需要从 HAP 动态获取的数据，在右侧 数据类型 中设置为 “动态获取”。
-
在快麦模板列表中点击 【获取渲染数据】，复制弹窗中的 “API 接口动态渲染数据示例”。
在快麦平台打印模板列表中，可查看打印模板ID，点击模板中的获取渲染数据按钮，复制弹窗中显示的api接口动态渲染数据示例。
-
返回 HAP 打印模板设置页，选择 【标签】 模板类型，并填写 设备序列号 和 打印模板 ID，
-
将第3步复制的渲染数据示例粘贴至 「字段解析」 框，绑定 HAP 字段与快麦字段的映射关系并保存。
-
保存配置。
四、小票打印配置
小票模板主要用于动态子表打印（如门店订单、销售小票）。
配置步骤:
-
在快麦平台 【模板管理】 > 【小票编辑】 中新增公共小票模板并设计样式。
-
设计样式时，将动态数据设置为 “动态获取”。
注意： 若需同时打印主表与子表数据，在快麦平台的【模板管理】>【字段管理】中需设置 2 个表（分别对应 HAP 的主表字段和子表字段）。
-
复制模板详情中模板id和 “api接口动态渲染数据示例” 代码。
-
返回 HAP 打印模板设置页，选择 【小票】 模板类型，填写 设备序列号 和 打印模板 ID，
-
将第3步复制的渲染数据示例粘贴至 「字段解析」 框，绑定 HAP 字段与快麦字段的映射关系并保存。
若模板有子表/关联表数据，在解析时需要手动选择主表字段，若没有子表数据，则不显示这一步。
- 保存配置。
五、使用方式
配置完成后，可在以下位置使用打印功能：
-
记录详情页： 点击【打印】按钮选择对应云打印模板。
-
列表页： 勾选多条记录进行批量打印（单次不超过 50 条）。
六、云打印问题排查
若配置后无法正常打印，请参考下表快速定位：
| 问题现象 | 可能原因 | 责任归属 | 处理建议 |
|---|---|---|---|
| 打印按钮无法使用 | 配置未保存或按钮未发布 | HAP | 检查打印按钮配置状态 |
| 数据结构错误 | 字段解析 JSON 格式错误 | HAP | 重新从快麦复制渲染数据示例并解析 |
| 字段绑定后打印为空 | 字段映射关系错误 | HAP | 核对 HAP 字段与快麦字段的绑定关系 |
| 提示设备离线 | 打印机断网或未开机 | 快麦云 | 检查打印机电源及网络状态 |
| 序列号不存在 | SN 码填错或设备未激活 | 快麦云 | 核对序列号并确认设备已在快麦激活 |
| 类型不匹配 | 标签/小票模板 ID 混用 | HAP/快麦 | 检查模板类型与 HAP 按钮类型是否一致 |