MPH WMSPrinter Client
Printing
Configure print defaults and print documents from MPH WMS
Once the Printer Client is connected, you can print shipping labels, pick lists, and other documents directly from the web app.
Setting up print defaults
Each user can configure which printer to use for each type of document.
- Go to Settings → Printers in the web app
- Scroll to Printer Defaults
- Select a user from the dropdown
- Click Add Default
- Configure:
- Printer Client - which workstation
- Printer - which physical printer on that workstation
- Print type - what kind of document
- Paper size - the paper/label size
- Duplex - single or double-sided printing
- Click Save
Print types
| Type | Description | Typical printer |
|---|---|---|
| Label | Shipping labels (carrier labels) | Thermal label printer |
| A4 | Pick lists, packing slips, invoices | Standard office printer |
| Other | Any other document type | Varies |
Paper sizes
| Size | Dimensions | Use case |
|---|---|---|
| Auto | Printer default | General purpose |
| A4 | 210 × 297 mm | Documents |
| A5 | 148 × 210 mm | Half-page documents |
| Label 100×150 | 100 × 150 mm | Standard shipping labels |
| Label 100×200 | 100 × 200 mm | Large shipping labels |
| Custom | User-defined (mm) | Non-standard sizes |
Duplex options
| Option | Description |
|---|---|
| One-sided | Print on one side only (default) |
| Two-sided, long edge | Flip on the long edge (portrait binding) |
| Two-sided, short edge | Flip on the short edge (landscape binding) |
Printing a document
When you click Print anywhere in MPH WMS (e.g., on a shipment label):
- The system looks up your default printer for that print type
- A print job is created with the document attached
- The Printer Client receives the job within seconds via SSE
- The document is printed on the configured printer
- The job status updates to Completed (or Failed with an error message)
Print job delivery
The Printer Client uses Server-Sent Events (SSE) to receive jobs:
- The client polls the server every 3 seconds for new jobs
- Up to 10 jobs are delivered per poll
- Documents are delivered as base64-encoded data or as a URL that the client fetches
- After printing, the client sends an acknowledgment back to the server
Print job lifecycle
| Status | Description |
|---|---|
| Pending | Job created, waiting for the Printer Client to pick it up |
| Sent | Job delivered to the Printer Client |
| Completed | Successfully printed |
| Failed | Printing failed (error message stored) |
| Expired | Job was pending for more than 2 hours without being picked up |
Jobs in a terminal state (completed, failed, expired) are automatically cleaned up after 24 hours.
Monitoring
In the Printer Client
The Logs tab shows real-time activity:
- Successful prints in green
- Errors in red
- Connection events in the default color
- The last 200 log entries are kept
In the web app
Go to Settings → Printers to see:
- Client status (online/offline) and last seen time
- Client version number
- Connected printers per client