Skip to content
FMX EPOS
Download
Help Centre home

Printers and cash drawer troubleshooting

Start with the Printing card in Back Office → Diagnostics, then open Back Office → Printing → Print Queue. Check the printer itself and its Windows queue before you retry anything. Staff on the till deal with their own jobs from the printer banner. The Back Office pages need an administrator.

When a job for one of this terminal’s printers, or a job this terminal sent, needs someone to deal with it, the till shows a banner such as “Printer Kitchen 1: 2 jobs need attention” with Open Print Jobs. The banner appears for a failed job, a job whose result is unknown, a job with no printer, and a job still waiting after a minute.

  1. Select the banner to open this terminal’s Print Jobs.
  2. Read the status, the error and the advice on each job.
  3. Choose what to do:
    • Retry prints the job again on the same printer. A job that never printed is sent straight away.
    • Retry All appears when several jobs failed on the same printer and sends them all again, oldest first.
    • Send Elsewhere prints it on another printer of the same type. When a printer holds several jobs, Send All Elsewhere and Clear All deal with them together.
    • Clear Issue cancels the job without printing. It does not tell the kitchen, cancel the order or remove a copy already in a Windows print queue.
  4. If the job might already have printed, check the printer first, then confirm with Checked, Print. To clear it, confirm with Confirm Clear Issue. For several jobs, Send All Elsewhere offers Checked, Print All or Unprinted Only, and Clear All asks for Confirm Clear All.

The actions for all of a printer’s jobs cover only the jobs that belong to this window, including any that do not fit in the list. In the till’s Print Jobs that means this terminal’s jobs; in a table’s Print Jobs, the table’s jobs. Another till’s jobs on the same printer are left for that till, or for Back Office → Printing → Print Queue, where Retry All, Send All Elsewhere and Cancel All cover every terminal.

Illustration, not a screenshot. The real screen can differ with the theme or version.

A table also has its own Print Jobs button, which lists that table’s jobs and its Kitchen Ticket Copies. Print Copy prints a kitchen ticket again after it has already printed. The copy says COPY only if the ticket’s template contains the Copy Marker element. The built-in kitchen ticket templates have it, so keep it in any kitchen template you design yourself.

  1. Check that the printer is switched on and online, has paper and shows no cover or cutter error.
  2. For a Windows printer, print a test page from Windows first. For a TCP/IP ESC/POS printer, check its IP address and port.
  3. Open Back Office → Local Settings → Printers. If the printer is missing from the list, select Refresh Printers. Choose it under Local Printers and select Test Print. “Test receipt sent to printer.” means FMX EPOS sent it; “Test print failed.” gives the reason.
  4. Open Back Office → Printing → Terminal Printers and check the printer’s type. New printers start as Not Used. Select Refresh there if a printer installed later is not listed.
  5. For receipts, check Print Receipts On in Local Settings → Printers on this terminal. If no receipt printer is chosen, the payment still completes, but the till says “Receipt failed: Select a registered receipt printer in Local Settings → Printers. The job waits in the print queue for a redirect.” Choose the printer and select Save Printer Settings. Then send the waiting receipt with Send Elsewhere, in Back Office → Printing → Print Queue or in the till’s Print Jobs. Retry is not available for that job, because it has no printer.
  6. Open Printing → Print Rules. Each order type has its own Kitchen Ticket, Labels and Receipt ticks, and Receipt After Payment can be Print Automatically, Do Not Print or Ask After Each Payment. X and Z reports print by themselves only when Print X/Z Reports Automatically is ticked in this terminal’s Local Settings → Printers.
  7. For kitchen tickets, check the product’s Kitchen Stations and that station’s Printers. A product with no active station uses the default station.
  8. For labels, check that the product has Print a Label for This Product ticked, then check the station’s or this terminal’s label printer, depending on which action printed it.

Online platform orders do not use Print Rules. They follow the printing settings on their connection in Back Office → Online Platforms.

Illustration, not a screenshot. The real screen can differ with the theme or version.

