SmartERP Documentation An Ashewa Technology Solutions Platform

NGO Operations Troubleshooting & Humanitarian FAQ

Troubleshooting solutions for budget hard-stop blocks, donor reporting currency mismatches, Telebirr bulk cash fails, and ACSO ratio warnings.

1. Overview & Business Value#

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

ACSO 80/20 cost ratio compliance, budget availability hard stops, and annual donor audit reporting workflow.
ACSO Proclamation 1113/2019 80/20 budget burn control and statutory reporting workflow.

Troubleshooting solutions for budget hard-stop blocks, donor reporting currency mismatches, Telebirr bulk cash fails, and ACSO ratio warnings.

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_ngo_grants, smarterp_humanitarian, smarterp_fund_accounting
  • Security Groups:
    • Grant Officer (Technical ID: smarterp_ngo.group_grant_user)
    • Finance Director (NGO) (Technical ID: smarterp_ngo.group_grant_manager)
    • Field Relief Distribution Officer (Technical ID: smarterp_ngo.group_field_officer)
  • Master Data Dependencies: Donor profiles (USAID, EU, UN, FCDO), multi-currency grant agreements, restricted fund accounts, ACSO 80/20 cost allocation categories, and beneficiary rosters.

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 Grants → Active Grants.

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (Country Director, Grant Manager, Compliance Officer, M&E Specialist).
  • 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 & Resolutions#

1. Purchase Requisition Blocked Due to "Budget Hard-Stop"#

  • Symptoms: System prevents submitting a purchase requisition for urgently needed field supplies with error: "Budget Exceeded on Line 2.1".
  • Root Cause: The requested amount exceeds available uncommitted budget for that specific activity line.
  • Resolution:
    1. Open the project budget breakdown in NGO Grants > Projects > Budget Breakdown.
    2. Verify if savings exist on sibling budget lines.
    3. Submit an electronic Budget Virement Request (internal transfer between lines) within authorized donor thresholds (typically up to 10% without formal donor amendment).
    4. Once the Finance Director approves the virement, the requisition clears immediately.

2. Telebirr Bulk Cash Transfer Dispatches with Partial Failures#

  • Symptoms: Out of 1,000 cash transfer recipients, 982 succeed but 18 report RECIPIENT_WALLET_INACTIVE.
  • Resolution:
    1. Open NGO Grants > CVA > Cash Transfer Batches and select the failed transaction queue.
    2. The system isolates the 18 failed records without duplicating the 982 successful payments.
    3. Contact the field team to update beneficiary mobile numbers or issue manual cash counter vouchers.
    4. Click Retry Failed Payouts to re-dispatch the updated recipients.

3. ACSO 80/20 Dashboard Flags Warning: "Admin Ratio at 21.4%"#

  • Symptoms: Mid-year compliance dashboard displays an orange warning indicating administrative expenses are trending above the 20% statutory cap.
  • Root Cause: Central office overhead expenditures incurred early in the year while field program activity disbursements were delayed.
  • Resolution:
    1. Convene an executive management review with program directors to accelerate planned field program activities.
    2. Verify that all field-related monitoring travel and project vehicle fuel were properly tagged as Program (80%) rather than mistakenly coded to administrative overhead.
    3. Reclassify miscoded direct project lines to restore compliance.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • NGO: Calculate ACSO 80/20 cost ratio compliance (smarterp_ngo.ir_cron_acso_ratio): Runs weekly to flag any operational overhead drift above 20% limit
    • Grants: Reconcile foreign currency funding variance (smarterp_ngo.ir_cron_fx_reconcile): Runs monthly to revalue restricted foreign currency bank accounts
  • Custom Print Templates & Reports:
    • ACSO Statutory Annual Financial Statement (80/20 Rule)
    • Donor Financial Expenditure Report (Multi-Currency)
    • Beneficiary Relief Distribution Voucher (Model 20 SIV)
    • Time-and-Effort Personnel Timesheet Allocation Summary
  • 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
ACSO 80/20 Violation Block: Administrative overhead exceeds 20%Cumulative overhead costs exceed statutory ceiling established under Proclamation No. 1113/2019.Reclassify direct project support expenses to program operational accounts or restrict general administrative spending.
Budget Burn Halt: Grant line item allocation exhaustedCommitted purchase or payroll expense exceeds approved donor line envelope.Submit a formal grant budget reallocation or amendment request to the donor.
Duplicate Beneficiary Error: ID already claimed in cycleNational ID or biometric record already logged for current distribution cycle.Audit beneficiary registration records and confirm identity against Kebele verification list.
Last updated: 2026-11-15