Finance and accounting overview

SmartERP Financial Operations provides an integrated, double-entry financial accounting platform designed for Ethiopian commercial enterprises, multi-company groups, and statutory regulatory environments governed by the Ministry of Revenues (MOR), the National Bank of Ethiopia (NBE), and International Financial Reporting Standards (IFRS).

Enterprise Financial Architecture#

At the core of SmartERP is an immutable, double-entry general ledger engine. Every business transaction across sales, procurement, inventory, payroll, and treasury is automatically transformed into balanced journal entries (account.move) composed of debit and credit journal items (account.move.line).

+----------------------------------------------------------------------------------------------------+
|                               SMARTERP FINANCIAL TRANSACTION ENGINE                                |
+----------------------------------------------------------------------------------------------------+
|                                                                                                    |
|   OPERATIONAL INPUTS               GOVERNED APPROVAL GATE            IMMUTABLE GENERAL LEDGER      |
|   +-----------------------+        +-----------------------+        +--------------------------+   |
|   | Commercial Sales      |------->| Tiered Financial DoA  |------->| Journal Entry            |   |
|   | Vendor Bills / POs    |        | Maker-Checker Review  |        | account.move (Draft)     |   |
|   | Cash Collections      |        | Budget Overrun Check  |        +------------+-------------+   |
|   | Petty Cash Vouchers   |        | SLA Escalation Watch  |                     |                 |
|   | Payroll Gross-to-Net  |        +-----------------------+                     v                 |
|   +-----------------------+                                         +--------------------------+   |
|                                                                     | Validation & Posting     |   |
|                                                                     | action_post()            |   |
|                                                                     +------------+-------------+   |
|                                                                                  |                 |
|                                                                                  v                 |
|   STATUTORY COMPLIANCE             FINANCIAL INTELLIGENCE           +--------------------------+   |
|   +-----------------------+        +-----------------------+        | Posted Ledger Items      |   |
|   | 15% VAT / TOT Engine  |<-------| Real-Time Trial Bal.  |<-------| account.move.line        |   |
|   | 2% & 30% WHT At Pay   |        | Multi-Dept P&L        |        | Sum(Debit) = Sum(Credit) |   |
|   | ERCA Excel E-Tax Rep. |        | Cash Flow Runway      |        | Strict Lock Dates        |   |
|   | Ethiopian Calendar    |        | 95+ Executive KPIs    |        +--------------------------+   |
|   +-----------------------+        +-----------------------+                                       |
+----------------------------------------------------------------------------------------------------+

Double-Entry Immutable Ledger Principles#

1. Strict Balance Invariant: Every posted journal entry must satisfy $\sum ext{Debit} = \sum ext{Credit}$ in both company currency (Ethiopian Birr - ETB) and transaction foreign currency. Imbalanced entries are blocked at the ORM layer.
2. Immutable Audit Trail: Once an entry is validated and transitioned to state = 'posted', it cannot be edited or deleted. Corrections require audited offsetting credit notes or formal reversing entries (reversal_move_id).
3. Strict Period Locking: The platform enforces strict closing lock dates (fiscalyear_lock_date and period_lock_date). Transactions dated on or before a locked period are rejected by database constraints, preventing historical ledger tampering.
4. Single Source of Truth: Sub-ledgers (Accounts Receivable, Accounts Payable, Fixed Assets, Inventory Valuation, and Bank Journals) are fully unified with the General Ledger. Reconciliation occurs in real time without batch synchronization lags.

Role-Based Operational Perspectives#

SmartERP Financial Operations is structured to serve distinct user tiers across the organization:

1. Executive Tier (CEO, CFO, and Board of Directors)#

• Solvency & Cash Runway: Real-time liquidity monitoring across physical cash drawers, commercial bank accounts, and mobile wallets (Telebirr, CBE Birr, Chapa).
• Executive KPI Intelligence: Tracking gross margin trends, operating expenditure burn rates, debtor days sales outstanding (DSO), and creditor days payable outstanding (DPO).
• Statutory Defense & Tax Governance: Proactive verification that 100% of vendor bills comply with withholding tax obligations and Ethiopian VAT regulations before disbursements occur.

2. Financial Controller & Consulting Accountants#

• Chart of Accounts (COA) Design: Hierarchical structure compliant with Ethiopian commercial practices and IFRS guidelines.
• 10-Step Month-End Close Checklist: Automated month-end accruals, depreciation runs, clearing account zeroing, foreign currency revaluation, and period locking.
• Audit Readiness: Full traceability from executive financial statements down to the underlying source document, scanned tax receipt, and timestamped user approval log.

3. Operational Accounting Specialists (GL, AP, AR, Treasury, and Cashiers)#

• Standardized Vouchers: Daily issuance of Bank Payment Vouchers (BPV), Cash Receipt Vouchers (CRV), Cheque Payment Vouchers (CPV), and Petty Cash Slips (PCPS).
• Withholding Tax Execution: Automatic calculation and debit/credit split of 2% goods and 30% service withholding upon bill settlement.
• Bank Auto-Reconciliation: High-speed electronic statement ingestion and 3-tier algorithmic matching between bank statement lines and GL entries.

