Payroll integration
Personio to PayFit integration: payslips from PayFit back in Personio
With an integration between Personio and PayFit, the payslips from PayFit reach the employee in Personio as a document after every pay period. KoppelHet fetches them through the PayFit API and puts them in a fixed document category, so employees see them in their own profile.
What the integration does
Organisations that record HR in Personio and process payroll in PayFit have the payslip only in PayFit, while employees look for their documents in Personio.
- KoppelHet gets an API key from PayFit and API credentials in Personio.
- Payroll runs payroll in PayFit and closes the period.
- After the run KoppelHet fetches the payslips and puts them in the right document category on the employee in Personio.
What to watch for with Personio and PayFit
- KoppelHet fetches the payslips with PayFit's payslip endpoints and uploads them to Personio in a fixed document category, which employees see in their own profile.
- Uploading documents in Personio goes through an endpoint limited to 60 requests per minute and files up to 30 MB. After a run with many payslips KoppelHet spreads the uploads over several minutes instead of sending them all at once.
- KoppelHet does not match a PayFit collaborator to a Personio person on email. PayFit stores the personal address and Personio the work address, so matching on email would fail.
- PayFit has a matricule field per collaborator, intended as an own ID for linking to other software. If payroll records the Personio ID there, KoppelHet uses it as the key. Otherwise we match once at the start on first and last name, have payroll confirm doubtful cases and store the pair.
- PayFit returns a payroll status per month, completed or not_completed, with the time the last run finished. KoppelHet requests that status and only fetches payslips once the month is completed, so no provisional payslip reaches Personio.
- In PayFit a payslip belongs to a contract, with year and month as separate text. Someone with two contracts in one month gets two payslips. KoppelHet puts the contract in the document title and the first day of the pay month in Personio's date field.
- Personio can list the documents in a category per employee, filtered by creation date. Before KoppelHet uploads a payslip, it checks whether that month is already in the category. A second run in the same month therefore does not produce a duplicate payslip.
How we build and run it
- The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
- Every sync and every error is visible in the functional log; on an error your administrator is notified.
- A change that cannot go through is not half-applied but queued for another attempt.
- KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
- After go-live we manage the integration and adjust it when your process changes.
- The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.
Implementation and price
This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.
A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.
Frequently asked questions
Where do employees see their payslip?
In Personio, in the fixed document category in their own profile.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- KoppelHet reads payslips with GET /companies/{companyId}/collaborators/{collaboratorId}/payslips and the payslip by ID on partner-api.payfit.com (customer API key), and writes them to Personio with POST /company/documents on a category from /company/document-categories.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Personio | Field in PayFit | Notes |
|---|---|---|
PayFit-collaborator | Personio-persoon | Not matched on email |
PayFit-loonstrook (PDF) | Document in Personio | With a fixed document category |
matricule | employee_id | When payroll records the Personio ID in PayFit |
year en month van de loonstrook | date | First day of the pay month |
year, month en contractId | title | At most 255 characters |
Related
Ashby → Personio
Ashby to Personio integration: hires with hours and entity as new employees in Personio
Bullhorn → Personio
Bullhorn to Personio integration: placements as a person with employment in Personio
Carerix → Personio
Carerix to Personio integration: successful placement as a new employee in Personio
Greenhouse → Personio
Greenhouse to Personio integration: hired candidates as employees in Personio