Payroll integration
BambooHR to PayFit integration: new French employees as a collaborator with a contract in PayFit
With an integration between BambooHR and PayFit, a new employee of the French entity in BambooHR becomes a collaborator with a contract in PayFit within minutes, with job title and start date. KoppelHet builds the integration on PayFit's public API, which creates contracts for France.
What the integration does
Organisations with HR in BambooHR and a French entity paid in PayFit move new employees from BambooHR to PayFit by hand.
- KoppelHet creates a webhook on new employees in BambooHR and an API key in PayFit.
- A new French employee becomes a collaborator in PayFit, followed by a contract with job title and start date.
- After a few minutes KoppelHet checks that the contract is in PayFit.
- The payroll administrator completes the contract in PayFit.
What to watch for with BambooHR and PayFit
- PayFit's public API can only create a contract for France. This integration is therefore for a French entity.
- With BambooHR's webhooks a new French employee is in PayFit as a collaborator within minutes, without waiting for a nightly run.
- PayFit wants the address in parts, with house number, first address line, city, postcode and country, while BambooHR stores street and number together in address1. KoppelHet splits off the house number and reports an address that cannot be split unambiguously, instead of guessing.
- The French social security number has fifteen characters in PayFit. BambooHR has no dedicated field for it, only a general nationalId; KoppelHet only sends the number if it has fifteen characters, otherwise payroll fills it in in PayFit.
- PayFit returns a contract created through the API without data, and it only appears after two to five minutes. KoppelHet only reports a new employee as done once the contract can be found in PayFit afterwards.
- BambooHR signs webhooks with a SHA-256 HMAC in the X-BambooHR-Signature header and retries a failed delivery up to five times. KoppelHet checks every signature and also compares the French employees in both systems every day.
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
Can KoppelHet also write salary changes to PayFit in France?
Not in the first version. The integration starts with new employees and their contract; what the API allows after that, we test in your environment.
Do payslips come back into BambooHR?
Not in the first version. That can follow later as an extension.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- KoppelHet reads BambooHR through signed webhooks (X-BambooHR-Signature) and the employees API, and writes to PayFit with POST /companies/{companyId}/collaborators and POST /companies/{companyId}/collaborators/{collaboratorId}/contracts on partner-api.payfit.com.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in BambooHR | Field in PayFit | Notes |
|---|---|---|
firstName, lastName | firstName, lastName | |
homeEmail | personalEmail | Required in PayFit |
address1, city, zipcode, country | personalAddress (streetNumber, addressFirstLine, city, postCode, country) | House number separate in PayFit |
nationalId | socialSecurityNumber | Fifteen characters for France |
jobTitle | jobTitle (contract) | |
hireDate | startDate (contract) |
Related
Ashby → BambooHR
Ashby to BambooHR integration: hire, changed start date and employment status in BambooHR
BambooHR → 4PS Construct
BambooHR to 4PS Construct integration: employees from BambooHR in the 4PS company of their location
BambooHR → Active Directory
BambooHR to Active Directory integration: accounts in your own domain from HR
BambooHR → ADP iHCM
BambooHR to ADP iHCM integration: salary, bonuses and commissions to Dutch payroll