Print Queue
The print queue shows all Print Service print jobs with their current status. From here you can retry failed jobs, cancel jobs, or filter for problems.
Opening the Page
- Via search: Print Jobs
- Via the Print Service Dashboard → Print Jobs
- Via the dashboard: Click Queued Jobs or Failed Jobs (pre-filtered)
Fields
| Field | Description |
|---|---|
| Entry No. | Sequential number of the print job (auto-assigned) |
| Status | Current status of the job (see status overview below) |
| Document Type | Type of document: Shipping Label, Report, or Raw Document (new in v3.0) |
| Printer Code | The printer the job is/was sent to |
| Print Method | Print method: PDF or ZPL |
| Tracking No. | Tracking number of the associated shipping label (only for Shipping Labels) |
| Provider Code | Shipping provider code (e.g., DHL, DPD, GLS). Only for Shipping Labels |
| Report ID | Object ID of the printed BC report (only for Document Type = Report) |
| Report Name | Name of the BC report (only for Document Type = Report) |
| Created At | Timestamp when the print job was created |
| Printed At | Timestamp of successful printing (empty when status ≠ Printed) |
| Retry Count | Number of retry attempts so far |
| Next Retry At | Scheduled time for the next retry attempt (only for status = Queued with retries) |
| Error Message | Last error message (only for status = Failed) |
| Shipment No. | Associated merchantCENTRAL shipment number (only for Shipping Labels) |
Status Overview
| Status | Symbol | Description |
|---|---|---|
| Queued | 🔵 | Waiting to be processed |
| Sending | 🟡 | Currently being sent to the ECIService |
| Printed | 🟢 | Successfully printed |
| Failed | 🔴 | Permanently failed (all retries exhausted) |
| Cancelled | ⚪ | Manually cancelled |
Actions
| Action | Description |
|---|---|
| Retry | Resets the selected failed job to "Queued" for another attempt |
| Retry All Failed | Resets all failed jobs to "Queued" |
| Cancel | Cancels the selected job (Status → Cancelled). Can only be performed on status Queued or Failed |
| Process Queue | Processes all pending jobs immediately |
Common Errors and Solutions
HTTP Connection Error
Cause: ECIService not reachable. Solution: Check if the ECIService is running and the URL in the printer configuration is correct.
Printer Not Found
Cause: The configured printer name does not exist on the ECIService host.
Solution: Check the printer name via the ECIService /printers endpoint or open Windows printer settings on the service host.
ZPL Connection Refused
Cause: The Zebra printer is not reachable via TCP/IP (port 9100). Solution: Check network connectivity, IP address, and port of the printer. Ensure the raw TCP port (9100) is enabled on the printer.
Notes
Automatic Cleanup
Completed and cancelled jobs are automatically deleted after the retention period configured in the setup card. Default: 30 days.
Retry Limit
After reaching the maximum retry count (configured in Setup), a job is marked as "Failed". A manual retry via the action is still possible thereafter.