Payroll

Payroll builds a monthly pay sheet for every active member of staff, applies the deduction and allowance rules you set, and takes the sheet through approval.

For the step-by-step, see Run payroll.

Payroll is a basic module. It takes base salaries from staff records, applies flat or percentage rules, and records approvals. It does not yet follow the hospital’s salary scales, IPPIS, tax tables or payslips.

Screens

Screen	Where	What it is for
Payroll › Payrolls	Menu › Finance	Every monthly payroll with period, status, number of employees, total amount and created date. Filter by status and year.
Payroll › Deductions	Deductions tab	Deduction rules. Filter by scope (Global / Assigned) and period (Always on / Date range).
Payroll › Allowances	Allowances tab	Allowance rules, with the same filters.
Payroll › Tracking	Tracking tab	History of which deductions and allowances were applied to whom.
Create Payroll	Create payroll	Choose the month and year and check the sheet. Save Payroll saves it and starts approvals.
Create Deduction, Create Allowance	The create button on each tab	A new rule.
Payroll details	Select a payroll	The sheet and the Approvals card. Edit and Delete at the top.

Who can use it

Permission	Allows	Held by (UATH roles)
View Payroll	See payrolls, deductions and allowances.	Finance officers, DFA, Billing officers, HR, CMD & executive offices, Head of Audit
Add Payroll	Create payrolls and rules.	Finance officers, DFA, Billing officers
Edit Payroll	Change payrolls and rules.	Finance officers, DFA, Billing officers
Delete Payroll	Remove payrolls and rules.	System administrators
Export payroll	Download payroll runs as CSV.	Finance officers, DFA, Billing officers

Payroll statuses

Draft: Not yet sent for approval.
Pending User Group Head / Pending Admin Head / Pending Accountant: Waiting at that approval level. A new payroll starts at Pending User Group Head.
Approved: Every approver has approved.
Rejected: An approver rejected it at any level.
Processed: Worked through for payment.
Paid: Salaries paid.

Who approves a payroll

When a payroll is saved the suite adds approvers automatically: the head of every unit with staff on the sheet (User Group Head), the first active user whose role is HR manager, administrator or CMD (Admin Head), and the first active accountant or administrator (Accountant). Payroll does not use the hospital’s approval routes, so check the names on the Approvals card before the sheet moves on.

Key fields

Payroll Period: Month and year.
Base Salary: From the staff record; can be changed on the sheet.
Deductions, Allowances: Applied automatically from active rules, with the amounts shown per person.
Net Pay: Base salary plus allowances minus deductions.
Rule: Title, Description: What the rule is called on the sheet.
Rule: Fixed Amount (₦) or Percentage (%): How much it adds or takes.
Rule: Apply to all users (Global) / Assigned Users / Assigned User Groups: Who it applies to.
Rule: Always active (no expiration) / Start Date, End Date: When it applies.