Concepts and HR principles

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Concepts and HR principles within SmartERP.

This page explains the fundamental concepts and rules governing SmartERP Human Resources & Payroll. It is written for HR Officers, Payroll Officers, and Auditors.

{screenshot:concepts-overview-dashboard}

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 Module 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. Select the Employees app icon.
4. From the top navigation bar, open Human Resources → Employees / Contracts / Attendance / Time Off / Payroll.

{screenshot:concepts-app-switcher-navigation}

Step 2: Creating and Parameterizing Records#

1. Click the New button in the top-left control panel.
2. Complete the mandatory fields in the record form:
   • Employee Name (Mandatory): Legal employee name matching national identity card or passport
   • Department & Job Position (Mandatory): Assigned administrative unit and official role title
   • Contract / Salary Structure (Mandatory): Active employment contract defining basic salary and statutory allowances
   • Taxpayer Identification Number (TIN) (Mandatory): Mandatory 10-digit MOR tax identifier for payroll declaration
3. Configure optional operational parameters and localized tags as required:
   • Pension Scheme Number (Optional): POESSA private or PSSPA public pension account number
   • Bank Account Details (Optional): Commercial bank account number for direct net pay credit transfers
   • Work Mobile & Email (Optional): Internal enterprise communication coordinates
4. Click the Save icon in the control bar to commit the record.

{screenshot:concepts-record-creation-form}

Step 3: Validating and Processing Transactions#

• State Transitions: Execute operational state progression (Draft → Pending Review → Verified → Approved / Running → Closed).
• Ledger & System Impact: Payroll batch confirmation automatically generates composite salary expense, pension payable, and tax withholding journal entries in the General Ledger.
• Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.

{screenshot:concepts-transaction-processing-state}

8-Tier Grade and Salary Band Matrix#

SmartERP structures organizational compensation using an 8-tier grade hierarchy (smarterp_hr_grade):

[hr-grade-band-matrix]

• Grades 1–2 (Operational & Support): Drivers, office assistants, custodians, security officers.
• Grades 3–4 (Technical & Professional): Accountants, software developers, sales specialists, nurses.
• Grades 5–6 (Managerial & Expert): Department managers, senior architects, principal consultants.
• Grades 7–8 (Executive Leadership): Chief Officers (CFO, CTO, COO) and Managing Directors.

Each grade defines:

• Minimum Wage (Entry Level)
• Midpoint (Market Competitive Rate)
• Maximum Wage (Grade Ceiling)
• 5 Steps: Standardized step increments (Step 1 to Step 5) awarded through annual merit reviews.

Ethiopian Employment Income Tax (PAYE) Mathematics#

Under Ethiopian Income Tax Proclamation No. 979/2016, progressive monthly employment income tax is calculated according to the statutory 7-tier tax schedule:

POESSA Pension Mathematics#

Under Proclamation No. 715/2011, pension contributions are calculated strictly on the employee's Basic Salary:

$$\text{Employee Pension (7%)} = \text{Basic Salary} \times 0.07$$

$$\text{Employer Pension (11%)} = \text{Basic Salary} \times 0.11$$

$$\text{Total POESSA Remittance (18%)} = \text{Employee Pension} + \text{Employer Pension} = \text{Basic Salary} \times 0.18$$

Taxable vs. Non-Taxable Allowances#

• Transport Allowance: Exempt from income tax up to ETB 2,200.00 per month (or 1/4 of basic salary, whichever is lower). Amounts exceeding the ceiling are fully taxable.
• Hardship Allowance: Exempt up to statutory regional percentages.
• Mobile / Communication Allowance: Fully taxable unless tied to registered business usage documentation.

Worked Example: Comprehensive Monthly Payroll Computation#

An employee earns a Basic Salary of ETB 20,000.00 plus a Transport Allowance of ETB 3,000.00:

1. Basic Salary: ETB 20,000.00
2. Transport Allowance Breakdown:
   • Non-Taxable Portion: ETB 2,200.00
   • Taxable Excess Portion: $3,000.00 - 2,200.00 = \text{ETB 800.00}$
3. Gross Taxable Income: $20,000.00 + 800.00 = \text{ETB 20,800.00}$
4. Income Tax Computation (Exceeds ETB 10,900 bracket @ 35%): $$\text{PAYE Tax} = (20,800.00 \times 0.35) - 1,500.00 = 7,280.00 - 1,500.00 = \text{ETB 5,780.00}$$
5. POESSA Pension Deductions:
   • Employee Pension (7% of Basic): $20,000.00 \times 0.07 = \text{ETB 1,400.00}$
   • Employer Pension (11% of Basic): $20,000.00 \times 0.11 = \text{ETB 2,200.00}$
6. Net Take-Home Salary: $$\text{Gross Earnings} - \text{PAYE Tax} - \text{Employee Pension}$$ $$\text{Net Pay} = (20,000.00 + 3,000.00) - 5,780.00 - 1,400.00 = 23,000.00 - 7,180.00 = \text{ETB 15,820.00}$$

Statutory Overtime Multipliers#

Under Ethiopian Labour Proclamation No. 1156/2019 (Article 68):

$$\text{Hourly Rate} = \frac{\text{Monthly Basic Salary}}{\text{Standard Monthly Hours (e.g. 208 hours)}}$$

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#

Next#

• Run a complete payslip: Quick start.
• Set up grade matrix: Set up grade and salary band matrix.
• Configure salary rules: Configure Ethiopian salary rules.