Payroll Configuration — User Manual
Audience: Payroll administrators, practice managers, HR managers
Version: 1.1 — November 2026
Modules: Mod-Payroll-UI (Payroll Options, Employee Record, Payroll Cockpit), Mod-Payroll-Config (Tax Tables)
Table of Contents
- Introduction
- Setup Order
- Payroll Options
- Tax Tables
- Employee Pay Details
- Checking the Setup
- Troubleshooting
1. Introduction
Before the first payrun, payroll needs four things set up: the general ledger accounts payroll posts to, the employer's SARS details, an active tax table for the tax year, and each employee's pay details. The screens are under Accounting → Payroll:
| Menu | Screen |
|---|---|
| Payroll Processing → Payroll Options | GL accounts, SARS references, calculation parameters, leave and fringe benefit rates |
| Payroll Processing → Tax Tables | Import and activate the SARS tax table |
| Payroll Processing → Payroll Cockpit | Readiness checks (Section 6) |
| Employee Records → Employee Record | An employee's pay, tax, leave and benefits |
2. Setup Order
- Payroll Options — map the GL accounts and enter the SARS references.
- Tax Tables — import the table for the tax year and activate it.
- Employee Record — enter each employee's tax and pay details.
- Payroll Cockpit — fix whatever the checks list.
- Create the first payrun in the Payrun Workspace.
3. Payroll Options
Open Payroll Options. Change the values and click Save Settings; Reload discards unsaved changes. Negative values are refused.
GL Account Mappings
Required — posting a payrun fails if any is blank:
- Salary & Wages Expense
- UIF Employer Expense
- SDL Expense
- Net Salaries Payable
- PAYE Payable — SARS
- UIF Payable — SARS
- SDL Payable — SARS
Optional — leave blank to leave the item out of the GL entry:
- Medical Aid Payable
- Retirement Fund Payable
- Other Deductions Payable
- ETI Government Incentive Income
- Employer Retirement Contribution Expense
- Termination Lump Sum Expense
SARS Registration Details
Employer Trading Name, Employer Address, PAYE Reference Number, UIF Reference Number and SDL Reference Number. These appear on SARS outputs and certificates.
Calculation Parameters
- SDL Enabled — Skills Development Levy applies when annual payroll is over R500,000.
- ETI Enabled — Employment Tax Incentive.
- Payroll Periods Per Year — 12 for monthly.
Leave and Fringe Benefit Rates
- Annual leave: default leave days per year (the legal minimum is 15 working days) and the working days per month used to value a day of leave (21.67).
- Fringe benefits: the motor vehicle monthly percentage (and with a maintenance plan), the fuel and maintenance reductions, the official rate of interest for staff loans, and the loan balance with no taxable benefit.
A benefit rate that is blank is treated as not configured: employees with that benefit are skipped and the validation blocks payroll, rather than under-taxing them. Ask your accountant for the correct SARS rates.
4. Tax Tables
Open Tax Tables. The list shows the tables for the current tax year, with the active one marked.
- Click Import JSON… and choose the SARS tax table file. A table missing required threshold values is refused.
- Select the imported table and click Activate Selected.
- Confirm. Activating a table deactivates all other tables for that tax year.
Payroll cannot be calculated for a year with no active table. A placeholder or out-of-date table is reported by the checks in Section 6. Payruns already calculated keep the table they used.
5. Employee Pay Details
Open the Employee Record. The tabs are Personal, Tax, Pay & Allow., Compliance, Banking, History, Leave, Benefits, Emergency Contacts and Documents.
On Pay & Allow. you enter earnings (basic salary, housing, travel and other allowances), medical aid, retirement fund and other deductions, and the contractual full-period hours used for the National Minimum Wage check. A per-km rate may be set for reimbursive travel. Pay is kept as a dated history: each change has an effective date, and Salary history lists earlier amounts with who recorded them and when.
The Leave tab shows the employee's leave balance and the Benefits tab records fringe benefits. The readiness rail at the side of the record shows what is still missing.
6. Checking the Setup
The Payroll Cockpit runs the payroll checks. Each problem is listed as either blocking (payroll cannot proceed) or a warning, and many have a → Fix link that takes you to the place to correct it. The checks include a missing or placeholder tax table, missing GL mappings and incomplete employee records.
The Submissions Hub also shows a banner with the active tax table, or a warning if there is none.
7. Troubleshooting
Q: "No active tax table for …"
A: Import the table for that tax year and activate it (Section 4).
Q: Posting a payrun fails on a GL account.
A: One of the required GL mappings in Payroll Options is blank or points to an inactive account. Fix it and save.
Q: I imported a tax table but payroll still uses the old one.
A: An imported table is not used until you activate it.
Q: A fringe benefit employee is skipped.
A: The rate for that benefit in Payroll Options is blank. Enter it.
Q: Who can change payroll settings?
A: Users with payroll administration permission. Ask your system administrator.