# Pay Run Health Checks During each pay run, users will be notified of all errors and warnings. The errors must be resolved before finalising a pay run. These notifications serve three primary purposes:

Pay run health checks

* **Ensuring Legal Compliance**: Some errors help our customers comply with payroll regulations. This is crucial to avoid legal issues, penalties or incorrect payments. * *Example*: Employee missing an employment start date. This will prevent the employee from being included in the UIF Declaration and also incorrect ETI calculations. * **Identifying Potential Data Issues**: Certain errors and warnings assist users in identifying and resolving issues with the data linked to the payroll, ensuring accuracy and incorrect pay run calculations. * *Example*: Employees are terminated and their leave pay-outs have been scheduled, but leave has not been configured in this pay run. This ensures all leave-related payments are correctly processed. * **Providing Informational Messages**: Informational messages highlight noteworthy points that may not require immediate action but could be important for review before finalising the pay run. ## Pay Run Health Errors All errors will **prevent you** from finalising a pay run. This is to ensure that all payroll calculations are correct and that all information is legally compliant. ### Employees scheduled for resignation but leave pay out not configured

Leave not configured

Employees in the current pay run are scheduled for resignation and they have pending leave pay outs but the leave pay out is not configured in the pay run settings. This is essential to make sure that the leave payout is configured correctly. To resolve this issue: * [Configure leave pay out in the pay run settings](/modules/payroll/recurring-pay-runs/pay-run-settings.md#leave-configuration) ### Employees have missing or incomplete personal information

Missing personal information

Employees have missing or incomplete personal information that may prevent incorrect statutory deductions or monthly filing submissions. It is important to make sure that the status of each employee's statutory deductions / contributions (**UIF**, **PAYE** and **ETI**.) are set. To resolve this issue you can edit the information: * [Bulk edit employee personal information](/modules/payroll/employee-information.md#bulk-edit-upload-information) and select "**Export Pay Run Errors**" * If employees do not contribute to any of the statutory deductions, set them to **FALSE** in the corresponding columns on the sheet * [Change information for a single employee](/modules/payroll/employee-information.md#edit-employee-personal-information) * If employees do not contribute to one of the statutory deductions, set them to **No** in the form under the **Tax details section** ### ETI is enabled for employees in this pay run but not configured correctly

ETI not configured

Employees are enabled for ETI but ETI configuration is not set up for the current pay run. To resolve this issue: * [Configure ETI in the pay run settings](/modules/payroll/recurring-pay-runs/pay-run-settings.md#eti-config) ### Incomplete Company Configuration

Company details missing

Company details linked to this pay run are not complete. To resolve this issue: * [Configure Employer Information](/modules/payroll/employer-information.md#employer-details) ### Employees are not active in the current pay run

Employees not active

Employee has one of the following issues: 1. End dates are **before** the start of the current pay run, or their start dates are **after** the end of the current pay run. To resolve this issue: * If the employee is currently inactive, [remove them from the current pay run](/modules/payroll/recurring-pay-runs/current-pay-run.md#add-or-remove-employees-from-a-pay-run). * If the employee was active in the past, but have been re-enrolled, create a new active period: * [Create active period for a single employee](/modules/payroll/recurring-pay-runs/employee-pay-run-view.md#active-periods) * [Create active periods for multiple employees](/modules/payroll/employee-information.md#bulk-edit-upload-information) * Add employee start dates to the column and import 2. These employees currently **do not** have a start date of employment. To resolve this issue: * If the employee is still active, create a new active period for this employee: * [Create active period for a single employee](/modules/payroll/recurring-pay-runs/employee-pay-run-view.md#active-periods) * [Create active periods for multiple employees](/modules/payroll/employee-information.md#bulk-edit-upload-information) * Provide a start date in the "**Employment Start Date**" column in the exported sheet * If this employee is not active, remove them from the pay run and resign them: * [Remove from the current pay run](/modules/payroll/recurring-pay-runs/current-pay-run.md#add-or-remove-employees-from-a-pay-run) * [Resign employee](/fundamentals/users-and-employees/employee-resignation.md) ### Employees active periods do not match pay run company

Pay run error

The company linked to the active periods for these employees does not match the company assigned to the pay run. Since the company for the pay run is configured during its creation, it cannot be changed afterward. To resolve this issue: * If the company linked to the active period is incorrect, follow these steps to edit the company: [Employee Pay Run View](/modules/payroll/recurring-pay-runs/employee-pay-run-view.md#editing-active-periods) * If the employee is assigned to the wrong pay run, remove them from the current pay run and add them to the correct one: [Current Pay Run](/modules/payroll/recurring-pay-runs/current-pay-run.md#add-or-remove-employees-from-a-pay-run) ## Pay Run Health Warnings While you can still finalise a pay run when warnings are present, it is highly advisable to ensure they are expected, as they will impact the calculation of each affected employee’s wages. ### Employees scheduled for resignation in this pay run

Scheduled for resignation

These employees have been scheduled for resignation. If they have leave balances, that will also be paid out in this pay run. All these employees will not be in the next pay run. If employees have been scheduled for resignation incorrectly, follow these steps to cancel the resignation: [Revert Resignation](/fundamentals/users-and-employees/employee-resignation.md#revert-resignation). ### Employees with negative sick leave balances

Negative sick leave

Employees will incur negative leave balances if more leave is captured on the Employee Overview Report than is available. To edit captured leave: [Leave Data Review](https://app.allwage.com/#/review/employee/leave). ### Employees with negative annual leave balances

Negative annual leave

Employees will incur negative leave balances if more leave is captured on the Employee Overview Report than is available. To edit captured leave: [Leave Data Review](https://app.allwage.com/#/review/employee/leave). ### Employees with unusual earnings detected

Unusual earnings

Employees have earnings that are significantly higher or lower than the average for their group. This can be caused by employees that are either inactive, or configured incorrectly. * [Remove ](/modules/payroll/recurring-pay-runs/current-pay-run.md#add-or-remove-employees-from-a-pay-run)and [resign](/fundamentals/users-and-employees/employee-resignation.md#steps-to-terminate-employees) employees if they are inactive ### Employees are earning R0 or less

Earnings zero or less

Employees have earnings that are significantly higher or lower than the average for their group. This can be caused by employees that are either inactive, or configured incorrectly. * [Remove ](/modules/payroll/recurring-pay-runs/current-pay-run.md#add-or-remove-employees-from-a-pay-run)and [resign](/fundamentals/users-and-employees/employee-resignation.md#steps-to-terminate-employees) employees if they are inactive ### Employees with missing clock ins

Missing clock ins

These employees have clocked out but there is no clock in for the day. No hours will be calculated. To resolve this issue: * Navigate to the [Employee Overview Report](broken://pages/FEX8WfOmHJzvfe6Dt9RT#exception-filter) and fix the exceptions. ### Employees with missing clock outs

Missing clock outs

These employees have clocked in but there is no clock out for the day. No hours will be calculated. To resolve this issue: * Navigate to the [Employee Overview Report](broken://pages/FEX8WfOmHJzvfe6Dt9RT#exception-filter) and fix the exceptions. ### Employees with missing clock templates
Employees have clocked in on a day but there is no configured clock template for that day. To resolve this issue: * Make sure the employee is allocated to a [team](/fundamentals/users-and-employees/employees.md#bulk-manage-employee-details), and that team is [linked](/modules/time-and-attendance/configuration.md#assigning-teams) to a clock template. * Make sure the [clock template](/modules/time-and-attendance/configuration.md#days-of-the-week) is configured for each day of the week. ### Employees have present days with overlapping leave

Overlapping days with leave

Employees have clocked in on a day and it overlaps with their captured leave. To resolve this issue: * Edit the [leave](https://app.allwage.com/#/review/employee/leave) that was captured for that employee. * [Override their hours](/modules/time-and-attendance/reports/employee-overview.md#overrides) if a partial leave day was captured. ### Employees present but not assigned any open pay run

Employees not on a pay run

When employees are loaded into AllWage, they can start clocking in immediately; however, to be paid, they first need to be added to a pay run. This notification alerts you to any employees who were active during the pay run period but are not currently included in a pay run. To resolve this issue: * If the employees are not supposed to be clocking in, [resign ](/fundamentals/users-and-employees/employee-resignation.md#steps-to-terminate-employees)them immediately. * If the employees are active, [add them to a pay run](/modules/payroll/recurring-pay-runs/current-pay-run.md#add-or-remove-employees-from-a-pay-run) to ensure they get paid. ### Employees with unauthorised leave Employees have leave records that haven't been approved yet. Each leave type with unapproved records generates a separate warning. How to resolve: 1. Click "View Employee Overview" to see affected employees and dates 2. For each leave record:\ \- Approve the leave → Change status from unapproved to approved\ \- Make it unpaid → Change leave type to unpaid leave\ \- Remove it → Delete the leave record entirely Prevention: Ensure all leave is approved before finalising pay runs. ### PAYE Earnings Under Threshold This error indicates that an employee is currently paying PAYE but is earning less than the weekly, fortnightly, or monthly threshold. To resolve this issue please refer to this section: * [Reasons for Unexpected PAYE Values](/modules/payroll/filing/statutory-deductions.md#reasons-for-unexpected-paye-values). ### Tax Code Issues #### Medical Aid Tax Codes Validation * **Medical aid tax credit (4116) requires either employee medical aid deduction (4005) or employer medical aid fringe benefit (3810)** * If a medical aid tax credit is declared, there must also be either an employee medical aid deduction or an employer medical aid fringe benefit. * **Employer medical aid contribution (4474) requires matching employer medical aid fringe benefit (3810)** * If an employer medical aid contribution is declared, a matching fringe benefit must also be declared. * **Employer medical aid fringe benefit (3810) requires matching employer medical aid contribution (4474)** * If an employer medical aid fringe benefit is declared, a matching employer medical aid contribution must also be declared. * **Employer medical aid contribution (4474) does not match employer medical aid fringe benefit (3810)** * The values for the employer medical aid contribution and fringe benefit do not match. #### Provident Fund Tax Codes Validation * Employer provident fund contribution (4473) requires employer provident fund fringe benefit (3825) * If an employer provident fund contribution is declared, a matching fringe benefit must also be declared. * Employer provident fund fringe benefit (3825) requires employer provident fund contribution (4473) * If an employer provident fund fringe benefit is declared, a matching employer provident fund contribution must also be declared. * Employer provident fund fringe benefit (3825) is greater than employer provident fund contribution (4473) * The value for the employer provident fund fringe benefit is greater than that for the employer provident fund contribution. #### Pension Fund Tax Codes Validation * Employer pension fund contribution (4472) requires employer pension fund fringe benefit (3817) * If an employer pension fund contribution is declared, a matching fringe benefit must also be declared. * Employer pension fund fringe benefit (3817) requires employer pension fund contribution (4472) * If an employer pension fund fringe benefit is declared, a matching employer pension fund contribution must also be declared. * Employer pension fund fringe benefit (3817) is greater than employer pension fund contribution (4472) * The value for the employer pension fund fringe benefit is greater than that for the employer pension fund contribution. #### Retirement Annuity Tax Codes Validation * Employer retirement annuity contribution (4475) requires matching employer retirement annuity fringe benefit (3828) * If an employer retirement annuity contribution is declared, a matching fringe benefit must also be declared. * Employer retirement annuity fringe benefit (3828) requires matching employer retirement annuity contribution (4475) * If an employer retirement annuity fringe benefit is declared, a matching employer retirement annuity contribution must also be declared. * Employer retirement annuity contribution (4475) does not match employer retirement annuity fringe benefit (3828) * The values for the employer retirement annuity contribution and fringe benefit do not match. #### Travel Allowance Tax Codes Validation * Travel allowance (3701) requires travel allowance fringe benefit (4582) * If a travel allowance is declared, a matching fringe benefit must also be declared. * Travel allowance fringe benefit (4582) is less than 20% of travel allowance (3701) * The travel allowance fringe benefit is less than 20% of the declared travel allowance. * Travel allowance fringe benefit (4582) is more than 80% of travel allowance (3701) * The travel allowance fringe benefit is more than 80% of the declared travel allowance. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.allwage.com/modules/payroll/recurring-pay-runs/pay-run-health-checks.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.