Payroll koppeling
Rippling PayFit koppeling: medewerkers van de eigen Franse entiteit uit Rippling als collaborator in PayFit
Een koppeling tussen Rippling en PayFit maakt een medewerker van de eigen Franse entiteit in Rippling aan als collaborator met contract in PayFit, met naam, privé-e-mail, adres, functietitel en startdatum. Medewerkers die Rippling als EOR of PEO in dienst heeft, gaan niet naar PayFit, en het loon gaat als taak naar payroll omdat het PayFit-contract via de API geen salaris vraagt.
Wat de koppeling doet
Organisaties die Rippling als HR-platform gebruiken en hun eigen Franse SAS in PayFit verlonen, maken een Franse starter eerst in Rippling aan en daarna nog eens in PayFit. Een ingetrokken aanbod in Rippling blijft dan soms als collaborator in PayFit staan.
- KoppelHet leest elk uur de gewijzigde workers in Rippling, met legal entity, dienstverband en compensatie.
- Alleen een EMPLOYEE van de eigen Franse entiteit met status ACCEPTED of ACTIVE gaat door.
- KoppelHet maakt de collaborator aan in PayFit en daarna het contract met functietitel en startdatum.
- Het loon uit Rippling gaat als taak naar de payrollbeheerder, die het contract afmaakt.
- Een ingetrokken of afgewezen aanbod meldt KoppelHet aan payroll om de collaborator op te ruimen.
Waar je op let bij Rippling en PayFit
- Bij elke worker geeft Rippling de legal entity met een management_type, zoals PEO of EOR. Voor die medewerkers is Rippling of een partner de werkgever en loopt de loonbetaling daar. KoppelHet stuurt alleen medewerkers van de eigen Franse entiteit zonder zo'n type naar PayFit.
- Rippling rekent bij afgeleide bedragen met een werkweek van veertig uur, zowel van uurloon naar jaarloon als andersom. In Frankrijk is een voltijdse week vijfendertig uur. KoppelHet geeft payroll daarom het bedrag dat HR echt invoerde, jaarloon bij SALARIED en uurloon bij HOURLY, en nooit het omgerekende.
- De API van Rippling heeft landvelden alleen voor het SSN in de Verenigde Staten, het SIN in Canada en het IRD-nummer in Nieuw-Zeeland. Een Frans NIR komt dus niet uit de standaardvelden. KoppelHet laat het optionele socialSecurityNumber in PayFit leeg, tenzij de organisatie het NIR in een eigen veld in Rippling bijhoudt.
- Een worker in Rippling doorloopt INIT, HIRED, ACCEPTED en ACTIVE, en een vertrek kan het type OFFER_DECLINED, RESCIND of RENEGE hebben. KoppelHet maakt pas bij ACCEPTED een collaborator aan. Komt daarna een van die drie types, dan krijgt payroll een melding, omdat de API van PayFit geen collaborator verwijdert.
- PayFit maakt een contract via de API alleen voor Frankrijk aan en antwoordt met 201 zonder gegevens; het contract staat er na twee tot vijf minuten. KoppelHet zoekt het daarna op en meldt de Rippling-medewerker pas als klaar als het contract in PayFit zichtbaar is.
- Velden waarvoor het Rippling-token geen recht heeft, staan in de lijst redacted_fields van het antwoord in plaats van met een waarde. KoppelHet leest die lijst. Een afgeschermd adres of e-mailadres wordt zo een rechtenprobleem voor de beheerder, en geen lege verplichte waarde die PayFit weigert.
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 Rippling voor de Franse lonen gebruiken?
Als Rippling in Frankrijk voor jullie verloont, vervalt deze koppeling. Deze pagina is voor organisaties die PayFit houden.
Gaan loonwijzigingen 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.
- Rippling via de REST API: GET /workers met expand op user, legal_entity, employment_type en compensation, filter op updated_at en status, __meta.redacted_fields; scope workers.read en een bearer token.
- PayFit via partner-api.payfit.com met een API-key: POST /companies/{companyId}/collaborators (firstName, lastName, personalEmail, personalAddress) en POST /companies/{companyId}/collaborators/{collaboratorId}/contracts (jobTitle, startDate; alleen Frankrijk).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Rippling | Veld in PayFit | Toelichting |
|---|---|---|
legal_entity (management_type, country) | Filter en companyId | Geen EOR of PEO; alleen Frankrijk |
employment_type.type | Filter: alleen EMPLOYEE | |
user (naam, privé-e-mail) | firstName, lastName, personalEmail | |
Thuisadres van de worker | personalAddress (streetNumber, addressFirstLine, city, postCode, country) | |
title, start_date | jobTitle, startDate (contract) | |
compensation (annual_compensation of hourly_wage, salary_effective_date) | Taak voor payroll | Bronbedrag, geen afgeleid bedrag |
Gerelateerd
Carerix → Rippling
Carerix Rippling koppeling: geslaagde match als hire ter beoordeling in Rippling
Greenhouse → Rippling
Greenhouse Rippling koppeling: elke aanname direct als hire ter beoordeling in Rippling
Recruitee → Rippling
Recruitee Rippling koppeling: aangenomen kandidaten klaar om te hiren
Rippling → 4PS Construct
Rippling 4PS Construct koppeling: eigen employees van de bouwentiteit in 4PS, met afdeling als dimensie