电子面单与电商发货标签静默打印

OMS/WMS 打单台需100×150 面单、批量 SKU 标签静默出纸。HTML 版式 + batchPrint 适合高峰波次;可配合 WMS 远程推送 无人值守。

打印架构

OMS 生成面单 HTML → batchPrint/printHtml → 仓库 PC 客户端 → 热敏/标签打印机。

典型场景

波次批量

大促高峰 batchPrint

任务数组 + 默认 pdf/printOptions;单条可覆盖打印机。

远程工位

服务端推送打单

业务服务端暴露 WebSocket/HTTP 接口,工位客户端配置该 URL,见 远程打印。

接入步骤

  1. 打单 PC 安装客户端并绑定热敏机
  2. npm 接入 batchPrint
  3. HTML 按承运商模板排版,margin 归零
  4. 高峰监控队列与 formatPrintError

100×150 面单参数示例

await webPrintPdf.printHtml(
  labelHtml,
  { width: '100mm', height: '150mm', printBackground: true },
  { printerName: 'Label printer' }
);

参数要点

  • 纸宽用 mm 单位 width/height
  • printerName 与热敏机名称一致
  • 批量默认与任务级参数合并规则见 print-options

选型要点

纯浏览器打单无法静默;web-print-pdf + 客户端 为电商仓常用方案。Puppeteer 适合服务端 PDF 归档,不适合工位直打。

排障清单

  • 面单偏移 → 核对 mm 尺寸与打印机纸盒
  • 批量中断 → 检查 WebSocket;见 troubleshoot-websocket
  • 空白页 → HTML margin:0

与本站专题分工

常见问题

能否对接淘宝/京东 OMS?

前端/服务端输出 HTML 或推送任务即可,与平台无关;需本地客户端出纸。

一批 500 张面单?

batchPrint 排队;注意客户端与打印机队列稳定性。

Mac 仓支持吗?

支持 macOS dmg 客户端,API 与 Windows 相同。

和 hiprint 面单模板?

hiprint 重设计器;HTML 模板 + printHtml 更轻,见 hiprint 对比。

远程多工位?

每工位装客户端,服务端 WebSocket/HTTP 推送,见 wms-remote-print。

各平台客户端部署

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

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