SmartERP Documentation An Ashewa Technology Solutions Platform

SACCO AI Copilot & Automated Risk Advisory

Leverage embedded AI to compute member credit scores, forecast portfolio delinquency, and generate regulatory audit summaries.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for SACCO AI Copilot & Automated Risk Advisory within SmartERP.

Leverage embedded AI to compute member credit scores, forecast portfolio delinquency, and generate regulatory audit summaries.

{screenshot:sacco-ai-copilot-and-risk-advisory-overview-dashboard}

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_sacco_core, smarterp_equb, smarterp_loan_management
  • Security Groups:
    • SACCO Loan Officer (Technical ID: smarterp_sacco.group_sacco_officer)
    • SACCO Credit Committee Member (Technical ID: smarterp_sacco.group_sacco_committee)
    • SACCO General Manager (Technical ID: smarterp_sacco.group_sacco_manager)
  • Master Data Dependencies: Member KYC profiles, share capital registers, savings product tiers, loan products with reducing-balance schedules, and Equb rotational pool configurations.

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 SACCO & Equb app icon.
  4. From the top navigation bar, open SACCO & Equb → Members → KYC Registry / Savings Accounts / Loan Applications / Equb Pools.

{screenshot:sacco-ai-copilot-and-risk-advisory-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:
    • Member Identification Number (Mandatory): Unique membership number complying with Ethiopian Cooperative Commission rules
    • Full Name & Kebele ID (Mandatory): Verified member identity with physical residence verification
    • Share Capital Subscriptions (Mandatory): Subscribed shares not exceeding statutory 10% member ceiling (Proclamation 985/2016)
    • Primary Savings Product (Mandatory): Compulsory regular monthly savings account configuration
  3. Configure optional operational parameters and localized tags as required:
    • Guarantor & Collateral (Optional): Approved co-signers with locked savings accounts or registered vehicle/property lien
    • Equb Rotational Group (Optional): Linked digital Equb pool with lottery draw eligibility
    • Beneficiary Nominee (Optional): Designated next of kin for death or disability benefit transfer
  4. Click the Save icon in the control bar to commit the record.

{screenshot:sacco-ai-copilot-and-risk-advisory-record-creation-form}

Step 3: Validating and Processing Transactions#

  • State Transitions: Execute operational state progression (Application → KYC Verified → Approved → Active / Disbursed → Delinquency Monitored → Settled).
  • Ledger & System Impact: Loan disbursement debits loans receivable and credits cash/bank; loan repayments credit interest income and loan principal, updating 5-tier NBE provisioning registers.
  • Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.

{screenshot:sacco-ai-copilot-and-risk-advisory-transaction-processing-state}

Specialized Cooperative AI Intelligence#

The SmartERP SACCO AI Copilot (Agent 18) operates as an embedded analytical advisor within the core banking environment, processing longitudinal transaction data to deliver actionable financial intelligence.

AI Member Credit Scoring Model#

During loan appraisal, loan officers can click AI Credit Assessment:

  • The Copilot evaluates multi-factor behavioral signals:
    • 24-month savings consistency (on-time monthly deposit regularity).
    • Historical loan repayment discipline (zero late payments on previous cycles).
    • Equb participation reliability and guarantor track record.
  • The Copilot generates an explainable Credit Score (0–1000) and recommendation:
    • "Applicant Abebe Kebede maintains a Credit Score of 840 (Low Risk). Recommended loan approval up to 50,000 ETB with standard 12-month tenure."

Portfolio Delinquency Risk Forecasting#

For SACCO executives and risk committees:

  1. Open the AI Portfolio Risk Cockpit.
  2. The AI model analyzes macroeconomic trends, regional rainfall/agricultural patterns (for rural SACCOs), and member sector concentrations.
  3. It forecasts potential PAR-30 trends over the coming quarter, recommending preventive interventions (e.g., proactive SMS reminders to transport sector borrowers).

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • SACCO: Accrue monthly member savings interest (smarterp_sacco.ir_cron_savings_interest): Runs on the final day of each calendar month to credit interest
    • Loan: Evaluate 5-tier NBE delinquency classification (smarterp_sacco.ir_cron_loan_delinquency): Runs nightly to compute loan loss provisions per NBE directives
    • Equb: Execute scheduled lottery draw (smarterp_sacco.ir_cron_equb_draw): Runs on defined pool cycle dates using provably fair random selection
  • Custom Print Templates & Reports:
    • Member Savings Passbook & Transaction Ledger
    • Loan Amortization Schedule (Reducing Balance)
    • NBE 5-Tier Delinquency & Loan Loss Provisioning Statement
    • Annual Patronage Dividend Distribution Schedule
  • 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
Loan Blocked: Exceeds 3x savings ceilingRequested loan principal exceeds 300% of member unencumbered savings balance.Increase compulsory savings deposit or provide authorized co-signers with sufficient collateral.
Equb Draw Blocked: Participant arrears detectedSelected Equb member has unpaid rotational dues in current or prior cycles.Collect outstanding contribution payment before executing lottery draw.
Share Capital Limit Error: Member exceeds 10% ceilingSubscribed shares exceed statutory maximum under Proclamation No. 985/2016.Restrict share allocation to maximum allowable 10% total cooperative equity threshold.
Last updated: 2026-10-30