Automated Tax Calculation & Ethiopian Proclamation 979/2016 Copilot

1. Overview & Business Value#

The SmartERP Tax Calculation Copilot automates complex multi-tier Ethiopian statutory tax assessments in strict accordance with the Federal Income Tax Proclamation No. 979/2016.

1. Overview & Business Value#

Tax errors lead to severe penalties from the Ministry of Revenues (MoR). This agent runs continuous real-time audits across payroll sheets, vendor bills, and customer proformas, detecting tax tier misclassifications before final submission.

{screenshot:ai-tax-calculation-dashboard}

2. Prerequisites & Security Access Groups#

• Required Modules: account, om_hr_payroll, smarterp_ai_suite
• Security Groups:
  • Billing Accountant (Technical ID: account.group_account_invoice)
  • Tax Compliance Auditor (Technical ID: account.group_account_manager)

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Tax Audit Workspace#

1. Open Accounting → Tax & Compliance → Tax Copilot.
2. Select the current fiscal period (e.g., Hamle 2018 / July 2026).

Step 2: Triggering Automated Tax Computation#

1. Click Audit Period Transactions.
2. The agent executes three parallel verification algorithms:
   • Progressive Employment Tax: Audits all employee payroll lines against the 7-tier bracket:
     • ETB 0 – 600: 0%
     • ETB 601 – 1,650: 10% (deduction ETB 60)
     • ETB 1,651 – 3,200: 15% (deduction ETB 142.50)
     • ETB 3,201 – 5,250: 20% (deduction ETB 302.50)
     • ETB 5,251 – 7,800: 25% (deduction ETB 565)
     • ETB 7,801 – 10,900: 30% (deduction ETB 955)
     • Over ETB 10,900: 35% (deduction ETB 1,500)
   • Withholding Tax (WHT): Flags invoices over ETB 10,000 without 2% goods WHT or services over ETB 3,000 without 30% un-registered supplier WHT.
   • Value Added Tax (VAT): Verifies 15% VAT output matching against fiscal cash register (FCR) receipts.

{screenshot:ai-tax-audit-results}

Step 3: Remediating Detected Discrepancies#

1. Review the generated Discrepancy Ledger.
2. Click Auto-Adjust Tax Lines to generate balancing journal entries in the Tax Adjustment Journal.

4. Advanced Configuration Points#

• Crons: account.ir_cron_monthly_tax_reconciliation (runs on the 25th of each calendar month).
• Reports: Produces official MoR Monthly Declaration Schedules (Model 21 & Model 22).

5. Troubleshooting Matrix#

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#

1. Log into your SmartERP instance at https://smarterp.et/odoo.
2. Open the main App Switcher and select Ashewa AI.
3. Select the operational workspace corresponding to this agent suite.

{screenshot:44-automated-tax-calculation-agent-step1-navigation}

Step 2: Executing Agent Actions#

1. Review agent prompts and execution parameters.
2. Trigger the scheduled or on-demand workflow action.
3. Validate output in the generated operational log.

{screenshot:44-automated-tax-calculation-agent-step2-execution}

4. Advanced Configuration Points#

• Scheduled Crons: muk_ai.ir_cron_agent_health_check runs 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#