Job transfer refers to the lateral movement of an employee from one job to another without a change in pay, responsibility, or status. The employee may be moved to a different workgroup, office, or organizational division as part of this process. The process for starting a job transfer via API calls will be covered in detail in this guide.
The method is POST, and the API Endpoint we will be using to transfer the job is:
https://{{hostname}}/api/v1/timekeeping/punches/import
There are a few mandatory body parameters:
- PunchDateTime: The clock-in time and date.
- Employee ID: Employeeโs unique ID.
- Transfer String: The organizational structure of the job that the employee wants to transfer to. This transfer string can be found inside a business structure.
With this mandatory information, simply send the request, and the transfer will be completed, providing you with a response.
The body Parameter is-
"accrualValidationRequired": true,
ย ย "managerRole": true,
ย ย "options": {
ย ย ย ย "accrualValidationOptimization": true
ย ย },
ย ย "punches": [
ย ย ย ย {
ย ย ย ย ย ย "punchDtm" : "2024-02-05T11:55:00",
ย ย ย ย ย ย "employee": {
ย ย ย ย ย ย ย ย "qualifier": "S4029"
ย ย ย ย ย ย },
ย ย ย ย ย ย "hasComments": false,
ย ย ย ย ย ย "transfer": {
ย ย ย ย ย ย ย ย ย ย "transferString":"UKG/Location-1/123th st/Manager"
ย ย ย ย ย ย }
ย ย ย ย }
ย ย ]
}