4. Cross-Department Operational Stakeholders#

• Procurement & Logistics: Automated 3-way matching (Purchase Order vs. Goods Receipt Note vs. Vendor Bill) with supplier payment terms enforcement.
• Project Management Office (PMO): Direct absorption of project expenses, contractor disbursements, and employee timesheet costs into analytical project accounts for real-time commercial P&L tracking.
• Human Resources (HR): Seamless gross-to-net payroll journal generation, including progressive employment income tax (PAYE 0%–35%) and POESSA pension (7% employee, 11% employer) liabilities.
• Commercial Sales: Automated credit limit checks, customer deposit registration, commercial invoicing, and customer payment collections.

Core Capability Matrix#

Dual Calendar Synchronization (Ge'ez and Gregorian)#

SmartERP incorporates a native Ethiopian Calendar conversion engine (smart_et_calendar) based on the astronomical Beyene-Kudlek Julian Day Number (JDN) algorithm (ETHIOPIAN_JDN_EPOCH = 1724221).

+-------------------------------------------------------------------------------+
|                       DUAL CALENDAR HARMONIZATION ARCHITECTURE                |
+-------------------------------------------------------------------------------+
|                                                                               |
|   GREGORIAN STORAGE LAYER                CONVERSION ENGINE (JDN)              |
|   +------------------------------+       +--------------------------------+   |
|   | Standard PostgreSQL Timestamp|------>| Beyene-Kudlek JDN Algorithm    |   |
|   | Fields: date, create_date    |       | Epoch: JDN 1724221             |   |
|   | Timezone: UTC Naive          |       | Anchor: J2000.0 (JDN 2451545)  |   |
|   +------------------------------+       +---------------+----------------+   |
|                                                          |                    |
|                                                          v                    |
|   ETHIOPIAN FINANCIAL CALENDAR           USER INTERFACE & DUAL DISPLAY        |
|   +------------------------------+       +--------------------------------+   |
|   | 12 Months of 30 Days Each    |<------| Dual-Display Widget            |   |
|   | 13th Month: Pagume (5/6 Days)|       | English: Meskerem 1, 2016      |   |
|   | Fiscal Year: Hamle 1-Sene 30 |       | Amharic: መስከረም ፩ ቀን ፪ሺ፲፮ ዓ.ም |   |
|   | (Gregorian: July 8 - July 7) |       | Gregorian: Sep 12, 2023        |   |
|   +------------------------------+       +--------------------------------+   |
+-------------------------------------------------------------------------------+

• Database Normalization: All date fields in the database (account.move.date, account.payment.date) are stored as ISO Gregorian dates (YYYY-MM-DD), ensuring complete compatibility with standard PostgreSQL queries, reporting engines, and international APIs.
• Dual Display: When et_calendar_dual_display is enabled in Company Settings, users see both Gregorian and Ethiopian dates side by side on invoices, payment vouchers, and financial statements.
• Fiscal Year Alignment: Ethiopian corporate entities can configure their fiscal years according to the statutory Ethiopian tax cycle: Hamle 1 to Sene 30 (July 8 to July 7), divided into 12 monthly accounting periods plus a 13th Pagume reconciliation period.

Multi-Company Consolidation and Currency Management#

For corporate groups and holding companies, SmartERP provides comprehensive multi-entity financial capabilities:

• Entity Isolation: Each subsidiary maintains its own dedicated Chart of Accounts, Bank Journals, Tax IDs (TIN), VAT registration numbers, and Voucher pad sequences.
• Multi-Company Security: Automated row-level security (ir.rule) strictly segregates financial records based on the user's active company context (self.env.companies).
• Group Financial Consolidation: Inter-company clearing accounts enable seamless cross-entity settlements with automatic elimination entries upon consolidated reporting.
• Currency Revaluation: Full support for multi-currency transactions. Daily foreign exchange exchange rates from the National Bank of Ethiopia (NBE) are recorded, with automated posting of realized and unrealized FX gains/losses.

Transaction Life Cycle#

Every financial transaction in SmartERP traverses four disciplined governance stages:

1. Draft Stage (draft): The voucher, invoice, or journal entry is compiled. No financial movements hit the General Ledger. Budget lines are checked for preliminary headroom.
2. Review & Approval Gate (to_approve / checked / authorized): Depending on the transaction type and amount, the document routes through the required maker-checker review and executive signatories.
3. Posted Stage (posted): Debits and credits are formally committed to the General Ledger. General ledger balances, subsidiary accounts, and statutory tax registers update immediately.
4. Reconciled & Settled (reconciled / paid): The journal item is matched against the corresponding bank statement line, customer payment, or petty cash reimbursement slip.

Next Steps#

• Standardize daily vouchers: Payment and receipt vouchers.
• Operate imprest funds: Petty cash management.
• Implement tax withholding: Withholding tax and VAT.
• Configure approval matrices: Approval governance.
• Automate statement matching: Bank reconciliation.
• Analyze performance: Financial dashboards and reports.
• Review data structures: Finance technical architecture.