Update employment
BetaChanges data
Changes a contract's position, manager, hours, dates or cost centres.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Personio connection the step signs in with. |
| Employee idRequired | text |
| Employment idRequired | The List employments node gives you the id. |
| Status | "" or "ACTIVE" or "INACTIVE" or "ONBOARDING" or "LEAVE" |
| Employment type | "" or "INTERNAL" or "EXTERNAL" |
| Job title | text |
| Manager id | The Personio person id of the new manager. |
| Office id | text |
| Legal entity id | text |
| Job id | text |
| Start date | text |
| Contract end date | text |
| Probation end date | Personio takes an end date or a length, never both. |
| Probation length in months | Leave at 0 to use the end date above instead. |
| Weekly hours | number |
| Full-time weekly hours | number |
| Departments and teams | Sending these REPLACES the units this contract has. |
| Cost centres | Weights are percentages and must total 100. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `personio`) |
personId | text |
employmentId | text |
status | "" or "ACTIVE" or "INACTIVE" or "ONBOARDING" or "LEAVE" |
type | "" or "INTERNAL" or "EXTERNAL" |
positionTitle | text |
supervisorId | text |
officeId | text |
legalEntityId | text |
jobId | text |
employmentStartDate | text |
contractEndDate | text |
probationEndDate | text |
probationPeriodLength | number, by default 0 |
weeklyWorkingHours | number |
fullTimeWeeklyWorkingHours | number |
orgUnits | list of {type: "department" or "team", id: text}, by default [] |
costCenters | list of {id: text, weight: text}, by default [] |
Output
| Field | Type |
|---|---|
employmentContract, as Personio answered it | object |
updatedPersonio accepted the change | boolean |
Sample output, and the expression for each field
- employment
- id"emp_1"
- updatedtrue
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"connection": "<connection id>",
"contractEndDate": "",
"costCenters": [],
"employmentId": "<employment id>",
"employmentStartDate": "",
"jobId": "",
"legalEntityId": "",
"officeId": "",
"orgUnits": [],
"personId": "<employee id>",
"positionTitle": "",
"probationEndDate": "",
"probationPeriodLength": 0,
"status": "",
"supervisorId": "",
"type": ""
},
"label": "Update employment",
"type": "personio.updateEmployment",
"version": 1
}