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"
}
}
]
}