Payroll¶
A powerful, rules-based payroll engine designed for UAE compliance and WPS (Wages Protection System) readiness.
📍 Menu Location¶
Sidebar → Payroll
⚙️ The Payroll Engine¶
Payroll is driven by a flexible rules-based architecture:
- Salary Rules: Define the logic for every pay component (e.g., Basic Wage, Housing Allowance, Transport, Overtime).
- Custom Logic: Rules can use Python-like expressions to calculate amounts based on employee seniority or category.
- Salary Structures: Group multiple rules into a template (e.g., "Standard Staff Structure" vs. "Manager Structure").
- Payslips: Individual records showing the breakdown of a single employee's earnings for a specific month.
🚀 The Monthly Payroll Run¶
Standardizing the month-end process into three steps:
- Batch Creation (
/payroll/run): Generate payslips for the entire company or specific departments in one click. - Review & Adjustment: After batch generation, review the Payroll Batch Details (
/payroll/batch/:batchId) to manually edit individual payslips for ad-hoc bonuses or deductions before finalizing. - Finalization & SIF: Once the batch is confirmed, the system generates the Salary Information File (SIF) required for your bank's WPS portal.
📊 Automated Accounting Integration¶
Confirming a payroll batch automatically generates a summary Journal Entry in Accounts: - Accrual: Debits your Salary Expense accounts and credits Salaries Payable. - Payment: Recording the bank transfer clears the payable.
✅ Payroll Business Rules¶
- Leave Integration: Unpaid leaves approved in HRMS are automatically deducted during the payroll run.
- WPS Compliance: Every employee must have a valid Bank Code and IBAN configured to be included in the SIF export.
- Commissions: Commission processing for the payroll period is done at
/payroll/commissions. Commission rules are managed at/commissions/rules.
Operational Tip: Run a "Draft" payroll batch 3 days before the end of the month to catch any missing data or incorrect leave records.