打印中心、模板、代理打印机、路由与任务队列

组件关系

打印档案定义纸张和标签尺寸，打印模板定义字段与版式，门店代理打印机定义实际设备、驱动和业务能力，打印路由决定单据使用哪台本店设备，打印任务记录每次输出。销售、收货、面单或标签业务成功后才创建相应打印任务；打印失败不能回滚已经完成的收款、库存或取号。

PC 端配置

1. 进入“系统管理 → 打印中心 → 打印档案（含标签尺寸）”，建立实际纸张规格。
2. 在“打印模板中心”选择业务类型，使用页面维护受约束的 schema JSON，配置字段、列宽、分页和门店品牌信息并保存版本；不要直接粘贴来源不明的脚本或模板。
3. 在“代理打印机”登记实际设备，选择所属门店、驱动类型、连接参数、纸宽和业务能力，安全保存首次生成的设备密钥并执行测试页。设备密钥只交给对应门店代理服务，不能写入文档或工单。
4. 在“打印路由”选择门店、单据类型、打印机、档案和模板。比如产品标签使用标签机，销售单使用小票机，快递面单使用面单机；这些关系由用户配置，不按设备类型写死。
5. 在“打印任务”用测试订单生成任务，确认队列、设备和出纸结果后再开放给员工岗位。

打印档案不会按驱动类型或纸宽强制隐藏，用户可选择全部启用档案；若实际设备与档案的协议或纸张不匹配，保存前应确认并先测试。打印机、路由和任务执行门店隔离，严格限制在所属门店内，不能跨门店调用设备。

销售单列表支持批量打印。勾选同一门店、同一业务类型的单据后提交，单批最多 100 张；系统生成批次号和多条独立任务，失败项可以单独重试。

当前生产推荐使用服务端代理打印，由门店代理服务消费打印队列。Android APP 可以选择当前门店已绑定的代理打印机并查看任务状态；微信小程序和浏览器使用同一队列，不直接控制本地设备。

打印中心的配置、模板、代理设备和重试权限按岗位开放；普通业务岗位只应处理授权门店的任务，老板或打印管理岗位负责设备和模板。业务保存成功、物流取号成功、任务进入队列和实际出纸是四个不同结果，验收时要分别记录，不能用“页面没有报错”替代出纸确认。

尚未完成的移动直连通道

移动端 WiFi/LAN 原生 TCP 打印和蓝牙直连目前只是配置/兼容预留：代码会提示 WiFi/LAN 通道尚未接入，蓝牙需要 Android 真机插件验证。不能在客户验收表中把这两项标记为已完成，也不要通过反复取号或重复提交来测试打印。只有后续版本发布说明明确开放，并完成对应手机、打印机和异常恢复验收后，才能改变这一结论。

失败与重打

进入“打印任务”查看待处理、成功和失败状态。断纸、离线或网络超时先确认设备是否已经实际出纸，再决定是否将原任务重新入队；电子面单重复打印可以使用同一运单，不能为了重打再次向物流商取号。业务已成功但没有出纸时，先保留任务和请求编号，检查代理服务、设备编码、纸张和模板。

验收

分别测试小票、商品标签和电子面单，核对纸张尺寸、中文、条码、金额及门店信息；同时验证员工岗位只能查看和操作授权门店的队列。保留一条失败后恢复的任务，确认重试次数、操作人和最终出纸结果可追溯。