WMS 仓储远程面单静默打印

物流企业 WMS/OMS 常见模式:打印任务消息 JSON 格式固定;在自有服务端开发接收、存储任务并暴露 WebSocket/HTTP 接口的程序,工位 PC 客户端配置该 URL 后自动出纸。详见 远程打印配置。

WMS 远程打印架构

典型三层:WMS/OMS 按固定消息格式入队 → 自建服务接收/存储并暴露 WebSocket/HTTP 消费接口 → 工位客户端配置该 URL → 本地出纸。服务端不装客户端;远程链路不调用 webPrintPdf.printHtml 等 npm API(API 仅作字段格式对照)。

典型场景

推模式

ERP/WMS 推送任务

业务服务端维护任务队列,通过自暴露的接口供工位客户端拉取/接收并打印。

多仓多机

每台 PC 指定热敏机

printOptions.printerName 绑定各工位打印机;Win/Mac/Linux 同一 API。

接入步骤

  1. 熟悉固定消息格式(见 远程打印专题)
  2. 在 WMS 服务端开发任务接收、存储与 WebSocket/HTTP 接口暴露程序
  3. 仓库 PC 安装客户端,于「远程打印配置」填入该接口 URL
  4. 面单 HTML 归零边距,匹配物理纸宽
  5. 失败告警对接 错误处理

面单打印参数示例

远程无人值守不需要调用 webPrintPdf.printHtml。下方为 WMS 服务端按固定格式入队示例;各字段含义可对照 printHtml API 或客户端「测试任务」(本地 PoC 时才在浏览器调 npm)。

// WMS server: enqueue fixed-format jobs (remote path — do not call printHtml)
const task = {
  id: crypto.randomUUID(),
  timestamp: Date.now(),
  type: 'printHtml',
  content: labelHtml,
  pdfOptions: { width: '100mm', height: '150mm', printBackground: true },
  printOptions: { printerName: stationPrinter },
  extraOptions: { requestTimeout: 15 }
};
queue.push(task);
// Desk client: set Remote print URL to your WebSocket/HTTP endpoint

要点清单

  • 远程通道:WebSocket 或 HTTP 轮询
  • 纸宽:pdfOptions width/height 与热敏机一致
  • 静默:必须本地客户端,纯浏览器无法实现
  • 对比 Lodop/Print.js:见 Lodop 对比

推模式 vs 拉模式

模式适用说明
WebSocket 推送高峰批量、低延迟客户端连你暴露的 WS 接口收任务
HTTP 轮询防火墙限制 WebSocket客户端定时拉取你暴露的 HTTP 接口
浏览器本地打印仓管手动补打网页集成 npm 调 printHtml,非远程无人值守

排障清单

  • 客户端远程 URL 是否与 WMS 推送地址一致
  • 面单 HTML 边距是否归零(避免空白页)
  • printOptions.printerName 是否与工位热敏机驱动名一致
  • 高峰任务是否需 batchPrint 或队列节流
  • 失败是否对接 错误处理 与重试

与本站专题分工

常见问题

WMS 服务端要装客户端吗?

不需要。客户端装在仓库打印 PC;服务端只推送任务。

能否无人值守?

可以。客户端连接你暴露的消费接口后自动取任务出纸,全程无浏览器对话框,不调用网页 webPrintPdf.printHtml(npm 仅本地打印或格式对照用)。

信创仓库终端?

支持。麒麟/UOS 安装 deb 客户端即可,见 麒麟/UOS 专题。

多仓库多打印机如何绑定?

各工位客户端配置不同 printerName;WMS 推送时可带工位 ID,前端/客户端路由到对应打印机。详见 打印参数。

各平台客户端部署

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

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