Payroll koppeling
Lucca Nmbrs koppeling: HR-mutaties van de Nederlandse vestiging uit Lucca naar Nmbrs
Met een koppeling tussen Lucca en Nmbrs gaan nieuwe medewerkers, functiewijzigingen, salarisregels en vertrekken van de Nederlandse vestiging uit Lucca naar Nmbrs, met de looptijd die in Lucca staat. Lucca meldt elke wijziging met een webhook, zodat het administratiekantoor in Nmbrs met actuele gegevens verloont.
Wat de koppeling doet
Wie Lucca gebruikt voor HR in Frankrijk en daarbuiten en de Nederlandse vestiging laat verlonen in Nmbrs, stuurt het administratiekantoor elke maand een overzicht. Een verhoging die HR in Lucca met terugwerkende kracht aanpast, komt daarin niet altijd terug.
- HR wijzigt in Lucca een medewerker, dienstverband, functie of beloningsregel.
- Lucca stuurt een webhook; KoppelHet haalt de actuele stand op.
- Hoort de medewerker bij de Nederlandse vestiging, dan zet KoppelHet de wijziging in het juiste Nmbrs-bedrijf, in de periode waarin de ingangsdatum valt.
- Een einddatum op het dienstverband in Lucca wordt de datum uit dienst in Nmbrs.
- Vóór de aanleverdatum vergelijkt KoppelHet Lucca en Nmbrs en meldt verschillen.
Waar je op let bij Lucca en Nmbrs
- Lucca bewaart webhook-events twee maanden en probeert een levering tot vijf keer binnen ongeveer een dag. KoppelHet bevestigt elk event binnen de drie seconden die Lucca wacht en verwerkt het daarna, zodat geen wijziging verloren gaat als Nmbrs even traag is.
- Een wijziging van een dienstverband werkt in Lucca met terugwerkende kracht. KoppelHet vergelijkt de nieuwe begin- of einddatum met wat al in Nmbrs staat en meldt aan het administratiekantoor als een afgesloten periode wordt geraakt.
- Zet HR in Lucca een nieuwe vaste beloningsregel van dezelfde soort, dan sluit Lucca de vorige zelf af op de dag ervoor. KoppelHet leest die einddatum mee, zodat in Nmbrs niet twee salarissen naast elkaar gelden.
- Een functie in Lucca is tijdelijk en hoort bij een dienstverband; een medewerker heeft er in de loop van de tijd meerdere. KoppelHet neemt de functie die op de ingangsdatum in de Nmbrs-periode geldt, niet simpelweg de laatste.
- Lucca legt een bankrekening vast als IBAN of in een lokaal formaat. Alleen een IBAN gaat naar Nmbrs; een rekening in een ander formaat wordt een melding voor de salarisadministratie.
- Lucca breekt een verzoek af dat langer dan vijf seconden duurt. KoppelHet vraagt per webhook alleen de betrokken medewerker op en houdt grote lijsten voor de controle vóór de aanleverdatum klein per pagina.
- Het administratiekantoor geeft de koppeling in Nmbrs alleen toegang tot de bedrijven van jullie Nederlandse vestiging. Loonheffingskorting, cao en pensioen beheert het kantoor; Lucca kent die Nederlandse begrippen niet.
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
Wat als onze webhook-ontvanger even niet bereikbaar is?
Lucca probeert het opnieuw, tot vijf keer in ongeveer een dag. Daarna vangt de controle vóór de aanleverdatum een gemiste wijziging op.
Wat moet het administratiekantoor regelen?
Een koppeling in Nmbrs met toegang tot alleen jullie bedrijven, en de vertaaltabel van Lucca-beloningssoorten naar looncomponenten afstemmen.
Gaat verlof uit Lucca ook mee?
Niet in deze koppeling. Verlof en afwezigheid naar Nmbrs is een aparte stroom en kan later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Lucca API (v5) voor employees, employee-personal-records (bankAccount met format iban of other), employments (legalEntity, start.date, end.date; PATCH is retroactief) en job-positions; webhooks via webhook-endpoints (3 seconden timeout, maximaal 5 pogingen, events 2 maanden bewaard). Beloning via de oudere Compensation API (fixed-items; een nieuw open item sluit het vorige van dezelfde soort op de dag ervoor). Verzoeken langer dan 5 seconden worden afgebroken.
- Nmbrs via de REST API met OAuth 2.0 op werkgeversniveau. De SOAP API stopt per 1 maart 2027.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Lucca | Veld in Nmbrs | Toelichting |
|---|---|---|
employee.id | Personeelsnummer of vrij veld | |
givenName en familyName | Voornaam, tussenvoegsel en achternaam | |
employee-personal-record.birthDate | Geboortedatum | |
employee-personal-record.bankAccount.accountIdentifier (format iban) | IBAN | |
employment.legalEntity | Nmbrs-bedrijf | Eén Nmbrs-bedrijf per Nederlandse entiteit |
employment.start.date en end.date | Datum in en uit dienst | |
job-position: jobTitle, department, manager | Functie en afdeling | Via een vertaaltabel |
fixed-item: nature, amount, startsOn, endsOn | Salaris of vaste looncomponent met periode | Soort via een vertaaltabel |
Gerelateerd
Lucca → Active Directory
Lucca Active Directory koppeling: accounts in je eigen domein op basis van Lucca
Lucca → ADP iHCM
Lucca ADP iHCM koppeling: vaste en variabele beloning uit Lucca Compensation naar de Nederlandse ADP-payroll
Lucca → AFAS Profit
Lucca AFAS koppeling: medewerkers en beloning van de Nederlandse entiteit uit Lucca in AFAS
ASLucca → Arbodienst (SIVI)
Lucca koppelen met de arbodienst via SIVI: bevestigde ziekte per halve dag als verzuimmelding