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

  1. Introduction
  2. Setup Order
  3. Payroll Options
  4. Tax Tables
  5. Employee Pay Details
  6. Checking the Setup
  7. 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

  1. Payroll Options — map the GL accounts and enter the SARS references.
  2. Tax Tables — import the table for the tax year and activate it.
  3. Employee Record — enter each employee's tax and pay details.
  4. Payroll Cockpit — fix whatever the checks list.
  5. 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:

Optional — leave blank to leave the item out of the GL entry:

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

Leave and Fringe Benefit Rates

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.

  1. Click Import JSON… and choose the SARS tax table file. A table missing required threshold values is refused.
  2. Select the imported table and click Activate Selected.
  3. 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.