Eguasoft Point of Sale: Complete Setup and Quickstart Guide

Troubleshooting Common Issues in Eguasoft Point of Sale

Eguasoft Point of Sale (POS) is a powerful retail solution, but like any software it can encounter common issues that disrupt day-to-day operations. This article walks through frequent problems, how to diagnose them quickly, and step-by-step fixes to get your system back to full function.

1. POS won’t start or crashes on launch

• Symptoms: Application fails to open, freezes during startup, or closes unexpectedly.
• Causes: Corrupted installation, missing dependencies, insufficient system resources, or recent updates.
• Fixes:
  1. Restart the workstation.
  2. Check system requirements and free up RAM/CPU by closing other apps.
  3. Run as administrator (Windows) or with appropriate privileges.
  4. Repair or reinstall Eguasoft POS: back up configuration, uninstall, then reinstall the latest stable build.
  5. Check logs in the POS installation folder for error messages and search the message text in support docs.

2. Unable to process payments or card reader not detected

• Symptoms: Card transactions fail, card reader not recognized, or slow payment responses.
• Causes: Hardware connection issues, driver problems, network connectivity or payment gateway downtime.
• Fixes:
  1. Verify physical connections (USB, serial, Bluetooth). Replug and test on another port.
  2. Restart the card reader and POS terminal.
  3. Ensure drivers/firmware are up to date — install vendor drivers for the reader.
  4. Confirm network access and test gateway connectivity (ping gateway or run test transaction).
  5. Switch to a fallback payment method (manual entry or alternate terminal) while investigating.
  6. Contact payment processor to check for outages or account restrictions.

3. Slow performance during peak hours

• Symptoms: Lag when ringing up sales, slow inventory lookups, delayed receipts.
• Causes: High concurrent load, database contention, insufficient hardware, or network bottlenecks.
• Fixes:
  1. Identify bottleneck: check CPU, memory, disk I/O, and network usage on the server and terminals.
  2. Optimize database: run maintenance (index rebuilds, cleanup), archive old transactions.
  3. Increase resources (RAM/CPU/SSD) on POS server or upgrade terminals.
  4. Use local caching where available to reduce repeated database queries.
  5. Stagger non-critical tasks (backups, reports) to off-peak hours.

4. Inventory mismatches or missing items

• Symptoms: Stock counts differ between system and physical inventory; items missing or duplicated.
• Causes: Manual data-entry errors, failed syncs between devices, incorrect product mapping, or barcode scanning issues.
• Fixes:
  1. Run a quick audit on high-turnover SKUs to identify discrepancies.
  2. Check recent sync logs and ensure all devices have completed synchronization.
  3. Validate barcode mappings and product SKUs for duplicates or typos.
  4. Re-import or correct product data from a verified CSV backup if available.
  5. Train staff on correct scanning and lookup procedures to reduce future errors.

5. Printing issues (receipts, reports, labels)

• Symptoms: Receipts not printing, wrong format, or printers showing offline.
• Causes: Printer drivers, incorrect configuration, network printer connectivity, or paper/roll problems.
• Fixes:
  1. Confirm printer power, paper, and connections.
  2. Set correct printer as default in POS settings and OS printer panel.
  3. Update or reinstall printer drivers.
  4. Test print from OS to isolate POS vs. printer problem.
  5. Check printer settings for correct page size, encoding, and template mappings in Eguaso