Payroll Configuration
Set up benefits, deduction rules, claim categories, and payroll processing settings.
Quick Access
| Role |
Navigation |
Route |
| HR Admin |
Settings → Benefits |
/settings/benefits |
| HR Admin |
Settings → Extra Incomes |
/settings/extra-incomes |
| HR Admin |
Settings → Penalty Definitions |
/settings/penalty-definitions |
| HR Admin |
HR → Staff Claim Policies |
/hr/staff-claim-policies |
Benefits Configuration
Accessing Benefits
- Go to Settings → Benefits (
/settings/benefits)
- View all benefit schemes
- Create or edit benefits
[Screenshot: benefits-list]
Creating a Benefit
- Click + New Benefit
- Configure settings:
- Benefit name
- Type (Allowance, Contribution, Insurance)
- Calculation method
- Tax treatment
- Save benefit
Benefit Types
| Type |
Description |
| Allowance |
Regular payments to employee |
| Employer Contribution |
Employer-paid benefits |
| Insurance |
Insurance premiums |
| Reimbursement |
Cost reimbursement |
Benefit Calculation Methods
| Method |
Description |
| Fixed Amount |
Same for all (e.g., RM200/month) |
| Percentage of Salary |
Based on basic pay |
| Bracket-Based |
Varies by salary tier |
| Custom Formula |
Complex calculations |
Benefit Brackets
For tiered benefits:
- Open benefit scheme
- Go to Brackets section
- Configure tiers:
| From |
To |
Amount |
| RM0 |
RM2,000 |
RM100 |
| RM2,001 |
RM5,000 |
RM150 |
| RM5,001 |
RM10,000 |
RM200 |
| RM10,001+ |
- |
RM250 |
Tax Treatment
| Setting |
Description |
| Taxable |
Included in taxable income |
| Non-Taxable |
Exempt from tax |
| Partially Taxable |
Tax above certain limit |
EPF Treatment
| Setting |
Description |
| EPF-able |
Included in EPF calculation |
| Non EPF-able |
Excluded from EPF |
- Go to Settings → Extra Incomes (
/settings/extra-incomes)
- Configure one-time or irregular income types
[Screenshot: extra-incomes]
| Type |
Description |
| Bonus |
Performance or annual bonus |
| Commission |
Sales commission |
| Incentive |
Special incentive payments |
| Back Pay |
Retrospective adjustments |
| Other |
Miscellaneous income |
- Create income type
- Set:
- Name
- Default calculation
- Tax treatment
- EPF treatment
- Assign to payroll as needed
Penalty Definitions
Accessing Penalties
- Go to Settings → Penalty Definitions (
/settings/penalty-definitions)
- View and manage deduction rules
[Screenshot: penalty-definitions]
Penalty Types
| Type |
Trigger |
| Late Penalty |
Arriving late |
| Absent Penalty |
Unexcused absence |
| Early Out |
Leaving early |
| Other |
Custom penalties |
Penalty Calculation
| Method |
Example |
| Fixed Amount |
RM10 per incident |
| Per Minute |
RM0.50 per minute late |
| Percentage |
0.25% of daily rate |
| Daily Rate Fraction |
1/30 of monthly salary |
Configuring Penalties
- Create penalty rule
- Set trigger conditions
- Define calculation method
- Link to shift templates
- Activate rule
Staff Claim Policies
Accessing Claim Policies
- Go to HR → Staff Claim Policies (
/hr/staff-claim-policies)
- View claim categories
- Configure limits and rules
[Screenshot: claim-policies]
Creating a Claim Category
- Click + New Policy
- Configure:
- Category name (e.g., "Mileage")
- Description
- Per-claim limit
- Monthly limit
- Annual limit
- Receipt requirements
- Save policy
Common Claim Categories
| Category |
Per Claim |
Monthly |
Annual |
| Mileage |
No limit |
RM500 |
RM6,000 |
| Meals |
RM100 |
RM400 |
RM4,800 |
| Accommodation |
RM300 |
RM600 |
RM3,600 |
| Transport |
RM200 |
RM500 |
RM3,000 |
| Communication |
RM100 |
RM100 |
RM1,200 |
Claim Workflow
Configure approval levels:
- Manager approval
- HOD approval
- HR approval
- Finance approval
Payroll Settings
Key System Settings
| Setting |
Description |
| STAFF_LOAN_AS_SALARY_PAYMENT |
Deduct loans from salary |
| EWA_AS_SALARY_PAYMENT |
Deduct EWA from salary |
| WORK_HOURS |
Standard work hours |
| WORK_DAYS |
Standard work days |
Payslip Display Settings
| Setting |
Effect |
| PAYSLIP_SHOW_DEPARTMENT |
Show department on payslip |
| PAYSLIP_SHOW_DESIGNATION |
Show job title |
| PAYSLIP_SHOW_LEAVE |
Show leave details |
| PAYSLIP_SHOW_OVERTIME_DETAILS |
Show OT breakdown |
| PAYSLIP_SHOW_PAYMENT |
Show payment method |
| PREVENT_EMPLOYEE_PAYSLIP |
Hide payslips from employees |
| PREVENT_EMPLOYEE_TIMESHEET |
Hide timesheets from employees |
Statutory Configurations
EPF Settings
| Configuration |
Description |
| Employee Rate |
Employee contribution rate |
| Employer Rate |
Employer contribution rate |
| Salary Cap |
Maximum salary for calculation |
SOCSO Settings
| Configuration |
Description |
| Contribution Category |
First category, second category |
| Rate Table |
Contribution amounts by salary |
EIS Settings
| Configuration |
Description |
| Employee Rate |
Standard 0.2% |
| Employer Rate |
Standard 0.2% |
| Salary Cap |
Maximum salary for calculation |
Tax Settings
| Configuration |
Description |
| PCB Calculation |
Monthly tax deduction method |
| Tax Brackets |
Income tax rates |
| Relief Types |
Employee relief claims |
Payroll Processing Settings
Pay Schedule
| Setting |
Options |
| Pay Frequency |
Monthly, Weekly |
| Pay Day |
Day of month/week |
| Cut-off Date |
Attendance cut-off |
Processing Options
| Setting |
Description |
| Auto-calculate |
Automatic payroll generation |
| Approval Required |
Require HR approval |
| Multiple Approvers |
Multiple sign-off needed |
| Lock After Process |
Prevent changes after processing |
Common Tasks
Add New Benefit Scheme
- Go to Benefits
- Create benefit
- Configure calculation
- Assign to employees
- Effective from next payroll
Update Claim Limits
- Go to Staff Claim Policies
- Edit relevant policy
- Update limits
- Save changes
- Go to Extra Incomes
- Create/edit bonus type
- Set calculation basis
- Process in December payroll
Adjust Statutory Rates
- Access relevant settings
- Update rates per latest regulations
- Document effective date
- Apply to next payroll
Tips
- Test changes - Try configuration changes with test employee first
- Document policies - Keep written records of all settings
- Stay updated - Monitor for statutory rate changes
- Audit regularly - Review configurations annually
See Also