Personio integration

Setting up your integration with Personio

downloads.intercomcdn.comio3104263780b19da8e2bc90a6d654883e8Premium

Adding the integration

To add a Personio integration in your Shiftbase account head towards Settings > App center > Personio. Then click on the green + Add Personio integration.

Then you can log in with your Client ID and Client secret. This data can be retrieved from your Personio account. They are linked to the created API token within Personio. The minimum required permissions of the API within Personio are:

  • Employees (Read)

Once the Client ID and Client secret have been entered, the configuration screen appears. 

Here you give the integration a name. Under Contract fields you can specify which contract fields you want to synchronise. Here you have the following options:

  • Function
  • Enddates
  • Contract hours
  • Wages

Under Employee fields, you can indicate which employee fields you wish to synchronise. Here you have the option to add a date of birth.

By ticking the Automatically add new employees box, new staff from Personio will also be added to Shiftbase during the nightly synchronisation.

Next is the field Notify import email address. The email address you enter here will receive email notifications when a change is transferred from Personio to Shiftbase. Finally click on Save.

Mapping the integration

Next you will see the settings for the integration. Here you will find the following 3 tabs:

  • Contract departments
  • Contract types
  • Employees

Contract departments

First you get to Contract departments. Here you can link the cost centres or departments within Personio to a department within Shiftbase. This can be done using a drop down menu. When you have linked the cost centers or departments you click on Save at the bottom.

Contract types

Next you can go to the second tab Contract types. Here you link the contract types from Personio and Shiftbase. First you have the External contract types. Here you link the contract types as known in Personio with the contract types within Shiftbase.

👀 Example:

Hourly employee links to Flex hours.
Fixed hours links to Fixed hours.

Next you have the Internal contract types. Here you link the contract types as known in Shiftbase with the contract types within Personio.

👀 Example:

Flex hours links to Hourly employee.
Fixed hours links to Fixed hours.

When you have linked the contract types, click on Save at the bottom.

Employees

Next, it is important to link all employees that need to be linked to your account from Personio. We automatically try for every (active) employee to find a matching employee within your account. 

If no match can be found, the employee is automatically set to add. The match is made based on e-mail address and/or SSN. You can find your Personio employees in 4 categories:

  • Unmapped employees: the employees that are not yet linked and can be added.
  • Mapped employees: the employees that are already linked to an employee within your account.
  • Excluded employees: employees for whom it has been indicated/detected that they should not be imported, this can be done manually for a specific employee but also automatically using the settings for contract departments/contract types.
  • Inactive employees: All employees who are already out of employment, by default this group is hidden. You can show these employees with the black button on the right.

When the employees are linked, click on Save at the bottom.

Once everything has been processed, a synchronisation will take place every night. Here, linked employees are updated and new employees are added, if desired.

Active app overview

If you want to make changes at a later date, you can do so by going to Settings > App center > Personio.
In the active app overview you can see 4 symbols. These are as follows:

  • Gearwheel: This opens the configuration window.
  • Squared arrows: This leads to the mapping of the integration.
  • Recycle bin icon: This deactivates the integration.
  • Download icon: This triggers the synchronisation process that normally happens at night.

downloads.intercomcdn.comio30174041182997f72b47386cf481a4dd1HC+-+YouTube+Footer+EN