https://github.com/tools4everbv/helloid-conn-prov-source-personio

HR System personio.de
https://github.com/tools4everbv/helloid-conn-prov-source-personio

hrm on-premises provisioning source

Last synced: 4 days ago
JSON representation

HR System personio.de

• Host: GitHub
• URL: https://github.com/tools4everbv/helloid-conn-prov-source-personio
• Owner: Tools4everBV
• Created: 2021-04-22T13:44:11.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-24T11:07:39.000Z (21 days ago)
• Last Synced: 2024-10-25T07:32:36.268Z (21 days ago)
• Topics: hrm, on-premises, provisioning, source
• Language: PowerShell
• Homepage:
• Size: 63.5 KB
• Stars: 0
• Watchers: 5
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# HelloID-Conn-Prov-Source-Personio

| :information_source: Information |

|:---------------------------|

| This repository contains the connector and configuration code only. The implementer is responsible to acquire the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements.       |






  






HR System personio.de

## Introduction

This connector retrieves HR data from the Personio API. You need to allow some field the API is allowed to access in Personio

| :information_source: License Information |

|:---------------------------|

| To use the Personio API you now need to have the Professional or Enterprise license. If you don't you have to use a CSV. You can use the "Automation Plus" License to automate the export       |

# Personio API Documentation

[https://developer.personio.de/reference#employees-1](https://developer.personio.de/reference/get_company-employees)

## Getting started

To Start with the sync you need to get your API Credentials from: https://.personio.de/configuration/api/credentials

Also you need to select the Fields you want to use: https://.personio.de/configuration/api/access

Required Fields are: First name, Last name, Hire date, Termination date (or some variant), Department, Employee ID

### Configuration Settings

Use the configuration.json in the Source Connector on "Custom connector configuration". You can use the created credentials on the Configuration Tab to set the ClientID and ClienSecret and your Client Domain in Upper Case Letters without dashes.

### Mappings

Use the personMapping_employment.json and contractMapping_employment.json Mappings as example and remove the Fields you didn't select on the Personio Api Access Page

# HelloID Docs

The official HelloID documentation can be found at: https://docs.helloid.com/