Payroll koppeling
Personio Nmbrs koppeling: salarissen en vergoedingen automatisch per periode
Met een koppeling tussen Personio en Nmbrs komen nieuwe Nederlandse medewerkers en contractwijzigingen uit Personio automatisch in Nmbrs, met rooster, salaris en bankrekening. Salarissen, vergoedingen en bonussen van elke maand gaan vanzelf naar de juiste periode in Nmbrs, zodat het salarisbureau geen maandexport meer overtypt.
Wat de koppeling doet
Wie HR in Personio voert en de Nederlandse salarissen in Nmbrs laat draaien, vaak via een salarisbureau, exporteert aan het eind van de maand nieuwe mensen, wijzigingen en bonussen. Het bureau zet dat met de hand in Nmbrs, en wat na de export nog verandert, mist de salarisrun.
- HR voert een nieuwe medewerker of wijziging in in Personio.
- KoppelHet controleert of de medewerker bij de Nederlandse entiteit hoort en zet hem in Nmbrs of werkt hem bij.
- Voor de salarisrun haalt KoppelHet de salarissen, vergoedingen en bonussen van die maand op.
- Vast salaris wordt het salaris in Nmbrs, terugkerende vergoedingen vaste looncomponenten en eenmalige betalingen en bonussen variabele looncomponenten in die periode.
- Een einddatum in Personio zet de datum uit dienst in Nmbrs. Het salarisbureau ziet meldingen en afwijkingen in het KoppelHet platform.
Waar je op let bij Personio en Nmbrs
- Personio deelt beloning in naar vast salaris, uurloon, terugkerende vergoedingen, eenmalige betalingen en bonussen. Die indeling sluit aan op het onderscheid in Nmbrs tussen salaris, vaste en variabele looncomponenten.
- Personio geeft beloningsgegevens per maand vrij. KoppelHet vraagt ze daarom per Nmbrs-periode op, en haalt een correctie voor een eerdere maand apart op.
- Personio meldt alleen dat een medewerker is gewijzigd, niet wat. KoppelHet vergelijkt de nieuwe stand met Nmbrs en schrijft alleen wat echt anders is.
- Personio meldt een startende medewerker pas om middernacht op de startdatum. Voor Nmbrs is dat te laat voor de eerste periode, dus KoppelHet zet de medewerker al in Nmbrs zodra het contract in Personio staat.
- BSN en IBAN staan in Personio in eigen velden. Die kan de koppeling pas lezen als de beheerder ze daarvoor openzet; anders blijft het veld in Nmbrs leeg en volgt een melding.
- Nmbrs stopt op 1 maart 2027 met zijn oude koppelvorm. KoppelHet sluit Personio daarom meteen aan op de nieuwe.
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
Werkt dit met een extern salarisbureau?
Ja. Het bureau werkt in Nmbrs zoals altijd, maar krijgt de wijzigingen en beloningen automatisch en ziet afwijkingen in het KoppelHet platform.
Wat gebeurt er met een bonus die na de salarisrun wordt ingevoerd?
Die gaat naar de eerstvolgende open periode in Nmbrs. We spreken per klant af of de salarisadministratie daar eerst een melding van krijgt.
Gaan ook medewerkers uit andere landen mee?
Nee. KoppelHet neemt alleen medewerkers van de Nederlandse entiteit in Personio mee.
Wie houdt bij welke vergoeding bij welk looncomponent hoort?
KoppelHet. Komt er in Personio een nieuw soort vergoeding bij, dan passen wij de vertaling naar Nmbrs aan.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Personio wordt gelezen via webhooks (alleen id van persoon of dienstverband; employment.started vuurt om middernacht UTC op de startdatum) en de Personio API v2. Het compensations-endpoint accepteert een periode van maximaal een maand, met categorieën FIXED_SALARY, HOURLY_SALARY, RECURRING, ONE_TIME en BONUS_PAYOUT.
- BSN en IBAN komen uit custom attributes die voor API-toegang moeten zijn vrijgegeven. Rooster uit weekly_working_hours; een YEARLY-bedrag wordt gedeeld naar maand.
- Naar Nmbrs schrijven we via de Nmbrs REST API. De SOAP API stopt per 1 maart 2027.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Personio | Veld in Nmbrs | Toelichting |
|---|---|---|
Persoon-id | Personeelsnummer of vrij veld | |
Voornaam en achternaam | Voornaam, tussenvoegsel, achternaam | |
Adres | Adres | |
Startdatum dienstverband | Datum in dienst | |
weekly_working_hours | Rooster (uren per week) | |
FIXED_SALARY (amount, interval) | Bruto maandsalaris | Een YEARLY-bedrag delen naar maand |
HOURLY_SALARY | Uurloon | |
RECURRING | Vaste looncomponent | Per compensation type een Nmbrs-looncomponent |
ONE_TIME en BONUS_PAYOUT | Variabele looncomponent | |
Einddatum dienstverband | Datum uit dienst |
Gerelateerd
Ashby → Personio
Ashby Personio koppeling: aannames met uren en entiteit als nieuwe medewerker in Personio
Bullhorn → Personio
Bullhorn Personio koppeling: plaatsingen als persoon met dienstverband in Personio
Carerix → Personio
Carerix Personio koppeling: geslaagde plaatsing als nieuwe medewerker in Personio
Greenhouse → Personio
Greenhouse Personio koppeling: aangenomen kandidaten als medewerker in Personio