የSmartERP መመሪያ የAshewa Technology Solutions መድረክ
ይህ ገጽ ገና ወደ አማርኛ አልተተረጎመም። የእንግሊዝኛው ጽሑፍ ቀርቧል።

SACCO Troubleshooting & Operational FAQ

Troubleshooting solutions for daily drawer variances, loan disbursement timeouts, savings interest discrepancies, and Equb lottery resets.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for SACCO Troubleshooting & Operational FAQ within SmartERP.

የህብረት ስራ ማህበር አባልነት ምዝገባ፣ የአክሲዮን ክፍያ፣ የቁጠባ ሂሳብ እና የትርፍ ክፍፍል ሂደት።
የSACCO የአባላት ካፒታል ምስረታ፣ የቁጠባ አሰራር እና አመታዊ የትርፍ ክፍፍል ሂደት።

Troubleshooting solutions for daily drawer variances, loan disbursement timeouts, savings interest discrepancies, and Equb lottery resets.

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 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 SACCO Core → Member Accounts; Loans → Active Loans.

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (SACCO General Manager, Loan Appraisal Officer, Cashier).
  • Relational Integrity: Linked to upstream master records, approval requests, or transactional ledgers.
  • Statutory & Quality Controls: Verified against Ethiopian statutory regulations and corporate governance standards.

Step 3: Operational Execution & State Progression#

  • State Progression Gate: Advance record from Draft through Audited to Confirmed / Certified.
  • Integrated System Impact: Automatically updates real-time operational states and posts financial/inventory journal moves.
  • Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.

Frequently Encountered Issues & Solutions#

1. Teller Drawer Imbalance at Day-End Close#

  • Symptoms: Teller close screen reports a cash shortage or surplus variance.
  • Resolution:
    1. Open SACCO > Teller Counter > Shift Transactions.
    2. Verify all physical deposit and withdrawal vouchers against electronic lines.
    3. Check if a mobile money (Telebirr/CBE) deposit was mistakenly tagged as physical cash.
    4. If variance persists, post variance to Cash Overage / Shortage Suspense Account (101900) with mandatory supervisor sign-off.

2. Loan Disbursement Times Out on Telebirr API#

  • Symptoms: Cashier clicked Disburse, but the screen reports GATEWAY_TIMEOUT while funds were deducted from the SACCO corporate wallet.
  • Resolution:
    1. Do NOT click Disburse a second time (prevents duplicate payments).
    2. Open SACCO > Integration > Gateway Transaction Logs.
    3. Query the specific transaction reference against the Ethio Telecom API status endpoint.
    4. If payment succeeded at the telecom gateway, click Force Reconcile & Mark Disbursed.

3. Member Loan Blocked Due to Pledged Guarantor Hold#

  • Symptoms: Member requests a loan but system alerts: "Available Savings: 0 ETB (Pledged Collateral Hold)".
  • Root Cause: The member acted as guarantor for a peer whose loan is currently active.
  • Resolution:
    1. Check SACCO > Members > Active Guarantees.
    2. Review the guaranteed peer loan balance.
    3. Once the peer amortizes the loan, the pledged hold automatically releases in proportion to principal repaid.

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.
መጨረሻ የተሻሻለው: 2026-11-15