打印机配置
打印机有两处可配，用途不同：
| 在哪 | 管什么 |
|---|---|
| 平板 → 更多 → 设备打印 | 这台平板连哪些打印机（IP、SN、蓝牙） |
| PC 后台 → 设置 → 打印设置 | 出单档口、路由规则、设备状态、打印任务队列 |
日常新增删除在平板上做，分流规则在后台做。
平板：新增打印机
更多 → 设备打印。左边是配置面板，右边是已配打印机列表。
两类角色，分开配
| 角色 | 打什么 |
|---|---|
| 收据打印机 | 结账单、预结算单、退款小票 |
| 厨房打印机 | 制作单、退菜单、外卖单、自取单 |
只有一台机器的店，两个角色可以指向同一台。但两个角色都要配上，否则对应票据不出。
新增步骤
- 在对应分组右上角点 新增收据打印机 / 新增厨房打印机
- 填打印机名称（自己认得出就行，比如「吧台机」「后厨机」）
- 选连接方式
- 按连接方式填参数（见下）
- 选纸型
- 保存打印配置
- 点测试打印验证
空的时候页面会提示「暂无…，点击右上角「新增…」开始」。
连接方式
网络打印（推荐）
打印机和平板在同一局域网，填：
- 打印机 IP —— 例如
192.168.1.50 - 端口 —— 默认
9100
必须同一个网段
打印机和平板要在同一个 Wi-Fi 下，不能一个连 5G 频段一个连 2.4G 的独立子网。这是「打印机连不上」最常见的原因。
不确定的话，看打印机自检页打出来的 IP，前三段要和平板 IP 的前三段一致。
云打印
不在同一局域网也能打，走厂商云服务。支持两家：
| 厂商 | 要填 |
|---|---|
| 芯烨云（XPYUN） | 云打印 SN |
| 飞鹅云（FEIEYUN） | 云打印 SN + 飞鹅云 KEY |
SN 和 KEY 在打印机机身标签或厂商后台上。
蓝牙打印
填蓝牙 MAC。必须在 POS 平板 App 内操作——浏览器里没有原生打印通道，会提示「未检测到原生打印通道，请在 POS 平板上操作」。
纸型
- 小票机 —— 常规热敏小票
- 标签机 —— 另外填 标签宽度(mm) 和 标签高度(mm)
标签宽高没填就保存
会提示「请填写标签宽高后再保存」。杯贴标签常见是 40×30mm，以实际耗材为准。
平板：删除打印机
在打印机卡片右上角点 移除。
移除会同时删掉后台的这台打印机（提示「打印机已移除」）。如果提示「后台删除打印机失败」，多半是网络问题，联网后重试。
只是暂时不用，别删
换机器、送修期间，直接删掉之后要重填一遍 IP 和绑定关系。可以在后台把这台设备停用，恢复时再启用。
平板：同步后台打印机
点 同步后台打印机，把后台已配置的在线打印机拉到本机。
第二台平板不用重新填一遍 IP —— 第一台配好后，第二台点这个按钮直接拉过去。
后台没有可同步的在线打印机时会提示「后台暂无可同步的在线打印机」。
添加打印机 = 后台 + 本机都生效
在平板上新增的打印机会同时写到后台，所以同步是双向可用的。
测试打印
打出来的纸上会带 IP，核对一下是不是你想配的那台——多台打印机时这一步能省掉大量猜测。
打出「如能看到此票，连接正常。」就说明通了。
后台：打印设置
PC 后台 → 设置 → 打印设置。管的是分流规则和运行状态。
设备管理
设备表显示每台打印机的设备、状态（在线 / 停用）和绑定。
每台设备可以：
- 设为默认 —— 没有更具体规则时走这台
- 绑定结账 / 绑定退款 / 绑定标签 —— 让这台机器接对应票据类型
- 刷新设备 —— 重新拉一次在线状态
绑定后设备上会显示徽标：默认 / 结账 / 退款 / 标签。页面顶部有一行汇总：「默认打印机: X / 结账打印机: Y / 退款打印机: Z / 标签打印机: W」，没设的显示「未设置」。
票据样式里选不到打印机
如果票据样式提示「未找到支持该票据类型的启用打印机」，就是这里没绑。先绑定对应票据类型再回去设默认。
打印档口
新增档口，维护后厨、吧台等出单点：
| 字段 | 说明 |
|---|---|
| 档口名称 | 如「热厨」「冷吧」 |
| 档口编码 | 唯一标识 |
| 档口类型 | 后厨 / 吧台 / 收银台 / 自取区 / 外卖区 |
| 绑定打印机 | 这个档口的单子打到哪台 |
| 档口打印份数 | 一单打几份 |
| 档口状态 | 启用 / 停用 |
路由规则
新增路由规则，决定什么单子进哪个档口：
| 字段 | 说明 |
|---|---|
| 路由范围 | 默认 / 分类 / 商品 |
| 分类编码 或 商品 ID | 范围选分类或商品时填 |
| 目标档口 | 打到哪个档口 |
| 打印内容 | 收据 / 厨房 / 出菜单 / 自取单 / 外卖单 |
| 打印份数 | 这条规则打几份 |
| 路由门店 | 这条规则作用在哪家店 |
| 路由状态 | 启用 / 停用 |
匹配顺序是从具体到宽泛：先找有没有匹配这个商品的规则，没有再找分类的，都没有走默认。
典型配法
- 一条默认规则 → 后厨档口
- 一条分类规则：分类 = 生啤 → 吧台档口
- 个别特殊商品再加商品级规则
这样新商品加进来自动有归属，不用每加一个商品配一次。
打印任务
任务表显示每个打印任务的任务、设备、状态、说明和时间。
状态三种：排队中 / 成功 / 失败。
失败的任务可以：
- 重新排队 —— 让它再试一次
- 立即派单 —— 不等队列直接发
- 标记成功 / 标记失败 —— 人工修正状态（比如实际打出来了但系统记成失败）
云打印可以点 同步云端状态 从厂商拉最新结果。
排查顺序
一堆任务卡在「排队中」→ 看设备是不是离线。 任务显示「失败」但纸其实出来了 → 标记成功，避免重复补打。
连不上的排查顺序
按这个顺序查，多数问题停在第 2 步：
- 看指示灯 —— 电源灯不亮先换插座，别先怀疑软件
- 看纸仓 —— 缺纸、纸装反、仓盖没扣到位都会让打印机静默失败
- 看网络 —— 打印机和平板同一个 Wi-Fi，IP 前三段一致
- 测试打印 —— 能出测试页说明设备和网络都没问题，往下查
- 看后台任务队列 —— 有没有任务、状态是什么
- 看路由和绑定 —— 单子有没有被分到这台机器上
高峰期不要直接断电重启
未出单的订单会留在打印队列里，重启后可能重复打印。先在系统里暂停出单，再断电。
制作单没打到对的档口
不是打印机的问题，查两处：
字太小看不清
不是打印机的问题，去票据样式调字号。