This article provides instructions on how to resolve the "error validating employee details: a termination reason must be provided" issue that may occur when syncing employee files between Xero or Employment Hero Payroll classic integrations.
Why Does This Error Occur?
This error typically appears when an employee's profile was terminated before the current payroll integration was set up. The termination reason listed on the employee's file does not match one of the seven Termination Types required by the Australian Taxation Office (ATO) under Single Touch Payroll Phase 2 (STP2) regulations.
How to fix the error
There are 2 ways to fix this error. If the employee's profile no longer needs to sync with payroll, you can unsync it (option 1). Otherwise, you can reactivate and then offboard the employee profile (option 2).
- Click the People menu.
- Click the Employee List submenu.
- Filter by Employee Status.
- Choose to include Terminated employees from the drop-down menu.
- Click the Actions button.
- Click the Re-active Employee button.
- Choose from the following options:
- No, I do not want to trigger onboarding checklists.
- Yes, I want to trigger onboarding checklists.
- Click the Re-Activate button.
- You will then need to offboard the employee again. To do this:
- Click the People menu.
- Click the Employees List submenu.
- Click the Action button next to the employee that needs off-boarding.
- Click the Offboard Employee button.
- Complete the following fields, which can change depending on the type of termination:
- Termination date.
- Termination type.
- Employee access.
- Would you consider this personnel for rehire?
- Payroll cut-off date.
Helpful Hint
The Payroll Cut Off Date field allows you to choose a different time you like the platform to terminate the employee on your payroll platform if it is integrated with the Employment Hero platform. For example, so you can still finish the remaining leave and expense approvals or process your final Pay Run.
- Click the Terminate button.
Explore related content:
- Customise leave balance visibilityThis guide walks you through how to customise your employee's leave balance visibility in your Employment Hero platform.
- Common Xero import conflictsThis section contains a range of error resolution articles that cover common import conflicts our clients run into when syncing their Xero data.