Payroll koppeling
Deel PayFit koppeling: werknemers van de eigen Franse entiteit uit Deel als collaborator in PayFit
Een koppeling tussen Deel en PayFit maakt werknemers van de eigen Franse entiteit uit Deel aan als collaborator met contract in PayFit, met naam, privé-e-mail, adres, functietitel en startdatum. Contractors en EOR-medewerkers in Deel gaan niet naar PayFit, omdat Deel die zelf betaalt.
Wat de koppeling doet
Organisaties die Deel gebruiken voor contractors, EOR en HR, en de eigen Franse vennootschap in PayFit verlonen, maken een nieuwe Franse werknemer eerst in Deel aan. Daarna voert iemand dezelfde naam, het adres en de startdatum nog eens in PayFit in.
- KoppelHet krijgt een token voor de Deel-API en een API-key van PayFit.
- Bij een ondertekende melding van Deel controleert KoppelHet hiring type en rechtspersoon.
- Een eigen Franse werknemer wordt een collaborator in PayFit, gevolgd door een contract.
- Het loon uit Deel gaat als taak naar de payrollbeheerder, die het contract in PayFit afmaakt.
- Elke dag vergelijkt KoppelHet de Franse werknemers in Deel met de collaborators in PayFit.
Waar je op let bij Deel en PayFit
- In Deel staan contractors, EOR-medewerkers en eigen werknemers in één lijst. KoppelHet neemt alleen de hiring types voor eigen werknemers en alleen de Franse client legal entity, zodat iemand die Deel als EOR in Frankrijk verloont niet ook nog in PayFit komt.
- Een contract via de API kan PayFit alleen voor Frankrijk aanmaken; Spanje en het Verenigd Koninkrijk volgen volgens PayFit later. Heeft de organisatie ook een Spaanse entiteit in PayFit, dan maakt KoppelHet daar alleen de collaborator aan en vult payroll het contract in.
- Het Franse sociale-zekerheidsnummer van vijftien tekens geeft Deel alleen terug als een feature flag voor de organisatie aanstaat en de aanvraag persoonsgegevens niet afschermt. Zonder die instelling vult payroll het nummer in PayFit in; KoppelHet stuurt dan geen leeg of half nummer.
- Voor een contract vraagt PayFit alleen functietitel en startdatum. Het loon uit Deel, een bedrag met schaal en valuta, zet KoppelHet daarom als taak bij de payrollbeheerder, met een controle dat de valuta euro is.
- PayFit geeft een nieuw contract terug zonder gegevens, en het verschijnt pas na twee tot vijf minuten. KoppelHet zoekt het daarna op en meldt de werknemer pas als klaar als het contract er staat.
- Gaat een medewerker over van EOR via Deel naar de eigen Franse vennootschap, dan is dat in Deel een nieuw dienstverband. In PayFit wordt dat een nieuwe collaborator met de nieuwe startdatum; de EOR-periode heeft Deel al betaald.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Waarom niet Deel voor de Franse payroll gebruiken?
Dat kan, en dan vervalt deze koppeling. Deze pagina is voor organisaties die PayFit houden.
Gaan verlof en vertrek ook mee?
Niet in de eerste versie. Die kunnen later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Deel via de REST API (GET people met hiring_types en employments met client_legal_entity, start_date, payment en country; additional_details alleen met feature flag) en ondertekende webhooks.
- PayFit via partner-api.payfit.com met een API-key - POST /companies/{companyId}/collaborators en POST /companies/{companyId}/collaborators/{collaboratorId}/contracts (alleen Frankrijk, 201 zonder data, beschikbaar na twee tot vijf minuten).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Deel | Veld in PayFit | Toelichting |
|---|---|---|
hiring_type (hris_direct_employee of direct_employee) | Filter: alleen eigen werknemers | |
employments.client_legal_entity | PayFit-bedrijf (companyId) | Alleen de Franse rechtspersoon |
first_name, last_name | firstName, lastName | |
Privé-e-mail in Deel | personalEmail | Verplicht in PayFit |
Thuisadres in Deel | personalAddress (streetNumber, addressFirstLine, city, postCode, country) | |
job_title, employments.start_date | jobTitle, startDate (contract) | |
employments.payment (rate, scale, currency) | Taak voor payroll met loon en ingangsdatum |
Gerelateerd
Ashby → Deel
Ashby Deel koppeling: aannames bij de eigen entiteit als direct employee in Deel
Bullhorn → Deel
Bullhorn Deel koppeling: eerste plaatsing als direct employee met contract in Deel
Carerix → Deel
Carerix Deel koppeling: geslaagde plaatsing als persoon of contract in Deel
Deel → 4PS Construct
Deel 4PS Construct koppeling: eigen werknemers van de bouwentiteit in 4PS, met afdeling en kostenplaats als dimensie