MOR Statutory Audit & POESSA Pension Verification Agent
Automated verification agent for Ministry of Revenues annual returns and POESSA 11% employer / 7% employee pension compliance.
1. Overview & Business Value#
Ensuring error-free pension remittances to the Private Organizations Employees' Social Security Agency (POESSA) under Proclamation No. 715/2011 is mandatory for all Ethiopian corporate employers.
1. Overview & Business Value#
The MOR & POESSA Audit Agent reconciles payroll ledgers against bank transfer confirmations and POESSA portal contribution schedules, ensuring zero late remittance surcharges.
{screenshot:ai-mor-poessa-audit-overview}
2. Prerequisites & Security Groups#
- Required Modules:
om_hr_payroll, smarterp_hr_payroll_et, smarterp_ai_suite - Security Group:
Enterprise Compliance Officer(Technical ID:hr.group_hr_manager)
3. Step-by-Step Audit Execution#
Step 1: Launching POESSA Contribution Reconciliation#
- Navigate to Human Resources → Payroll → Statutory Compliance → POESSA Copilot.
- Click Generate Monthly Remittance Audit.
Step 2: Reviewing Contribution Math#
The agent validates the exact 18% total statutory contribution:
- Employee Share: $7\%$ of basic salary (deducted from employee pay).
- Employer Share: $11\%$ of basic salary (company statutory expense).
- Exclusion Check: Confirms that transport, overtime, and housing allowances are strictly excluded from the pensionable base.
{screenshot:ai-poessa-calculation-table}
Step 3: Exporting Certified POESSA Schedule#
- Review the validated headcount and contribution breakdown.
- Click Export POESSA Official Template (Excel/XML) for direct electronic upload.
4. Troubleshooting Matrix#
| Error Description | Probable Root Cause | Fix Procedure |
|---|---|---|
Pension base discrepancy: Non-basic salary included | A taxable allowance was inadvertently flagged as pensionable. | Set is_pensionable=False on the salary rule and recalculate payslip. |
Late filing alert: 30 days exceeded | Audit generated after the statutory monthly deadline (15th day of following month). | Expedite bank transfer and attach urgent processing note. |
2. Prerequisites & Security Access Groups#
- Required Modules:
muk_ai, muk_mcp, smarterp_ai_suite - Security Group:
Ashewa AI / User(Technical ID:muk_ai.group_ai_user) - Master Data Dependencies: Configured AI provider credentials, active system prompts, and departmental cost centers.
3. Step-by-Step UI Execution & Verification#
Step 1: Navigating to the Operational Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher and select Ashewa AI.
- Select the operational workspace corresponding to this agent suite.
{screenshot:46-mor-and-poessa-audit-agent-step1-navigation}
Step 2: Executing Agent Actions#
- Review agent prompts and execution parameters.
- Trigger the scheduled or on-demand workflow action.
- Validate output in the generated operational log.
{screenshot:46-mor-and-poessa-audit-agent-step2-execution}
4. Advanced Configuration Points#
- Scheduled Crons:
muk_ai.ir_cron_agent_health_checkruns every 30 minutes. - Multi-Company Isolation: Multi-company record rules ensure agent context is isolated to Company 1 (
Ashewa Technology Solutions S.C.).
5. Comprehensive Troubleshooting Matrix#
| Symptom / Error | Probable Root Cause | Resolution Action |
|---|---|---|
Agent unresponsive or timeout | Network latency or API endpoint outage. | Verify provider connection in Settings → AI Providers. |
Access Denied during agent execution | User lacks assigned operational permissions. | Assign user to the designated operational group. |