| Invalid Token | QSalesView, QClock, activation, password setup | The token cannot be used for the requested action. | Expired token, already used token, broken URL, wrong account, password setup not completed. | Request a new activation or password setup link; confirm user account and timestamp. | A fresh token fails for the same user and support has the exact link time and account details. |
| Login is taking too long. Check the connection and try again. | QSalesView, QBMWServices | QSalesView did not complete login quickly enough. | QBMWServices unreachable, Cloudflare target wrong, QBM Server stopped, SQL Server stopped, bad settings, product key or permission timeout. | Check QBM Client login, QBM Server, QBMWServices, port 8053, Cloudflare, settings, logs. | All services are healthy but login still times out with current logs. |
| Access denied | QBM Client, reports, QSalesView, POS | The user is not allowed to perform the action. | Security group missing screen/report permission, inactive user, restricted document, manager-only action. | Confirm user, security group, screen, report, and action. | Permission appears correct but the user is still blocked. |
| Password is case sensitive | QBM Client, web login | The typed password may not match the stored password exactly. | Caps Lock, wrong keyboard language, saved browser password, outdated password. | Retype manually and check Caps Lock; do not ask user to send password. | Known correct credentials fail for multiple users. |
| No connection could be established | QBM Client, QBM Server, QBMWServices | The application cannot reach a required service. | Service stopped, wrong server, wrong port, firewall, network, VPN, tunnel issue. | Check service status, port, server name, network, and firewall. | Network path is reachable but application still cannot connect. |
| Endpoint not found | QBMWServices, QSalesView, integrations | The requested API route is not available at the target URL. | Wrong Service Address, wrong BaseAddress, old version, proxy route mismatch, calling website host instead of API host. | Confirm the URL, controller route, deployed version, and browser network request. | The endpoint exists in code and deployment but still returns not found. |
| Client and server versions may not match | QBM Client, QBM Server | The desktop client and server service are not aligned. | Partial update, old workstation, old service files, rollback mismatch. | Check QBM Client and QBM Server versions; update both sides. | Versions match but compatibility warning continues. |
| SQL Server instance not found | QBM Client, QBM Server, database tools | The configured SQL instance cannot be located. | Wrong instance name, SQL service stopped, SQL Browser stopped for named instance, firewall, server rename. | Check SQL services, instance name, server name, and SQL Browser if required. | SQL tools can connect but QBM cannot. |
| Product key is invalid | QBMWServices, QSalesView, activation | The configured license value is missing, invalid, or not accepted. | Missing ProductKey, wrong environment, old config overwritten, key copied incorrectly. | Confirm ProductKey exists and was not replaced during update; do not expose it. | Valid masked configuration still fails after service restart. |
| Port is not listening | QBM Server, QBMWServices | Windows is not accepting connections on the expected port. | Service stopped, binding failed, URL reservation missing, firewall, port conflict. | Run service status and Get-NetTCPConnection for the port. | Service is running but the port never appears. |
| Cannot delete because record is in use | QBM Client, master data, transactions | QBM is protecting history linked to another record. | Record used by transaction, item, account, customer, vendor, report history. | Make inactive where available or correct related transaction safely. | The user must remove a record and the safe correction path is unclear. |
| Print preview not opening | Printing, reports, POS | QBM or Windows could not open the preview path. | Printer driver, template issue, missing viewer, permissions, report data issue. | Try another printer, PDF, Windows test print, and a default template. | Windows printing works and multiple templates fail in QBM. |
| PDF not generating | Printing, reports, email | QBM cannot create the PDF output. | Output folder permissions, PDF component, template, file locked, long path. | Change output folder, verify permissions, try another template. | All output locations and templates fail. |
| Email sending failed | Email, invoice, statement, reports | QBM could not send through the configured email method. | SMTP settings, password or app password, firewall, attachment path, mail server policy. | Check email settings, test SMTP, confirm attachment path and size. | SMTP test succeeds but QBM email still fails. |
| Import required field missing | Import, Excel, CSV | The import file does not contain a required column or value. | Wrong template, blank required column, renamed header, incorrect sheet. | Use the correct import template and fill required columns. | The file matches the template but import still rejects it. |
| Duplicate record | Master data, import, sales, inventory | QBM found an existing record with a unique value. | Duplicate name, code, SKU, barcode, account number, reference number. | Search existing records and decide whether to use, rename, merge, or correct. | The duplicate check appears wrong or blocks a permitted blank optional value. |