Onboarding web service process
The web service uses a SOAP
protocol and accepts an XML
string containing the employee details. All data in the web service is validated.
SOAP (Simple Object Access Protocol) is a messaging protocol that allows programs that run on disparate operating systems to communicate using http and xml. It was developed as an intermediate language so applications built on various programming languages could talk easily to each other and avoid the extreme development effort.
Extensible Markup Language (XML) is used for storing and transferring data on the web and in other applications. It’s a versatile tool for encoding and organising data in a way that both humans and machines can comprehend.
The onboarding process comprises:
- data setup of the xml file
- initiation to temporarily load the data
- validation and load of the actual data into EmpowerHR
The following sets of new employee data are available for the onboarding process:
- personal data
- tax and declaration data
- position and pay (remuneration) data
- payment instructions
- long service leave (accruing in days or hours)
- regular transactions
- super fund data
- normal leave allocation
- additional data
- regular allowances
See:
- high-level XML representation for an example of each high-level data category
- onboarding XML structure (file) for the complete structure on which the (detailed) data tables are based
Temporarily load the data
EmpowerHR validates the complete set of data for a new employee before accepting the data load. In some cases, when one set of data is rejected, related sets of data are also rejected.
If, according to transaction rules and field error severity levels the data is acceptable, you can load the validated data while requiring manual validation of pay details before the employee is available to pay functions. In other words, flag the pay details as incomplete so they require manual completion or verification. The installation option called onboarding; manual check of pay required? (obop) is designed for this purpose. If you set this option to:
- y (yes), then EmpowerHR requires a manual check before the new employee is set up for pay
- n (no), then no check is required and the new employee is immediately set up for pay
Re-employments
You can re-employ previously terminated employees by doing the following:
- Set the installation option called allow re-employment via onboarding (orem) to y (yes).
- Update the installation setting called define reemploy move, oper code (obre), where at:
- Character Variable, you enter the movement reason code your organisation uses for re-employments
- Text Variable, you enter the operator code capable of loading any employee and their employment details
How does the orem installation option work?
When an employee is onboarded and the reemployment flag is set to y (yes), EmpowerHR checks the orem installation setting to determine if re-employments are permitted.
Here's what happens according to how orem is set...
| orem installation option = y (yes) |
EmpowerHR checks the employee code (if provided), TFN TFN = Tax File Number If the system finds the employee's record, before onboarding, EmpowerHR cleans up existing data including any currently held information for super fund, payment instructions, and additional data. The data supplied for onboarding is used for the re-employment. All supplied fields override existing data, even when the supplied data is blank. The exception is any fields governed by transaction rules. |
| orem installation option = n (no) | An error occurs for the re-employed individual and they have to be onboarded as a new employee with a new employee number |
How does the obre installation setting work?
The transaction rules for the movement code defined in the installation setting, obre, direct which fields default from the position and which are updated from the data supplied for onboarding.
|
Once you've set these up, see Onboard employee data under Onboard new employees via web service for what happens when you upload a re-employment. |
Onboard new employees via web service
To onboard new employees via web service, generate the XML file and then use your organisation's preferred method to send your request.
To learn about the fields for onboarding, see:
- personal data onboarding fields
- tax and declaration data onboarding fields
- position and pay data onboarding fields
- payment instructions data onboarding fields
- long service leave data onboarding fields
- normal leave data onboarding fields
- regular transactions data onboarding fields
- super fund data onboarding fields
- employee additional data onboarding fields
When the data is onboarded and no errors found, the employee details are successfully loaded.
EmpowerHR displays in the Bulk Take-On/Onboard Error Fix screen, the details of any employees with errors in their onboarded data. From there you can correct the data, after which the employee onboards successfully. See fix onboarding errors for more information.
How EmpowerHR matches re-employment records
| Non-generic TFN |
|
||||||||||||||||||||||||||||||||||||||||
| Generic TFN (e.g. 111111111) |
When a generic TFN is used, the matching works differently because the TFN isn't unique to one person. EmpowerHR relies more on DOB and surname to narrow down the match.
|
Multiple re-employment records with mismatches
© 2023 Fusion5. All rights reserved.