SmartERP Documentation An Ashewa Technology Solutions Platform

Set up chart of accounts

Configure account codes, account types, currency restrictions, and analytic distribution cost centers for Ethiopian accounting standards.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Set up chart of accounts within SmartERP.

Entity relationship diagram of core SmartERP financial models: account.move, account.payment, wht.at.payment, and petty.cash.fund.
Core financial data entities and relational structure.

SmartERP Chart of Accounts Hierarchy and Types

This page is for Financial Controllers, Senior Accountants, and Administrators setting up or maintaining the Chart of Accounts.

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 → Accounting → Chart of Accounts.

SmartERP Chart of Accounts Hierarchy and Types

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 (Chief Accountant, Financial Controller).
  • 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.

Open the Chart of Accounts#

Open Accounting → Configuration → Accounting → Chart of Accounts.

The list displays account codes, account names, types, current balances, and currency configurations.

Create a new account#

  1. Press New.
  2. In Code, enter the numerical account identifier adhering to company numbering conventions (e.g. 610500 for Staff Training Expense).
  3. In Account Name, enter a clear descriptive title in English and Amharic (e.g. Staff Training & Development Expense (የሰራተኞች ስልጠና ወጪ)).
  4. In Type, choose the regulatory financial category:
    • Bank and Cash: for liquid operational funds subject to reconciliation.
    • Current Assets / Non-current Assets: for receivables, inventory, and equipment.
    • Current Liabilities / Non-current Liabilities: for payables and tax provisions.
    • Equity: for share capital, reserves, and retained earnings.
    • Income: for sales and commercial revenue.
    • Cost of Revenue: for direct production and inventory acquisition costs.
    • Expenses: for general, administrative, and selling expenditures.
  5. In Default Taxes, optionally attach statutory taxes (e.g. VAT 15%) to auto-populate invoices and bills.
  6. Check Allow Reconciliation for balance sheet clearing accounts (e.g. Accounts Payable, Uncleared Cheques).
  7. Press the save icon.

Important

Once transactions are posted to an account, its Type and Code cannot be changed if foreign transactions or tax declaration dependencies exist.

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