Payroll Runs

The Payroll Runs page controls payroll processing and payslip lifecycle operations.

Runs Index Page

Available Filters

Filter	Description
Branch	Filters by branch.
Status	Technical processing status.
Business Status	Payroll lifecycle status.
Payroll Period	Filters by period.
From	Start date of created-at range.
To	End date of created-at range.

Status Values

• Queued, Processing, Completed, Failed, Cancelled

Business Status Values

• Draft, Calculated, Reviewed, Locked, Posted, Cancelled

Table Columns

• ID
• Period
• Branch
• Status
• Business Status
• Payslips Count
• Created At

Header Actions

• Create Payroll Run

Row Actions

• Show
• Print
• Download
• Export CSV / XLS / XLSX

Create Payroll Run Page

Run Configuration

Option	Purpose
Branch	Branch where run will be generated.
Payroll Period	Must be an open period in selected branch.
Department	Optional filter to limit employees.
Designation(s)	Optional designation filter.
Employee(s)	Optional explicit employee filter.

Filter Behavior

• Department options load after branch selection.
• Designation options load after selecting department.
• Employee options refresh based on selected branch/department/designation filters.

Run Show Page

The run show page includes:

• Run summary (period, branch, status, business status)
• Run-level actions
• Payslip table and payslip-level actions

Run-Level Actions

• Recalculate
• Bulk Approve
• Review
• Return Calculated
• Lock
• Post
• Cancel
• Mark Paid
• Print / Download / Export

Displayed actions depend on current lifecycle state and permissions.

Payslip Table Columns

• Reference ID
• Employee
• Salary Type
• Status
• Gross Amount
• Deductions Amount
• Net Amount
• Employer Cost Amount

Payslip Menu Actions

• View Details
• Print Payslip
• Download Payslip
• Lifecycle actions: Recalculate, Approve, Lock, Mark Paid, Cancel, Void
• Delete (state-restricted and permission-based)

Void Action

• Requires a reason.
• Reason must be at least 3 characters.

Payslip Details Dialog

The details dialog shows:

• Employee and payslip profile
• Gross/deductions/net/employer cost summary
• Payroll lines table (component, type, calculation type, quantity, rate, amount)
• State transition log
• Calculation snapshot JSON