物流 WMS 远程面单打印案例(匿名摘要)

某区域物流企业在大促波次面临 20+ 打单工位同时出面单的压力。原 window.print 需人工确认、易错选热敏机。本文以匿名化摘要说明 WMS 服务端推送 + 工位客户端静默打印的架构、里程碑、量化效果,供仓储信息化与采购评估。

决策方关注点

角色关切方案要点
仓储运营大促不出单、错打、漏打推送即打、printerName 工位绑定
WMS 技术服务端改造量消息 JSON 格式固定,开发接收/存储/暴露接口程序即可
采购每工位成本、是否替代云打印 SaaS本地客户端授权;数据不出仓
运维断网、队列堆积、监控客户端队列 + formatPrintError 对接告警

项目背景

OMS 下发运单后,仓库需打印 100×150mm 面单约 2~4 万张/日(大促峰值)。20+ Windows 工位原用浏览器打印,高峰平均每人多点击 3~4 次确认,错选打印机导致返工;运营要求无人值守推送出纸,与 WMS 任务状态回传打通。

核心挑战

  • 波次批量面单,单工位 QPS 峰值约 8~12 张/分钟
  • 每工位 USB 热敏机不同,必须指定打印机且不能弹窗
  • WMS 已有 WebSocket 基础设施,按固定消息格式开发接收/存储/暴露接口即可
  • 大促前仅 6 周窗口,不能重构整个 WMS 打印模块

系统架构

WMS/OMS 按固定消息格式入队 → 自建服务接收/存储并暴露消费接口 → 工位客户端配置该 URL → 本地出纸。补打:仓管可在管理页用 npm 本地打印(远程链路本身不调 API)。

解决方案

  1. 熟悉固定消息格式,在 WMS 服务端开发任务接收、存储与 WebSocket/HTTP 暴露程序
  2. 工位 PC 安装客户端,于「远程打印配置」填入该接口 URL
  3. 面单 HTML 模板 margin/padding 归零,纸宽 100mm 与物理机一致
  4. 高峰在服务端合并或节流任务批次
  5. 对接 formatPrintError 至监控大盘;WebSocket 断线见排障专题

技术栈与部署

实施里程碑

周次工作
W11 工位 PoC:推送 1 单即打
W25 工位压测 + 打印机绑定
W3~4全量 20 工位 + HTML 模板定稿
W5~6大促演练 + 断网/重连预案

量化效果(试点期)

指标改造前大促试点后
单张面单人工操作打印→确认→选机(约 8 秒)全自动(推送触发)
错打率(抽检)约 1.2%降至约 0.15%
高峰工位等待浏览器对话框排队明显客户端队列平滑
WMS 改造人日—约 8~12 人日(推送格式对齐)

匿名化试点数据,实际因仓型与模板而异。

实施效果

打单工位取消浏览器确认;高峰推送队列稳定出纸;消息格式固定,服务端只需开发接收/存储/暴露接口程序。采购对比云打印 SaaS 后选择本地客户端方案,满足面单数据不出园区的要求。

采购与立项评估

  • 按打单工位 PC 数采购客户端授权,非按打印张数
  • 确认 WMS 能否输出 HTML 或 URL(URL 场景见 鉴权打印)
  • 评估 WebSocket 长连接 vs HTTP 轮询(内网策略)
  • 验收:连续 1 小时压测无人工点击、错打率低于约定阈值
  • 备选:保留浏览器打印开关作应急回滚

风险与回滚

  • 推送风暴导致客户端队列堆积 → 服务端节流 + batchPrint 批次上限
  • 模板边距错误整批废单 → 上线前 preview 抽检 + 批量样例对照
  • 断网 → 客户端本地队列与 WMS 重试策略联合设计

延伸阅读

常见问题

必须改 WMS 服务端吗?

需能按固定消息格式接收/存储任务,并暴露 WebSocket 或 HTTP 接口供客户端拉取。

每个工位都要客户端?

是—每 PC 一台客户端绑定本地热敏机。

Mac 仓可以吗?

可以,dmg 客户端 API 相同。

和 Puppeteer 服务端 PDF 比?

Puppeteer 适合归档;工位直打用本地客户端延迟更低。

断网怎么办?

客户端队列与重连策略需 WMS 侧配合;见 WebSocket 排障专题。

各平台客户端部署

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

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