Documentation Menu

Help & Snap Solutions

Troubleshooting

Identify and resolve common system errors.

Interface Overview

Status Dashboard


Common Issues

1. "Cannot Delete Account"

Error: When trying to delete a Chart of Accounts entry, you see "This account has transaction history". Solution:

  • For accounting integrity, accounts with history cannot be deleted.
  • Fix: Open the account, uncheck "Active", and save. This hides it from new transactions.

2. "Negative Inventory Not Allowed"

Error: When posting an Invoice, you see "Insufficient Stock". Solution:

  • Your system is configured to prevent selling items you don't have.
  • Fix 1: Record a Purchase Bill or Stock Adjustment to increase your count.
  • Fix 2: If you know you have physical stock, enable "Negative Sell" on the Item Profile.

3. "Permission Denied"

Error: A user cannot see a specific menu or button. Solution:

  1. Go to Accountant > Roles.
  2. Select the user's role and check if the specific module (e.g., "Void Bills") is checked.
  3. User must logout and log back in for changes to apply.

4. "Browser shows old data"

Error: Different users see different UI elements or old cached content. Solution:

  • We have implemented automated asset versioning. However, if the issue persists:
  • Fix: Perform a "Hard Refresh" (Ctrl + F5 on Windows, Cmd + Shift + R on Mac).

5. "Cannot permanently delete this item because it is linked to transaction(s)"

Error: Toast notification displays: "Cannot permanently delete this item because it is linked to X transaction(s). Use soft-delete (archive) instead." Cause: To maintain double-entry accounting integrity, items linked to sales, bills, stock transfers, or stock adjustments cannot be deleted from the database table directly.

Solutions:

  • Fix 1 (Recommended): Use Soft-Delete (Archive). In the delete dialog, select Soft-Delete (Archive). The item is hidden from the catalog, POS, and sales/purchase dropdowns, and its original name, SKU, and barcode are immediately released for reuse.
  • Fix 2: Remove the Linked Transaction(s). Open the item details page → History or Transactions tab to identify the linked record (e.g. an Adjustment or Receipt). Navigate to that module, void/delete that transaction, then return to Items and choose Permanent Deletion.

[!CAUTION] Database Errors: If you see any "SQL" or "Database Connection" errors, please contact your system administrator immediately as this may indicate a server issue.


Privacy Center.

We use cookies to enhance your experience and analyze traffic. By clicking "Accept All", you consent to our use of cookies. Read Policy

Cookie Preferences

Necessary

Essential for the website to function properly.

Analytics

Help us understand how visitors interact with the website.

Marketing

Used to display ads that are relevant and engaging.

Live Chat

Chat on WhatsApp

Reach the QoTrack team for sales questions, onboarding help, or a quick product walkthrough.

Preferred Contact

+233542795439

Mon-Fri, 8am - 6pm

Start WhatsApp Chat
Try it out Live Demo