Common errors encountered when using POS software

Common Issues When Using the POS Software

Below are some common issues that may occur while using the POS system, along with how to check and resolve them.

Common Issues & Troubleshooting

1. Unable to open the POS application

Solution:

• Method 1: Check the domain and login credentials. Try logging in to the management page to verify that the domain and user account are correct.

• Method 2: Check the internet/network connection.

2. On the mobile app, the POS IP address cannot be found during login

Solution:

• Method 1: Make sure the mobile device and the POS are connected to the same network/subnet.

• Method 2: Check the POS IP address:

  • Open the POS application

  • Go to Command Prompt

  • Enter ipconfig

  • Copy the IP address and enter it into the CUKCUK Sales mobile app

• Method 3: Disable the Firewall on the POS:

  • Go to Windows

  • Open Firewall & Network Protection

  • Turn off the Firewall

3. Printer cannot connect or does not print

Solution:

• Method 1: Print a test page directly from the printer

• Method 2: Print a test page from the printer driver

• Method 3: Go to Settings → Printer & Template and select Print to test

4. Printed receipts are faint or unclear

Solution:

• Method 1: Print a test page from the printer or its driver

• Method 2: Print to PDF to check output quality

• Method 3: Try printing with a different printer

5. Receipt prints blank or misaligned

Solution:

• Method 1: Check whether the paper is loaded incorrectly

• Method 2: Print a test page from the printer driver

• Method 3: Print to PDF for verification

6. Receipt format is incorrect

Solution:

1. Open Windows

2. Go to Printers & Scanners

3. Select the printer and click Manage

4. Go to Printer Properties → Device Settings

5. Under Cutter, select Full Cut After Page

7. Unable to scan QR code

Solution:

• Method 1: Adjust the position so the QR code aligns properly with the scanner

• Method 2: Check the clarity and sharpness of the QR code

8. Unable to import the menu into the system

Solution:
Check the following:

• Ensure the file format is correct

• Do not unprotect the file

  • If the file was unprotected, download the original template from the system and re-import it

9. Mobile app shows old cached data or data sync fails

Solution:

• Method 1: Clear data in the botX Sales app on the tablet:

  • Go to Settings

  • Select Delete old data

• Method 2: Uninstall and reinstall the app