A test print in Local Settings only proves that FMX EPOS can send that test to the selected printer. It does not prove that every template, route, paper size or cutter setting is right. To check a layout, use Test Print in Print Design.

A job can show as printed in FMX EPOS even though nothing came out:

  • A Windows printer whose driver does not report problems back to Windows looks fine to FMX EPOS. Check the Windows print queue as well.
  • A network (TCP/IP) ESC/POS printer counts as printed as soon as it accepts the data. FMX EPOS cannot see that it is out of paper or that its cover is open, so a job sent at that moment shows as printed. Look at the printer itself. To print the missing paper again, use Print Copy in a table’s Print Jobs, or Print Kitchen Ticket or Reprint Receipt on the order in the till’s Orders.

A job stays Pending and is tried again by itself, ahead of that printer’s later jobs, when the printer cannot be reached or reports a problem: for example a Windows printer that is offline or out of paper, or a network printer that is switched off. Keep the terminal that prints it running and fix the printer. The job then prints by itself.

If the job has not printed 30 minutes after it was queued, or after someone last retried it, FMX EPOS stops trying and marks it Failed with “Not printed: waited more than 30 minutes.”. Work that late has probably been redone by hand, so FMX EPOS does not print it automatically. Only the terminal that prints the job marks it, so while that terminal is switched off the job stays Pending. It turns Failed when the terminal starts again.

The print result is unknown: the job may already have printed, so FMX EPOS does not retry it automatically. That printer’s later jobs wait behind it until someone deals with it.

  1. Check the printer’s output tray and the kitchen pass.
  2. Check the Windows print queue or the printer’s history.
  3. In Back Office → Printing → Print Queue, select View Content to see which order and document it is.
  4. If a second copy is acceptable, select Retry and confirm Checked, Retry.
  5. To use another compatible printer, select Send Elsewhere, choose the Destination Printer and confirm Checked, Print.
  6. If no new copy should be printed, select Cancel and confirm Cancel Job.

On the till, the same job is in Print Jobs: use Retry or Send Elsewhere and confirm Checked, Print, or Clear Issue and Confirm Clear Issue.

Retry and Send Elsewhere start a new set of attempts and can produce a duplicate.

Illustration, not a screenshot. The real screen can differ with the theme or version.

A Failed job did not print, and FMX EPOS has stopped trying. The message under the status gives the reason:

  • “Not printed: waited more than 30 minutes.” followed by the last printer error: the job could not be printed in time, for example because the printer stayed offline.
  • “Not printed:” followed by the reason Windows gave and the printer name in brackets, for example “Not printed: the printer is offline (Receipt 1).”. The reasons are “the Windows print queue is paused”, “the printer is set to Use Printer Offline in Windows”, “the printer is offline”, “the printer is not available”, “the printer is out of paper”, “the printer has a paper jam”, “the printer has a paper problem”, “the printer cover is open” and “the printer reports an error”. If this is still the last error after 30 minutes, the job fails with it.
  • Some jobs fail straight away, because another attempt would fail in the same way:
    • “Text-Only Compatibility cannot print a character in this job. Turn it off in Local Settings → Printers or use a Windows printer driver.”
    • “… is not a label printer. Set its type in Printing → Terminal Printers or change the station’s printers in Printing → Kitchen Stations.”
    • “Select a registered receipt printer in Local Settings → Printers.” (a receipt or card slip with no receipt printer set) or “Select a label printer in Local Settings → Printers.” Choose the printer in Local Settings → Printers, then send the waiting job with Send Elsewhere. It has no printer, so Retry is not available.
    • “The document is longer than the Windows driver’s paper size. Select a longer paper size or use ESC/POS printing.”
    • “No active default kitchen station is configured. Add one in Printing → Kitchen Stations.”

