ERP/WMS pushes jobs
Server queue sends printHtml-compatible JSON; client listens and prints.
WMS remote shipping label silent print
WMS/OMS pushes label HTML/URLs to warehouse PCs via WebSocket/HTTP; the local client runs printHtml without browser dialogs. See remote print setup.
WMS remote print architecture
Typical stack: WMS/OMS builds label HTML → pushes via WebSocket/HTTP to warehouse PCs → local Web Print Expert client runs printHtml. No client on the server—each workstation installs and configures the remote URL.
Typical scenarios
100×150mm etc.
Set pdfOptions size; see batch labels demo.
Named thermal printers
printOptions.printerName per workstation; same API on Win/Mac/Linux.
Integration steps
- Install client; configure remote print URL
- Push npm-format JSON from WMS
- Zero margins; match paper width
- Peak load: batchPrint or queue
- Errors: error handling
Label print sketch
await webPrintPdf.printHtml(
receiptHtml,
{ width: '80mm', height: '120mm', printBackground: true },
{ printerName: '热敏打印机', copies: 1 }
);Checklist
- Remote: WebSocket or HTTP polling
- Paper: pdfOptions match printer
- Silent: requires local client
- Compare: Lodop comparison
Push vs pull
| Mode | Best for | Notes |
|---|---|---|
| WebSocket push | Peak batch, low latency | Client listens on a long connection |
| HTTP polling | WebSocket blocked | Pull pending jobs on an interval |
| Front-end printHtml | Clerk clicks Print | Still dialog-free, not unattended |
Troubleshooting checklist
- Remote URL matches WMS push endpoint
- Label HTML margins zeroed (avoid blank pages)
printOptions.printerNamematches workstation thermal driver- Peak load:
batchPrintor queue throttling - Failures: error handling & retries
How this page fits with related guides
- This page: WMS push + warehouse PC output
- Remote print setup: client URL & channels
- Receipts & labels: 80mm / 100×150 HTML layouts
- Print.js comparison: why browsers cannot run unattended
FAQ
Client on WMS server?
No—only on warehouse print PCs; server pushes jobs.
Unattended?
Yes—client auto-prints on remote messages without dialogs.
vs window.print?
See <a href="../window-print-alternative/">window.print alternative</a>.
Domestic OS warehouses?
Yes—<a href="../kylin-print/">Kylin</a> / <a href="../uos-print/">UOS</a> deb clients.
Multi-warehouse printer binding?
Each workstation sets a different printerName; WMS jobs may include station IDs. See print options.
Client deployment by platform
The same web-print-pdf front-end runs on Windows, macOS, and Linux/domestic OS—install the matching client on each desktop.