Manage Printers

Who this is for

Manager or authorized staff managing printer setup and maintenance in Devices -> Printer.

Before you start

• You are signed in with device-setting permission
• Target printer is powered on and connected to the same network
• POS Code is set
• If the printer was created in HQ, confirm the HQ printer name before editing the POS connection details

Quick flow

1. Open Devices.
2. Open Printer tab.
3. Check any row badge such as HQ, Not configured, or failed-job count.
4. Select the printer row (or tap Add Printer).
5. Run the required action (Info, Test Print, edit, remove, or spooler).
6. Verify status before returning to operations.

Tasks

Add Printer

1. Tap Add Printer.
2. Fill Name, Printer Type, Connection, IP Address, and Port.
3. Tap Save.
4. Tap Test Print.

What to verify:

• Printer appears in list
• Status is connected/ready
• Test print success message appears
• If this is an HQ-managed printer, the row still shows HQ after the local connection details are saved

HQ-managed Printer

1. Open the Printer tab.
2. Find the printer row with the HQ badge.
3. If the row also shows Not configured, tap edit.
4. Fill the local connection details such as Printer Type, Connection, IP Address, and Port.
5. Tap Save.
6. Tap Test Print.

What to verify:

• The HQ badge remains on the printer row
• The Not configured label clears after the local setup is saved
• Test Print succeeds before you return to service

Printer Info and Status

1. Tap Info on target printer row.
2. Review Connection Details and Status Details.
3. Tap Close.

What to verify:

• Type, Address, Status, and Last checked are correct

Test Print

1. Tap Test Print on target printer row.
2. Wait for result message.
3. Confirm physical test slip output.

What to verify:

• Success message: Test print sent to '<PrinterName>' successfully

Edit or Remove Printer

1. Tap edit icon to update Name, Printer Type, Connection, IP Address, and Port.
2. Turn Show advanced settings on when you need output adjustments.
3. Set Print Scale (%), Header extra line feed, or Footer extra line feed only when the test output needs adjustment.
4. If Printer Type is Dot Matrix, set Dot matrix density and Dot matrix color.
5. Tap Save.
6. To remove, tap delete icon.
7. Confirm removal prompt.

What to verify:

• Updated settings are shown in printer row
• For Dot Matrix, High density prints clearer but slower, and Normal density prints faster with less detail
• Color (red / black) sends red content to the red ribbon; Black only prints all content in black
• Removed printer disappears from list

Screenshot pending: functions/fn-printer-remove-confirm-dialog.png Screenshot pending: functions/fn-printer-dot-matrix-advanced-settings.png

Manage Printer Spooler

1. Tap Manage Spooler on target printer row.
2. Review tabs: Printing, History, Error.
3. Select the row info button when you need to inspect a job. The details can show Status, Retry source, Attempts, Auto reprint, Next retry, and the last recorded Error.
4. Use required actions:
   • Refresh
   • Clear Selection
   • Remove Selected
   • Remove All
5. In Error tab, use retry actions:
   • Select All
   • Retry Selected
   • Retry All

What to verify:

• Queue decreases after retry/remove actions
• Jobs marked Waiting for auto retry may clear by themselves after the printer is ready again
• Jobs marked Permanent error need manual review, removal, or a fresh print request
• New print jobs are processed normally
• The failed-job badge on the printer row clears after the error queue is empty

Screenshot pending: functions/fn-printer-spooler-manager-dialog.png Screenshot pending: functions/fn-printer-spooler-error-retry-actions.png

If something goes wrong

Test print fails

Check IP/port, paper, printer cover, and network, then retry once.

Status remains disconnected

Verify power/network on printer first, then run Test Print.

Spooler retries do not clear error jobs

Open the spooler job details. If the job is waiting for automatic retry, confirm the printer is online and wait for the next retry. If the job is a permanent error or repeated retries fail, remove the failed job, validate connectivity, then resend the order or print request.

Not configured on an HQ-managed printer

Edit the printer row and save the local connection details for this POS. The HQ record defines that the printer should exist, but each terminal still needs a working local connection before it can print.

Failed to remove printer

If removal partially fails, refresh printer list and confirm whether spooler files still exist.

When to ask manager/admin

• POS Code is required but you cannot edit settings
• Printer settings save succeeds but printer remains unavailable
• Spooler error queue keeps growing after retry/remove