Fix the cause first. In Windows, open the printer’s queue and clear Pause Printing and Use Printer Offline, then load paper or close the cover. Then select Retry (or Retry All), Send Elsewhere to send the job to another printer, or Cancel if no copy is needed. A retry or redirect to a printer of the wrong type is refused, for example “… is not a receipt printer. Choose a printer of that type.”

Illustration, not a screenshot. The real screen can differ with the theme or version.

  • Receipts, card slips, pre-bills and X and Z reports go to this terminal’s receipt printer.
  • Automatic kitchen tickets go to the receipt-type printers registered for the product’s kitchen station.
  • Automatic labels go to the station’s label printer.
  • Labels printed by hand go to this terminal’s Print Labels On printer, but use the template of the line’s station. Labels on a kitchen screen card is the exception: it prints on the card’s own station’s label printer.
  • Station slips for platform cancellations follow station routing. An extra front-of-house copy can print on the Integration Host’s receipt printer.

Correct the routing, then retry or redirect only the affected jobs in the queue.

For a directly connected ESC/POS printer, check Print Width (Dots) and Resolution. With Text-Only Compatibility ticked, the printer cannot print graphics or logos, and it prints only the characters in its own character set:

  • Item names, notes, customer names and addresses, the reasons and references on refund and card slips, and area, table, seat, course and preparation group names print as typed where the character set has the letter, including common accented letters such as é, ü and ñ. Other letters print without their accent, and emoji and other scripts are left out.
  • All other text must use characters the printer has: the shop details, text added in Print Design, staff and till names, and amounts. A single character it cannot print there makes the job fail. For example, an X or Z report fails if the cashier’s name contains ł.
  • Allergens are never left out. If the printer cannot print an allergen in full, the ticket fails and says so. Turn Text-Only Compatibility off, use a Windows printer driver, or select Send Elsewhere.

Turn Text-Only Compatibility off only if the printer supports graphics mode.

In Print Design, check the paper width, margins, block sizes and which template is selected for the terminal or station. Saving a template does not assign it anywhere.

  1. Check that the printer’s type is Label under Terminal Printers. An ESC/POS printer cannot be a label printer; use its Windows driver.
  2. Open Printing → Kitchen Stations, edit the station and check Label Printer, Label Template, Label Copies and Print Labels Automatically.
  3. Check that the product’s Print a Label for This Product is ticked, and that the order type’s Labels rule is on in Printing → Print Rules. For platform orders, check Automatically Print Labels on the connection in Online Platforms instead.
  4. For labels printed by hand, check this terminal’s Print Labels On setting. If the till says “No products in this order are configured to print labels.”, no product on the order has a label set.
  5. Look in the Print Queue: each label has its own row, so check for failed rows.

Illustration, not a screenshot. The real screen can differ with the theme or version.

  1. Check that the drawer is cabled to the printer chosen under Cash Drawer → Connected Printer in Local Settings → Printers. Only this terminal’s Receipt printers are offered.
  2. Check that Connector Pin matches the cable, then check the Pulse length.
  3. Select Test Drawer. It uses the printer, pin and pulse shown, even before they are saved. “Drawer pulse sent. Check the cash drawer.” means FMX EPOS sent the pulse.
  4. If the test works, select Save Printer Settings so payments use the same pin and pulse. If the drawer still does not open after a cash payment, check that Open After Cash Payment is ticked and save again. The same tick also opens the drawer for cash refunds, Paid In, Paid Out and membership cash. The till’s Open Drawer button ignores it.
  5. If the test fails, check the printer driver, the drawer cable and the hardware before you change any more software settings.

Illustration, not a screenshot. The real screen can differ with the theme or version.

The drawer is opened through the printer, so a receipt that prints correctly does not prove that the drawer pin and cable are right. If the drawer fails to open when you add cash on the payment screen, the till says “Cash payment added, but the cash drawer could not be opened: …”. The cash entry is already on the payment screen, so do not add it again. Use Open Drawer if you need the drawer open, then finish with Confirm Payment as usual. The till’s Open Drawer button appears only when a Connected Printer is set, and needs the No Sale (Open Drawer) permission.