热敏小票与快递面单静默打印

零售小票、餐饮 80mm 热敏纸、WMS/OMS 快递面单与标签,常见需求是无浏览器弹窗、指定热敏打印机、批量出纸。用 HTML/CSS 描述版式,经 web-print-pdf 转 PDF 后由本地客户端静默打印——Windows 收银机、macOS 门店 PC、Linux/信创仓库终端 可共用同一套前端代码。

热敏/面单打印架构

版式用 HTML/CSS 描述纸宽。本地场景:浏览器调 printHtml / batchPrint 出纸;远程高峰:不调 npm,把同结构任务提交到自建接收服务,工位客户端配置消费接口 URL(见 远程打印、WMS 推送)。

典型场景

80mm 小票

餐饮 / 零售热敏小票

pdfOptions 指定纸宽(如 80mm)、html/body margin 归零避免多页;适合 POS、外卖档口。见 80mm 在线样例。

快递面单

WMS 面单 / 包裹标签

订单系统推送 HTML 或 URL,仓库 PC 批量 silent print;可配合 远程打印 无人值守。见 批量标签样例。

混合部署

Win 前台 + 信创后台

同一 npm 包:Windows 门店 exe 客户端与银河麒麟/UOS deb 客户端 API 一致,减少多套打印栈维护成本。

接入步骤

  1. 收银/仓库 PC 安装 Web打印专家客户端
  2. 本地打印:前端 npm install web-print-pdf,按纸宽编写 HTML/CSS(热敏纸务必 margin:0),调用 printHtml 或 batchPrint
  3. 远程高峰:不调 npm,服务端按固定格式入队并暴露消费接口,工位客户端「远程打印配置」填该 URL(见 远程打印专题)

80mm 小票关键参数示例

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

参数要点

  • 纸宽:pdfOptions 使用 width/height(如 80mm)而非 A4
  • 边距:HTML 内 html, body { margin:0; padding:0; }
  • 打印机:printOptions.printerName 填热敏机名称(客户端枚举)
  • 抗锯齿:热敏打印机在 printOptions 设 sharp: true,消除文字边缘锯齿(仅热敏机需要)
  • 批量:面单高峰用 batchPrint;参数详见 打印参数专题

按纸型选型要点

纸型pdfOptions 要点常见场景
80mm 小票width: 80mm,HTML margin:0餐饮、零售 POS
100×150 面单精确 width/height,归零边距快递、WMS
A4 报表paperFormat: A4见 打印参数

排障清单

  • 空白页/多页:检查 body margin 与 pdfOptions 高度
  • 内容被截断:纸宽小于 HTML 固定宽度
  • 打错打印机:核对 printerName 与客户端枚举
  • Mac/信创:安装对应 dmg/deb,API 与 Windows 相同

与本站专题分工

常见问题

热敏纸打印出现空白页或多页怎么办?

多为 body 默认 margin 或纸高设置过大。参考 80mm 样例归零边距,并核对 pdfOptions 的 width/height 与物理纸宽一致。

能否只打印面单不弹浏览器对话框?

可以。window.print 无法静默;web-print-pdf + 本地客户端可 silent print 到指定热敏机。

ERP 推任务、仓库 PC 自动打可以吗?

可以。在自有服务端按固定格式接收/存储任务并暴露 WebSocket/HTTP 消费接口,工位客户端配置该 URL 后自动出纸——不需要在网页调 webPrintPdf.printHtml(npm 仅作字段格式对照)。见 远程打印专题。

Mac 门店或信创终端支持吗?

支持。官方提供 macOS dmg 与 Linux deb(含麒麟/UOS),与 Windows 使用相同 printHtml API。

Lodop 面单能否迁移到 HTML?

许多快递面单适合 HTML 化 PoC;精密套打可继续 Lodop 并行。见 Lodop 并行接入指南。

各平台客户端部署

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

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