零售 POS 热敏小票静默打印

商超、餐饮、便利店等 POS 收银需 80mm 热敏小票快速静默出纸。本文面向门店 IT 与采购,说明双屏架构、连锁混合部署、与 window.print / 云打印的选型对照,以及 printHtml 接入要点。详见 热敏面单专题。

打印架构

POS Web/H5 收银页 → printHtml(80mm HTML) → 收银机本地客户端 → USB/网口热敏机。副屏可用 extraOptions.action: "preview" 给顾客看,主屏静默出纸。

典型场景

80mm 小票

餐饮 / 商超收银

见 80mm 样例;body margin 归零。

双屏 POS

副屏预览 + 主屏静默

预览可用 preview action;正式出纸 silent print。

连锁混合

Win 收银 + Mac 后台

同一 npm API,终端装对应客户端即可。

接入步骤

  1. 收银机(Win 为主)安装客户端,USB 热敏机驱动正常
  2. npm install web-print-pdf 集成到 POS 前端
  3. 小票 HTML 固定 width: 80mm,body margin 归零
  4. printOptions.printerName 与门店打印机名称一致
  5. 断网:getConnectStatus 预检,可缓存订单待恢复后补打
  6. 连锁总部:统一 HTML 模板,各店仅改 printerName 配置

80mm 小票关键参数

await webPrintPdf.printHtml(
  receiptHtml,
  { width: '80mm', height: '120mm', printBackground: true },
  { printerName: 'Thermal printer', copies: 1 }
);

参数要点

  • pdfOptions.width: "80mm",height 按内容或固定
  • printBackground: true 保留 Logo 背景色
  • 热敏机设 printOptions.sharp: true 抗锯齿(仅热敏打印机)
  • 热敏 DPI 下字号用 px 实测,避免过小
  • 错误:formatPrintError 提示「请检查收银机打印服务」

选型要点

方案静默指定打印机适合
window.print否弱极低频、可弹窗
ESC/POS 指令是是传统硬编码小票,难维护版式
云打印 SaaS是是可接受小票数据上云
web-print-pdf + 客户端是是HTML 版式、数据本地、连锁统一 npm

排障清单

  • 多打空白页 → margin/padding 归零,检查 pdfOptions height
  • 字太小 → 58mm/80mm 机实测字号
  • 打印机离线 → 收银流程应阻断并提示,避免漏单
  • Mac 门店后台 → dmg 客户端,API 相同

与本站专题分工

常见问题

POS 浏览器里能静默吗?

可以,需安装 Web打印专家客户端 + web-print-pdf。

USB 热敏机怎么指定?

printOptions.printerName 与客户端列表一致。

离线收银怎么办?

客户端未启动时 getConnectStatus 返回未连接;可先缓存订单待恢复后补打。

和 ESC/POS 指令比?

HTML 版式更易维护;ESC/POS 需专用驱动,HTML 统一走 PDF 渲染链。

UniApp 收银 H5?

H5 在 PC 浏览器可接入;小程序无法直连 PC 客户端,见 uniapp-print。

各平台客户端部署

同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。

免费下载客户端 查看 npm 包 开发文档