Concepts and accounting principles

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.

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

{screenshot:concepts-overview-dashboard}

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 Module 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. Select the Accounting app icon.
4. From the top navigation bar, open Accounting → Customers / Vendors / Accounting / Configuration.

{screenshot:concepts-app-switcher-navigation}

Step 2: Creating and Parameterizing Records#

1. Click the New button in the top-left control panel.
2. Complete the mandatory fields in the record form:
   • Name / Reference (Mandatory): Unique identifier or auto-generated voucher sequence number
   • Accounting Date (Mandatory): Effective posting date falling within an open fiscal period
   • Journal (Mandatory): Designated financial journal (Cash, Bank, Customer Invoices, Vendor Bills, Miscellaneous)
   • Partner / Entity (Mandatory): Registered customer, vendor, or employee partner record (res.partner)
3. Configure optional operational parameters and localized tags as required:
   • Analytic Distribution (Optional): Cost center or project allocation percentage
   • Tax Treatment (Optional): Statutory withholding tax or VAT exemption certificate
   • Payment Reference (Optional): Commercial bank transaction reference or cheque number
4. Click the Save icon in the control bar to commit the record.

{screenshot:concepts-record-creation-form}

Step 3: Validating and Processing Transactions#

• State Transitions: Execute operational state progression (Draft → In Payment / Confirmed → Posted / Reconciled).
• Ledger & System Impact: Generates immutable double-entry journal items (account.move.line) updating general ledger balances, trial balance, and statutory tax registers.
• Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.

{screenshot:concepts-transaction-processing-state}

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:

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:

Petty Cash Imprest System#

SmartERP manages petty cash using the classical fixed imprest model:

[finance-petty-cash-lifecycle]

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#

Next#

• Run a complete payment: Quick start.
• Deduct withholding tax: Calculate and deduct withholding tax.
• Set up petty cash: Set up petty cash fund.