/payroll/preview
📷 Screenshot: the preview page with the employee and period pickers and the computed slip below — to be added.
Multi-business: the preview is scoped to the business in your switcher. You can only preview employees in the business you are currently pointed at — the system refuses to compute a slip for an employee in another business.
What you choose
The Preview slip button stays disabled until both an employee and a period are selected. Changing either selection clears the previous result so you never see a stale slip.
What you get back
When the slip can be computed, the preview shows the same breakdown a real run would produce:- Base salary, payment days and total working days for the period
- Earnings — each component (code, label, amount), with statutory items flagged
- Deductions — each component, including PAYE / NSSF / LST where they apply
- Employer contributions — employer-side costs (e.g. employer NSSF) that don’t reduce take-home but are part of the cost of employment
- Totals — gross pay, total deductions, total employer contributions and net pay
- Tax breakup (where income tax applies) — the projected annual taxable amount, tax already deducted in the year to date, this month’s PAYE and the income tax effective for the period
When a slip can’t be computed
Instead of an error, the preview tells you why it was skipped:Permissions
Because the preview only reads and computes — it never writes — viewing access (
payroll:read) is all that is needed. There is no approve or write step here.
Behind the scenes — the accounting
Nothing. The preview is a pure calculation. It does not post a journal entry, does not create a payslip, and does not create a run. The ledger is only touched when a real run is approved and paid — see Running payroll → Behind the scenes.Related
- Running payroll — turn the computation into a real, posted run
- Payslips — the per-employee output of a run
- Salary structures — what the preview computes from
- Income-tax slabs — the PAYE bands applied in the tax breakup
- Payroll overview — the whole chain