SmartERP Documentation An Ashewa Technology Solutions Platform

Configure Ethiopian salary rules

Setup salary rule engines for Proclamation 979/2016 7-tier tax brackets, POESSA 18% pension, and transport exemptions in smarterp_payroll_et.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Configure Ethiopian salary rules within SmartERP.

Detailed computation flowchart of the Ethiopian monthly payroll batch engine from attendance sync to tax, pension, GL posting, and bank transfer.
Monthly Ethiopian statutory payroll calculation and settlement sequence.

Ethiopian Statutory Salary Rules and Progressive Tax Brackets

This page is for Payroll Directors and System Implementers configuring the Python salary calculation rules.

2. Prerequisites & Security Access Groups#

  • Required Modules: hr, hr_payroll, hr_holidays, smarterp_ethiopian_payroll
  • Security Groups:
    • Officer: Manage all employees (Technical ID: hr.group_hr_user)
    • Payroll Officer (Technical ID: hr_payroll.group_hr_payroll_user)
    • HR Administrator (Technical ID: hr.group_hr_manager)
  • Master Data Dependencies: Company departments, job positions, salary structures, 7-tier Ethiopian income tax brackets, POESSA/PSSPA pension rates, and employee contracts.

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 Payroll → Configuration → Salary Rules.

Ethiopian Statutory Salary Rules and Progressive Tax Brackets

Step 2: Workforce Data Parameters & Statutory Controls#

Ensure all personnel and compensation records adhere to statutory labor regulations:

  • Designated Authority / Role: Operation authorized under verified RBAC role (Payroll Specialist, Tax Accountant).
  • Employee Master & Contract Binding: Linked to active employee profile, verified TIN, and active employment contract.
  • Statutory Labor & Pension Validation: Compliant with Ethiopian Labour Proclamation No. 1156/2019, POESSA Pension Proclamation No. 1268/2022 (11% employer / 7% employee), and Income Tax Proclamation No. 979/2016.

Step 3: Operational Execution & State Progression#

  • State Progression Gate: Advance record from Draft through Reviewed to Confirmed / Certified.
  • Integrated Workforce Impact: Synchronizes attendance hours, adjusts leave entitlement balances, and feeds gross-to-net payroll journal disbursements (account.move).
  • Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.

Core salary structure: Ethiopian Commercial Enterprise Structure#

Open Payroll → Configuration → Salary Structures and select ET_COMMERCIAL.

Rule 1: Progressive Employment Income Tax (PAYE)#

Technical Code: PAYE_TAX Category: Deduction (DED)

# Proclamation 979/2016 7-Tier Income Tax Rule
taxable = categories.GROSS - categories.EXEMPT_ALLOWANCES
if taxable <= 600.0:
    result = 0.0
elif taxable <= 1650.0:
    result = (taxable * 0.10) - 60.0
elif taxable <= 3200.0:
    result = (taxable * 0.15) - 142.50
elif taxable <= 5250.0:
    result = (taxable * 0.20) - 302.50
elif taxable <= 7800.0:
    result = (taxable * 0.25) - 565.00
elif taxable <= 10900.0:
    result = (taxable * 0.30) - 955.00
else:
    result = (taxable * 0.35) - 1500.00

Rule 2: POESSA Employee Pension (7%)#

Technical Code: PENSION_EE Category: Deduction (DED)

# Proclamation 715/2011 Employee Pension
result = contract.wage * 0.07

Rule 3: POESSA Employer Pension (11%)#

Technical Code: PENSION_ER Category: Company Contribution (COMP)

# Proclamation 715/2011 Employer Contribution
result = contract.wage * 0.11

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • HR: Compute scheduled leave accruals (hr_holidays.ir_cron_leave_accruals): Runs bi-weekly to accrue annual leave balances per Ethiopian labor law
    • Payroll: Auto-generate monthly payslip batches (hr_payroll.ir_cron_generate_payslips): Runs on the 25th of each calendar month
    • Attendance: Validate biometric clock-in logs (hr_attendance.ir_cron_sync_attendance): Runs hourly to sync biometric terminal events
  • Custom Print Templates & Reports:
    • Official Ethiopian Monthly Payslip
    • POESSA / PSSPA Statutory Pension Contribution Schedule
    • MOR Employment Income Tax (PAYE) Monthly Summary
    • Employee Service & Severance Certificate
  • 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
Access Rights Error: Employee private data hiddenUser lacks HR Officer security clearance.Assign the user to hr.group_hr_user under Settings → Users & Companies.
Computation Error: Missing contract or salary structureEmployee has no active contract in 'running' state.Confirm contract terms under Employees → Contracts and ensure contract status is 'Running'.
Validation Error: Leave allocation exhaustedRequested time off exceeds accrued balance under Ethiopian Labor Proclamation 1156/2019.Review historical attendance and submit a formal allocation adjustment request.
Payroll Blocked: Unlinked TIN or Pension numberStatutory rule requires mandatory tax and pension coordinates for payslip calculation.Update the statutory tab on the employee profile with valid MOR and POESSA registration details.

Next#

Last updated: 2026-11-15