/payroll
📷 Screenshot: the Payroll runs list with the year/status filters and the “New Payroll” button — to be added.
Hitaji 360 is multi-business. Salary components, structures, periods, tax slabs, runs and payslips all belong to one business (and its accounting book). Before you set anything up or run payroll, confirm the correct business is selected in the business switcher at the top of the app — payroll posts real money and real journal entries into whichever book you are pointed at.
The payroll chain, end to end
Payroll in Hitaji 360 runs through a fixed sequence. Each link feeds the next:- Salary components — the building blocks: individual earnings (basic, allowances, bonuses) and deductions (loan repayments, voluntary contributions), plus the statutory items (PAYE, NSSF, LST) that the system computes for you. See Salary components.
- Salary structures — reusable templates that combine components into a complete pay package, with formulas where amounts depend on other values. See Salary structures.
- Assignment — a structure is assigned to an employee’s contract from a given date, with that employee’s base pay. The active assignment is what makes an employee appear in a run. See Salary structures → Assigning a structure.
- Payroll period — the pay cycle (e.g. “May 2026”) that a run is for. See Payroll periods.
- Income-tax slabs — the PAYE bands used to compute income tax during a run. See Income-tax slabs.
- Payroll run — for one period you create, generate (compute slips), then submit/approve (this posts the accrual to the ledger). See Running payroll.
- Payslips — the per-employee breakdown of gross, deductions and net pay produced by the run. See Payslips.
- Payment — you record the cash going out (in full or in instalments), reducing what you owe each employee.
- Statutory remittance — the PAYE, NSSF and LST withheld are paid over to the authorities (URA, NSSF).
- General ledger — every step above writes balanced double-entry journal entries so your accounts always reflect payroll.
A quick map of the module
The setup pages (components, structures, periods, tax slabs, settings) live under Settings → ERP → Finance. The old /payroll/setup/... links still work — they redirect to the settings location.
Who can do what — payroll permissions
Every action is gated by a permission slug on your role. The four payroll slugs you will meet across these pages:
There is also
payroll:period-reopen for the higher-risk action of reopening a closed period (typically HR managers and SuperAdmins only).
The split between payroll:write (the maker who prepares a run) and payroll:approve (the checker who approves it) is deliberate separation of duties — ideally two different people.
How statutory deductions work (read this once)
A common point of confusion: you do not enter the amount or formula for PAYE, NSSF or LST. These are statutory items. When you mark a salary component as statutory you simply tell the system which kind it is (PAYE / NSSF / LST), and the figures are computed at run time by the statutory engine using the income-tax slabs and the configured NSSF rates for the period. In the salary structure builder these appear as read-only “auto-calculated” pills — there is no amount box to fill in, and the system will reject any attempt to put one there. This keeps statutory maths consistent and audit-safe across every employee. See Salary components and Income-tax slabs for the detail.Behind the scenes — payroll and your books
Payroll is not just an HR activity; it moves real money and posts to the general ledger at two distinct moments:- When a run is submitted/approved, Hitaji 360 posts a salary accrual — it recognises the wage expense and the liabilities you now owe (net pay to employees, PAYE/NSSF/LST to the authorities).
- When you record a payment, it posts the cash going out, clearing the net-pay liability.
Related
- Running payroll — create, generate, approve and pay a run
- Salary components — the earnings and deductions
- Salary structures — pay templates and assignment
- Payroll periods — pay cycles
- Income-tax slabs — PAYE bands
- Payslips — the per-employee breakdown
- Employment records & contracts — where assignments attach