Payroll koppeling
Rippling koppelen met Loket: Nederlandse werknemers uit Rippling met loon en uren naar de loonrun
Met een koppeling tussen Rippling en Loket komt een nieuwe werknemer van de Nederlandse entiteit uit Rippling als conceptwerknemer in Loket, en gaan loon, arbeidstijd en uitdiensttreding naar het dienstverband in Loket. Contractors en medewerkers die via een EOR in dienst zijn, blijven buiten Loket.
Wat de koppeling doet
Organisaties die Rippling wereldwijd voor HR gebruiken maar in Nederland een eigen entiteit hebben die in Loket wordt verloond, sturen nieuwe medewerkers en loonswijzigingen met de hand naar het salarisbureau. In Rippling staan vaste krachten, contractors en mensen via een EOR door elkaar, en het bureau moet zelf uitzoeken wie in de loonrun hoort.
- HR neemt in Rippling een werknemer aan bij de Nederlandse entiteit.
- KoppelHet ziet de worker met status geaccepteerd of actief en maakt in Loket een conceptwerknemer bij de bijbehorende werkgever.
- De salarisadministratie vult BSN, cao, loonheffingskorting en pensioen aan en zet het concept om.
- Een nieuw salaris of een andere arbeidsduur in Rippling gaat naar het loon of de arbeidstijd in Loket, met de ingangsdatum.
- Een beëindiging in Rippling beëindigt het dienstverband in Loket per de einddatum.
Waar je op let bij Rippling en Loket
- Een juridische entiteit in Rippling heeft een beheersvorm, zoals PEO of EOR. Wie via een EOR in Nederland werkt, staat op de loonlijst van die partij en niet in jullie Loket. KoppelHet neemt alleen workers mee van de eigen Nederlandse entiteit.
- Rippling rekent het uurloon van een vaste kracht en het jaarbedrag van een uurloner uit op basis van veertig uur per week, wat niet past bij een Nederlandse werkweek. KoppelHet gebruikt daarom het bedrag dat HR echt heeft ingevoerd, en nooit het afgeleide bedrag.
- Rippling heeft landvelden voor onder meer het Amerikaanse en Canadese sofinummer, maar niet voor het BSN. KoppelHet laat het BSN daarom leeg in het concept, en de salarisadministratie vult het aan voordat ze het concept omzet. Staat het BSN in een eigen veld in Rippling, dan neemt KoppelHet het mee.
- Rippling kent de status geaccepteerd voor iemand die het aanbod heeft getekend maar nog niet is begonnen. KoppelHet maakt het concept in Loket bij die status, zodat de salarisadministratie weken voor de eerste loonrun alles kan aanvullen.
- Een beëindiging in Rippling heeft een soort, waaronder een afgewezen of ingetrokken aanbod. Staat er dan al een concept in Loket, dan verwijdert KoppelHet niets maar meldt het aan de salarisadministratie, zodat er geen dienstverband wordt gestart voor iemand die niet komt.
- Rippling geeft bij elke worker de vroegste startdatum over al zijn dienstverbanden. Komt iemand terug, dan ziet KoppelHet aan het verschil met de nieuwe startdatum dat het een terugkeer is, en start het een nieuw dienstverband bij de werknemer die al in Loket staat.
- Velden waar de koppeling in Rippling geen recht op heeft, komen terug als afgeschermd met een reden. KoppelHet controleert voor elk concept of salaris en datums leesbaar zijn, en meldt het aan HR als een recht ontbreekt in plaats van een leeg loon in Loket te zetten.
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
Rippling verloont zelf ook in Nederland. Waarom dan Loket?
Als jullie salarisbureau in Loket werkt en dat zo blijft, hoort de loonrun daar. De koppeling zorgt dat Loket dezelfde mensen en bedragen kent als Rippling.
Wat als het salaris niet in euro staat?
Elk bedrag in Rippling heeft een eigen valuta. Een bedrag dat niet in euro staat, zet KoppelHet niet door; de salarisadministratie krijgt een melding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Rippling REST API (rest.ripplingapis.com) met een bearer token met workers.read en de benodigde scopes voor geneste objecten, versie vast via de header Rippling-Api-Version. GET /workers met filter op status en updated_at, expand op user, legal_entity (management_type PEO, EOR of COR), employment_type (type, compensation_time_period, amount_worked) en compensation (annual_compensation, hourly_wage, salary_effective_date, currency_type per bedrag); velden number, start_date, original_start_date, end_date, termination_details, custom_fields; afgeschermde velden in __meta.redacted_fields. Paginering met cursor, limit tot 100.
- Naar Loket via de Loket REST API (api.loket.nl/v2) met OAuth 2.0: concept-employee, omzetten naar werknemer, create-employment, wage, working-hours en het beëindigen van het dienstverband. Testen in de acceptatieomgeving (api.loket-acc.nl/v2).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Rippling | Veld in Loket | Toelichting |
|---|---|---|
number (worker) | Personeelsnummer | |
user (naam) | Voornaam, voorvoegsel en achternaam | |
legal_entity (management_type) | Werkgever in Loket, of buiten de koppeling bij EOR of PEO | |
employment_type.type | Alleen EMPLOYEE naar Loket | |
start_date en original_start_date | Begindatum dienstverband | |
employment_type.compensation_time_period | Maandloon of uurloon | |
compensation.annual_compensation of hourly_wage | Loon per verloningsperiode | |
compensation.salary_effective_date | Begindatum van het loon | |
employment_type.amount_worked | Arbeidstijd | |
end_date en termination_details | Einde dienstverband |
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