POS Hardware and Receipt Printer Troubleshooting Guide

Diagnose POS counters, receipt printers, barcode scanners, cash drawers, payment devices, templates, and batch issues.

Where to find it

Path: POS > Options > Printer / Hardware setup, or Help > Help Center > POS printer troubleshooting.

Use this path from the main QBM window. If the command is not visible, confirm that the user has access to the related module and permission for that screen.

Guide Summary

AudienceCashiers, store supervisors, support staff, implementation team, and AI agents.
Applies ToQBM POS, receipt printers, cash drawers, barcode scanners, POS counters, payment devices, receipt templates, batch closing.
PurposeIdentify whether a POS issue is caused by QBM settings, Windows driver, hardware, template, payment setup, or batch workflow.
Last Updated2026-05-18

Normal Flow

Cashier user
-> POS counter
-> Item barcode or selection
-> Payment method
-> Receipt template
-> Windows receipt printer and cash drawer
-> POS batch closing and reports

Expected result: Items scan, sale saves, payment records, receipt prints, cash drawer opens when configured, and batch closing balances.

Step-By-Step Checks

  1. Confirm the POS counter name and cashier user.
  2. Confirm the receipt printer is installed in Windows and can run a Windows test print.
  3. Confirm the receipt template and paper size.
  4. Test barcode scanner input in Notepad to confirm it behaves like keyboard input.
  5. Check payment method setup and whether the batch is open.
  6. Confirm whether the issue affects one counter or all counters.
  7. Check recent driver, Windows, printer, network, or QBM update changes.

Common Problems

SymptomLikely CauseFirst Check
Receipt does not printPrinter offline, wrong printer, driver, template, Windows queue.Run Windows test print and confirm QBM printer selection.
Cash drawer does not openDrawer connected to wrong printer, driver command, cable, template setting.Test drawer from printer utility if available.
Barcode not scanningScanner disconnected, wrong barcode, item missing, scanner mode.Scan into Notepad and search item/barcode in QBM.
Payment not acceptedPayment method setup, permission, integration, device issue.Try another allowed payment method and check device status.
Batch will not closeOpen transactions, imbalance, permission, missing payment details.Review batch report and cashier payments.

Troubleshooting Decision Tree

  1. Does Windows test print work? If no, fix printer driver or hardware first.
  2. Does QBM print to another printer? If yes, repair the receipt printer setup.
  3. Does scanner type into Notepad? If no, fix scanner hardware or mode.
  4. Does the issue affect all counters? If yes, check QBM POS settings and server connection.
  5. Does one cashier fail? If yes, check user permissions and batch assignment.
  6. If hardware works but QBM fails, collect POS logs, template, counter, batch, and exact error.

What To Send To Support

  • POS counter name and cashier user.
  • Receipt printer name and Windows test print result.
  • Barcode or SKU, payment method, and batch number.
  • Receipt template name.
  • Exact error message and screenshot.
  • Whether one counter or all counters are affected.

Security Notes

  • Do not send card details, customer payment details, or cashier passwords.
  • Mask customer phone numbers, card references, and sensitive receipt data.
  • Limit batch correction access to authorized supervisors.