电子面单与电商发货标签静默打印
OMS/WMS 打单台需100×150 面单、批量 SKU 标签静默出纸。HTML 版式 + batchPrint 适合高峰波次;可配合 WMS 远程推送 无人值守。
打印架构
OMS 生成面单 HTML → batchPrint/printHtml → 仓库 PC 客户端 → 热敏/标签打印机。
典型场景
大促高峰 batchPrint
任务数组 + 默认 pdf/printOptions;单条可覆盖打印机。
服务端推送打单
业务服务端暴露 WebSocket/HTTP 接口,工位客户端配置该 URL,见 远程打印。
接入步骤
- 打单 PC 安装客户端并绑定热敏机
- npm 接入 batchPrint
- HTML 按承运商模板排版,margin 归零
- 高峰监控队列与 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/信创混合环境运行;请按终端操作系统安装对应客户端。