FlowmageDocs

Update employment

BetaChanges data

Changes a contract's position, manager, hours, dates or cost centres.

Settings

SettingWhat it is
ConnectionRequiredThe Personio connection the step signs in with.
Employee idRequiredtext
Employment idRequiredThe List employments node gives you the id.
Status"" or "ACTIVE" or "INACTIVE" or "ONBOARDING" or "LEAVE"
Employment type"" or "INTERNAL" or "EXTERNAL"
Job titletext
Manager idThe Personio person id of the new manager.
Office idtext
Legal entity idtext
Job idtext
Start datetext
Contract end datetext
Probation end datePersonio takes an end date or a length, never both.
Probation length in monthsLeave at 0 to use the end date above instead.
Weekly hoursnumber
Full-time weekly hoursnumber
Departments and teamsSending these REPLACES the units this contract has.
Cost centresWeights are percentages and must total 100.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `personio`)
personIdtext
employmentIdtext
status"" or "ACTIVE" or "INACTIVE" or "ONBOARDING" or "LEAVE"
type"" or "INTERNAL" or "EXTERNAL"
positionTitletext
supervisorIdtext
officeIdtext
legalEntityIdtext
jobIdtext
employmentStartDatetext
contractEndDatetext
probationEndDatetext
probationPeriodLengthnumber, by default 0
weeklyWorkingHoursnumber
fullTimeWeeklyWorkingHoursnumber
orgUnitslist of {type: "department" or "team", id: text}, by default []
costCenterslist of {id: text, weight: text}, by default []

Output

FieldType
employmentContract, as Personio answered itobject
updatedPersonio accepted the changeboolean
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
}