Skip to main content

Payroll Overview

The Payroll module is where compensation is defined, assigned and paid. It is a separate module from Employee (HRMS) — switch via the module switcher in the top bar. Requires payroll:read to view and payroll:manage / payroll:master / payroll:pii for changes.

Payroll dashboardPayroll dashboard
Payroll Dashboard — masters, runs and compliance at a glance

Where things live​

SectionPagesPurpose
EmployeesPayroll Employees, Payroll Attendance, Salary AssignmentDurable payroll identity, attendance that feeds pay, and revision history
Pay RunsAll Runs, AdjustmentsCreate, compute, approve and close runs; post-run corrections; payslips live on their run (/runs/:id/payslips)
StatutoryPF / ESI / PT / TDS, DeclarationsCompliance rates, slabs, wage definitions and Form 12BB review
Loans & ClaimsLoans, ReimbursementsRecovery schedules and claims
AdministrationPay Components, Pay Setup (Pay Groups, Salary Structures), Finance Setup (Bank Profiles, GL Mappings), Activity Logs, Role Permissions, ConfigurationEarning/deduction definitions, CTC costing, who is paid together, disbursement accounts and ledger mappings; audit, access and tenant settings

Pay Setup and Finance Setup each combine two former pages as tabs. Role Permissions and Configuration appear only for users holding payroll:admin.

Permissions at a glance​

PermissionUnlocks
payroll:readView all payroll pages
payroll:masterCreate/edit Pay Components, Salary Structures, Pay Groups, GL Mappings, Statutory configs
payroll:manageCreate pay runs, salary revisions, adjustments, loans/reimbursements
payroll:piiView/edit tax declarations (amounts & regime drive TDS)
payroll:adminRole permissions & configuration

Typical setup order​

  1. Pay Components — earning, deduction and employer-contribution definitions.
  2. Salary Structures — compose components with CTC costing (topological validation).
  3. Pay Groups (Pay Setup) — who is paid together, over what period and pay date; the calendar is inside the group.
  4. Bank Profiles and GL Mappings (Finance Setup) — the account salaries are paid from and the ledger accounts they post to.
  5. Statutory — PF/ESI rates, PT slabs, tax regimes and wage definitions.
  6. Payroll Employees — sync from HRMS or create; verify pay group.
  7. Salary Assignment — assign structure + CTC + effective date (revisions).

Then run payroll monthly via All Runs → New Run → Sync & Compute → Approve → Mark Paid and publish Payslips.