Troubleshooting guide
Diagnostic procedures for credit limit override blocks, POS offline synchronization, Telebirr payment timeouts, and VAT rounding variances.
1. Overview & Business Value#
This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Troubleshooting guide within SmartERP.


This guide provides troubleshooting solutions for common commercial operational issues.
2. Prerequisites & Security Access Groups#
- Required Modules:
sale_management, crm, point_of_sale, smarterp_payment_telebirr - Security Groups:
Sales User(Technical ID:sales_team.group_sale_salesman)Sales Administrator(Technical ID:sales_team.group_sale_manager)POS User / Cashier(Technical ID:point_of_sale.group_pos_user)
- Master Data Dependencies: Customer partner registry, selling pricelists, product inventory balances, payment providers (Telebirr/CBE Birr), and POS terminal sessions.
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- Navigate to Operations.

Step 2: Operational Data Parameters & Controls#
Ensure all mandatory parameters comply with enterprise operational standards:
- Authorized Operator: Action executed under assigned RBAC permissions (Authorized Operator).
- Relational Integrity: Linked to upstream customer, product, inventory lot, or manufacturing order.
- Statutory & Quality Controls: Verified against Ethiopian commercial and tax regulations or technical engineering specifications.
Step 3: Operational Execution & State Progression#
- State Progression Gate: Advance record from Draft through Confirmed to Completed / Posted.
- Integrated System Impact: Automatically updates inventory stock quants, customer receivables, or work-in-progress cost accounting ledgers.
- Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.
Issue 1: Sales Order Blocked by Credit Limit Exception#
- Symptom: Confirm button fails with error: Customer credit limit exceeded.
- Root Cause: Customer's open receivables plus current order value exceeds the approved credit ceiling.
- Remediation:
- Inspect customer ledger in Invoicing → Customers → Aged Receivables.
- If the customer has unallocated payments, register a Cash Receipt Voucher (CRV) to reconcile old bills.
- If credit increase is justified, have the Finance Director approve an override.
Issue 2: POS Offline Mode Not Syncing After Internet Reconnects#
- Symptom: Orders rung up during internet downtime remain in browser local storage and do not appear in backend sessions.
- Root Cause: Browser IndexedDB buffer synchronization stalled due to network token expiration.
- Remediation:
- Do not clear browser cache or cookies (this would delete unposted sales).
- In the POS top status bar, check the sync indicator dot (Red = Offline, Green = Synced).
- Tap the sync icon to trigger manual synchronization. The offline queue flushes to the server.
Issue 3: Telebirr Payment Webhook Timeout#
- Symptom: Customer deducted funds on their phone, but the POS screen still displays Waiting for payment.
- Root Cause: Network latency between Ethio Telecom clearing gateway and SmartERP webhook endpoint.
- Remediation:
- Tap Query Payment Status on the POS terminal.
- SmartERP polls the Telebirr query API directly using the order reference and confirms the settlement.
4. Advanced Configuration Points#
- Automated Actions & Scheduled Tasks (Crons):
CRM: Lead auto-assignment(crm.ir_cron_lead_assign): Runs hourly to allocate unassigned leads across sales teamsSales: Expire overdue quotations(sale.ir_cron_expire_quotes): Runs nightly to mark stale quotes as cancelledPOS: Close abandoned register sessions(point_of_sale.ir_cron_session_cleanup): Runs nightly to alert managers of open cashier terminals
- Custom Print Templates & Reports:
- Customer Sales Quotation / Pro-forma Invoice
- Commercial Tax Invoice (Model 85 Compliant)
- POS Cash Register Receipt with QR Validation
- Customer Credit Limit & Receivables Aging Statement
- Multi-Company Rules: Record-level security isolation under Company 1 (
Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Credit Limit Blocked: Customer balance exceeds ceiling | Outstanding customer debt plus current order exceeds approved credit limit. | Obtain credit committee exception approval or collect an advance cash payment. |
Validation Error: Tax definition missing on product line | Product item lacks default statutory 15% VAT mapping. | Update the product master accounting tab with standard statutory VAT rates. |
POS Session Error: Cash register mismatch upon closure | Physical cash count does not reconcile with POS recorded register balance. | Document discrepancy explanation in the closing wizard and submit for manager review. |
Payment Gateway Error: Telebirr timeout | Network timeout or invalid API bridge credentials. | Verify merchant credentials in Invoicing → Configuration → Payment Providers and retry transaction query. |
Next#
- Technical architecture: Technical architecture.
Last updated: 2026-11-15