Administration Human Resources

Payroll Configuration

Set up benefits, deduction rules, claim categories, and payroll processing settings.

Payroll Configuration

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

  1. Go to Settings → Benefits (/settings/benefits)
  2. View all benefit schemes
  3. Create or edit benefits

[Screenshot: benefits-list]

Creating a Benefit

  1. Click + New Benefit
  2. Configure settings:
    • Benefit name
    • Type (Allowance, Contribution, Insurance)
    • Calculation method
    • Tax treatment
  3. 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:

  1. Open benefit scheme
  2. Go to Brackets section
  3. 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

Extra Incomes

Accessing Extra Incomes

  1. Go to Settings → Extra Incomes (/settings/extra-incomes)
  2. Configure one-time or irregular income types

[Screenshot: extra-incomes]

Extra Income Types

Type Description
Bonus Performance or annual bonus
Commission Sales commission
Incentive Special incentive payments
Back Pay Retrospective adjustments
Other Miscellaneous income

Configuring Extra Incomes

  1. Create income type
  2. Set:
    • Name
    • Default calculation
    • Tax treatment
    • EPF treatment
  3. Assign to payroll as needed

Penalty Definitions

Accessing Penalties

  1. Go to Settings → Penalty Definitions (/settings/penalty-definitions)
  2. 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

  1. Create penalty rule
  2. Set trigger conditions
  3. Define calculation method
  4. Link to shift templates
  5. Activate rule

Staff Claim Policies

Accessing Claim Policies

  1. Go to HR → Staff Claim Policies (/hr/staff-claim-policies)
  2. View claim categories
  3. Configure limits and rules

[Screenshot: claim-policies]

Creating a Claim Category

  1. Click + New Policy
  2. Configure:
    • Category name (e.g., "Mileage")
    • Description
    • Per-claim limit
    • Monthly limit
    • Annual limit
    • Receipt requirements
  3. 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

  1. Go to Benefits
  2. Create benefit
  3. Configure calculation
  4. Assign to employees
  5. Effective from next payroll

Update Claim Limits

  1. Go to Staff Claim Policies
  2. Edit relevant policy
  3. Update limits
  4. Save changes

Configure Year-End Bonus

  1. Go to Extra Incomes
  2. Create/edit bonus type
  3. Set calculation basis
  4. Process in December payroll

Adjust Statutory Rates

  1. Access relevant settings
  2. Update rates per latest regulations
  3. Document effective date
  4. Apply to next payroll

Tips

  1. Test changes - Try configuration changes with test employee first
  2. Document policies - Keep written records of all settings
  3. Stay updated - Monitor for statutory rate changes
  4. Audit regularly - Review configurations annually

See Also

An unhandled error has occurred. Reload X

Rejoining the server...

Rejoin failed... trying again in <span id="components-seconds-to-next-attempt"></span> seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please reload the page.