SmartERP Documentation An Ashewa Technology Solutions Platform

Concepts and accounting principles

Core accounting equations, Ethiopian Chart of Accounts hierarchy, voucher taxonomy, withholding tax mathematics, and imprest fund theory.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Concepts and accounting principles within SmartERP.

Ethiopian statutory tax engine workflow computing 2% goods and 30% services withholding tax, 15% VAT, WHV certificates, and MOR declarations.
Automated Ethiopian withholding tax (WHT) and VAT settlement lifecycle.

Financial Approvals and Multi-Level Threshold Governance

This page explains the fundamental concepts and rules governing SmartERP Financial Operations. It is written for Accountants, Controllers, and Financial Auditors.

2. Prerequisites & Security Access Groups#

  • Required Modules: account, smarterp_finance, smarterp_ethiopian_payroll
  • Security Groups:
    • Show Full Accounting Features (Technical ID: account.group_account_user)
    • Billing Administrator / Financial Controller (Technical ID: account.group_account_manager)
    • Chief Financial Officer / Auditor (Technical ID: account.group_account_readonly)
  • Master Data Dependencies: Chart of accounts, statutory tax definitions (VAT 15%, WHT 2%/30%), payment terms, and open fiscal periods for Company 1 (Ashewa Technology Solutions S.C.).

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Financial Interface#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher (grid icon in the top-left corner).
  3. Navigate to Accounting → Configuration → Settings.

Financial Approvals and Multi-Level Threshold Governance

Step 2: Financial Parameters & Statutory Controls#

Ensure all mandatory accounting parameters conform to statutory fiscal regulations:

  • Designated Authority / Role: Action authorized by verified financial role (Financial Controller, Chief Accountant, Systems Auditor).
  • Fiscal Period & Journal Integrity: Bound to an open, unlocked fiscal period adhering to the Ethiopian financial calendar.
  • Statutory Tax & Regulatory Validation: Compliant with Ethiopian Proclamation No. 979/2016 (Withholding Tax 2%/30%) and Proclamation No. 1157/2019 (VAT 15%).

Step 3: Transaction Posting & General Ledger Impact#

  • State Progression Gate: Advance record from Draft through Audited to Posted / Reconciled.
  • Double-Entry General Ledger Impact: System automatically generates immutable journal items (account.move.line) updating real-time trial balances and customer/vendor sub-ledgers.
  • Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.

Double-Entry Accounting Foundation#

SmartERP operates on strict double-entry principles. Every transaction consists of a balanced journal entry (account.move) where total debits strictly equal total credits:

$$\sum \text{Debits} = \sum \text{Credits}$$

The general balance sheet equation is maintained continuously across all fiscal periods:

$$\text{Assets} = \text{Liabilities} + \text{Equity}$$

$$\text{Net Income} = \text{Revenue} - \text{Cost of Goods Sold (COGS)} - \text{Operating Expenses (OPEX)}$$

Ethiopian Chart of Accounts (COA) Hierarchy#

SmartERP organizes the Chart of Accounts using standard 4-digit and 6-digit Ethiopian commercial structures:

Account Code RangeCategoryFinancial StatementNormal Balance
100000–199999Current & Non-Current AssetsBalance SheetDebit
200000–299999Liabilities (Accounts Payable, Tax Payable)Balance SheetCredit
300000–399999Equity & Retained EarningsBalance SheetCredit
400000–499999Operating & Non-Operating RevenueProfit & LossCredit
500000–599999Cost of Goods Sold (COGS)Profit & LossDebit
600000–699999Operating Expenses (Administrative & Selling)Profit & LossDebit
700000–799999Finance Costs & Other ExpensesProfit & LossDebit

Vouchers vs. Journal Entries#

SmartERP differentiates between raw General Ledger journal entries and user-facing commercial vouchers:

  • Journal Entry (account.move): The internal double-entry container comprising debit and credit lines.
  • Cash Receipt Voucher (CRV): An external-facing legal receipt proving funds collected by the cashier into cash registers or bank accounts.
  • Bank Payment Voucher (BPV): An authorized commercial disbursement voucher instructing banks to execute wire transfers or direct account debits.
  • Cheque Payment Voucher (CPV): A formal disbursement voucher tied to a specific cheque leaf serial number, payee title, and amount in words.
  • Journal Voucher (JV): An internal debit/credit voucher documenting depreciation, accruals, prepayments, or corrections.

