All topics
Permalink

Health: troubleshooting

Is something not running smoothly on the POS? The built-in Health page checks your whole setup and fixes the most common problems on the spot. On the POS, open the cogwheel and choose Health.

Automatic checks#

The page runs the checks as soon as you open it, and you can run them again with Run all checks. For each part, you can see whether everything is fine:

  • Templates: are the receipt templates configured?

  • Network: is there a connection?

  • FDM: is the fiscal module reachable (with a GKS)?

  • Receipt sync: are there still receipts in the queue that failed to sync?

At the bottom, you can always see when the checks last ran.

Does Receipt sync report receipts that failed to sync, or are sales missing from the management page? Then read Receipts not visible in the cloud.

Testing and finding printers#

The Printers section lists every configured printer with its own Test print button. Printers with a cash drawer also get an Open drawer button. This way, you know within seconds which printer is letting you down.

Can't find a printer, for example because its IP address changed? Use Scan network for printers or Discover Epson printers: enter the first three octets of your subnet (for example 192.168.1) and the POS finds the printers with their MAC address. You can update the changed IP address straight from the scan.

Checking the payment terminal#

If you work with a linked CCV terminal, Check terminal tests the connection:

  • Reachable and in service: everything is fine.

  • Reachable but not done: close the menu on the terminal itself.

  • Unreachable or no IP set: check the IP address in the payment method settings.

Testing the barcode scanner#

If the POS doesn't scan a customer card, a loyalty code or a product, the scanner test points straight to the cause. On the POS, open the cogwheel, choose Health and then Scanner. The page shows a test code as a barcode and as a QR code. Scan either one. The POS compares what your scanner sends with the expected value on the screen and tells you exactly what goes wrong.

The scanner test in Health: scan the barcode or the QR code and the POS compares the result with the expected value.
The scanner test in Health: scan the barcode or the QR code and the POS compares the result with the expected value.

Possible results:

  • Scan matches: your scanner works as it should.

  • No Enter received: set your scanner to send an Enter (carriage return) after every scan. Without Enter, the code does appear on the screen, but it is never confirmed.

  • Extra character at the start or end: your scanner sends an extra character along, often a Tab, a tilde or a function key. Turn that prefix or suffix off in the scanner's configuration.

  • Same letters, wrong capitals: Caps Lock is on, or the device's keyboard layout doesn't match what the scanner sends. Turn Caps Lock off and test again.

  • Truncated scan: the scanner sends faster than the device can process, usually a Bluetooth timing problem or a window that takes the focus away in between.

  • No input: the scanner is not paired (Bluetooth) or another input field had the focus and swallowed the scan.

With Generate new code, you request a new test code. The page listens for keystrokes everywhere, so you don't need to select a field. If nothing comes in, another window has the focus or the scanner is not paired.

Recovery actions#

  • Force full re-sync: fetch all data again when the POS no longer seems to be in sync with the management page.

  • Database maintenance: the POS maintains its local database to keep everything fast.

Tip

For any printer or terminal problem, Health is your first stop: the checks point you straight to the right cause, with no guesswork.

Checking the back office and webshops#

Every POS is linked to one back office, and one or more webshops can be linked to that back office. You see which ones on the POS under Linked. Handy after a reinstall or when you put a second POS into service: this is how you check that the device is linked to the right business.

  1. Tap the gear at the top right.

  2. Choose Health under Support.

  3. Scroll to Linked.

The linked back office and webshop on the Health page
The linked back office and webshop on the Health page

Under Back office is the name of your business, with the short code and the address of your back office below it. Every webshop linked to the POS gets its own row with the same details and the status Enabled or Disabled. If no webshop is linked to the POS, it says No webshop linked to this POS.

Good to know

The addresses are shown as text. You cannot tap them on the POS. Open the back office on your computer and type the address there.

Warning

Is there a red message under Back office saying this device is set up for another business? Then the serial number you activated the POS with does not belong to this business. Check the serial number and activate the POS again with the right one, see Activating your POS. If that does not work, contact us.

Frequently asked questions

It says no webshop is linked to this POS, but we do have one.

The POS shows what the back office reports. Check in the back office that your webshop is linked to this business. If the message stays, contact us.

Didn't find what you were looking for?

Our support team is happy to help.

Contact us