ERP/WMS 推送任务
业务服务端维护任务队列,通过自暴露的接口供工位客户端拉取/接收并打印。
物流企业 WMS/OMS 常见模式:打印任务消息 JSON 格式固定;在自有服务端开发接收、存储任务并暴露 WebSocket/HTTP 接口的程序,工位 PC 客户端配置该 URL 后自动出纸。详见 远程打印配置。
典型三层:WMS/OMS 按固定消息格式入队 → 自建服务接收/存储并暴露 WebSocket/HTTP 消费接口 → 工位客户端配置该 URL → 本地出纸。服务端不装客户端;远程链路不调用 webPrintPdf.printHtml 等 npm API(API 仅作字段格式对照)。
远程无人值守不需要调用 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 推送 | 高峰批量、低延迟 | 客户端连你暴露的 WS 接口收任务 |
| HTTP 轮询 | 防火墙限制 WebSocket | 客户端定时拉取你暴露的 HTTP 接口 |
| 浏览器本地打印 | 仓管手动补打 | 网页集成 npm 调 printHtml,非远程无人值守 |
printOptions.printerName 是否与工位热敏机驱动名一致batchPrint 或队列节流不需要。客户端装在仓库打印 PC;服务端只推送任务。
可以。客户端连接你暴露的消费接口后自动取任务出纸,全程无浏览器对话框,不调用网页 webPrintPdf.printHtml(npm 仅本地打印或格式对照用)。
window.print 无法静默批量;见 window.print 替代。
各工位客户端配置不同 printerName;WMS 推送时可带工位 ID,前端/客户端路由到对应打印机。详见 打印参数。
同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。