Ethiopian Withholding Tax (WHT) Mathematics#

Under Ethiopian tax law (Proclamation No. 979/2016), Withholding Tax is calculated strictly on the VAT-exclusive base amount:

$$\text{Taxable Base} = \text{Gross Invoice Amount} - \text{VAT Amount}$$

$$\text{WHT Amount} = \text{Taxable Base} \times \text{WHT Rate}$$

$$\text{Net Settlement Payable} = \text{Gross Invoice Amount} - \text{WHT Amount}$$

Worked Example: Commercial Supply of Office Equipment#

A vendor supplies computer servers valued at ETB 100,000 plus 15% VAT:

  1. Taxable Base (Goods): ETB 100,000.00
  2. VAT @ 15%: ETB 15,000.00
  3. Gross Invoice Total: ETB 115,000.00
  4. WHT @ 2% on Goods (Exceeds ETB 10,000): $100,000 \times 0.02 = \text{ETB 2,000.00}$
  5. Net Cash/Bank Settlement to Vendor: $115,000 - 2,000 = \text{ETB 113,000.00}$
  6. Withholding Tax Payable to MOR: ETB 2,000.00

The resulting General Ledger posting is:

Account NameCodeDebit (ETB)Credit (ETB)
IT Equipment Asset150100100,000.00—
Input VAT Recoverable12030015,000.00—
Accounts Payable (Vendor)210100—115,000.00
At Payment Settlement:
Accounts Payable (Vendor)210100115,000.00—
Bank Account (Disbursement)110200—113,000.00
WHT Payable to MOR (2%)220200—2,000.00

Petty Cash Imprest System#

SmartERP manages petty cash using the classical fixed imprest model:

Petty cash imprest fund lifecycle from disbursement to cash count, reconciliation, and bank replenishment.
Petty cash imprest fund lifecycle and replenishment governance.
  1. Fixed Float: The fund maintains an approved ceiling (e.g., ETB 25,000).
  2. Current Cash + Valid Receipts = Approved Float: At any given moment, the physical cash in the safe plus submitted Petty Cash Payment Slips (PCPS / Form 3.4) must equal the total float.
  3. Replenishment Threshold: When physical cash falls below the threshold (e.g., 20% or ETB 5,000), a reconciliation batch is compiled, verified against receipts, and replenished via BPV.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • Account: Automatic reconciliation (account.ir_cron_auto_reconcile): Runs nightly to match open ledger transactions
    • Asset: Compute depreciation lines (account_asset.ir_cron_compute_depreciation): Runs monthly on the 30th to compute fixed asset depreciation schedules
    • Tax: Generate VAT and WHT schedules (smarterp_finance.ir_cron_tax_schedules): Runs monthly to prepare MOR tax return summaries
  • Custom Print Templates & Reports:
    • Official Cash Receipt Voucher (CRV)
    • Bank Payment Voucher (BPV) & Cheque Payment Voucher (CPV)
    • Withholding Tax Certificate (Form 3.4)
    • General Ledger & Trial Balance Audit Schedules
  • 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 / ExceptionProbable Root CauseCorrective Action / Resolution
Access Rights Error: Operation not allowed on account.moveUser account lacks accounting operator privileges.Assign the user to account.group_account_user or account.group_account_manager under Settings → Users.
Validation Error: Missing analytic distributionSelected general ledger account mandates cost center allocation for IFRS compliance.Populate the analytic distribution column on all debit and credit lines before posting.
Posting Blocked: Fiscal period closedTransaction date falls within an immutable locked accounting period.Select a transaction date within the open fiscal year or request an authorized period reopening under Accounting Settings.
Tax Imbalance: WHT withholding varianceWithholding deduction does not match statutory 2% goods or 30% service rate.Verify vendor TIN registration status in partner master and recalculate statutory tax lines.

Next#

Last updated: 2026-11-15