Skip to main content

Payroll & Payslips

Manage payroll types, generate payslips, and handle salary calculations for your staff.

Path: Admin โ†’ HRM โ†’ Payroll URL: admin/hrm/payroll Permission: Administrator only

Overviewโ€‹

The Payroll module provides two main areas:

  1. Payslip โ€“ View and manage payroll tables (monthly payslips)
  2. Payroll Type โ€“ Define salary structures with customizable columns (earnings, deductions, etc.)

Payroll Tabsโ€‹

1. Payslip Tabโ€‹

URL: admin/hrm/payroll or admin/hrm/payroll?group=payslip

Purpose: View and manage payroll tables (monthly payslip runs).

User Flow:

  1. Select a payroll table (month + payroll type)
  2. View the Handsontable grid with staff rows and salary columns
  3. Edit values directly in the grid (if permitted)
  4. Latch the payslip to lock it (prevents further edits)
  5. Staff can download or view their payslips from their profile

Actions:

  • Create new payroll table
  • Edit values in the grid
  • Latch payslip (lock for finalization)
  • Delete payroll table

2. Payroll Type Tabโ€‹

URL: admin/hrm/payroll?group=payroll_type

Purpose: Define payroll types with custom columns (salary components).

User Flow:

  1. Click Add to create a new payroll type
  2. Configure the template with columns:
    • Column title โ€“ Display name (e.g. "Basic Salary", "Transport Allowance")
    • Column key โ€“ Internal identifier
    • Type โ€“ Income or deduction
    • Calculation โ€“ How the value is computed (manual, formula, etc.)
    • Value total โ€“ Default or formula
  3. Save and use this type when creating payroll tables

Fields (per column):

  • Column value
  • Column title
  • Column key
  • Type (income/deduction)
  • Calculation method
  • Value total
  • Description

Payslip Featuresโ€‹

For HR/Adminโ€‹

  • Create payroll tables by month and payroll type
  • Edit salary data in a spreadsheet-like grid (Handsontable)
  • Latch payslips to prevent changes
  • Delete payroll tables if needed

For Staffโ€‹

  • My Payslips tab in staff profile shows available payslips
  • View โ€“ Opens payslip in new tab
  • Download โ€“ Download payslip file
  • View / PDF โ€“ View or print as PDF

Settings Integrationโ€‹

Payroll uses data from Settings โ†’ HRM:

  • Allowance types โ€“ For salary components
  • Salary forms โ€“ Base salary structure
  • Job positions โ€“ For role-based calculations