Payroll koppeling
ADP Workforce Now Nmbrs koppeling: de Nederlandse payrollgroep uit ADP in het juiste Nmbrs-bedrijf
Met een koppeling tussen ADP Workforce Now en Visma Nmbrs gaan nieuwe medewerkers, salariswijzigingen en vertrek van de Nederlandse payrollgroep uit ADP Workforce Now naar het juiste bedrijf in Nmbrs. Nmbrs verloont daarna volgens de Nederlandse regels, en loonheffingskorting en pensioen blijven in Nmbrs bij de salarisadministratie.
Wat de koppeling doet
Organisaties die Amerikaanse en Canadese medewerkers in ADP Workforce Now verlonen en Nederlandse medewerkers in Nmbrs, houden de Nederlandse groep in twee systemen bij. De salarisadministratie hoort van een salarisaanpassing vaak pas als de Nederlandse manager ernaar vraagt.
- HR legt een Nederlandse medewerker of wijziging vast in ADP Workforce Now, in de Nederlandse payrollgroep.
- KoppelHet haalt de workers van die payrollgroep op, pagina voor pagina, en vergelijkt ze met Nmbrs.
- Een nieuwe worker wordt een medewerker in het Nmbrs-bedrijf van die entiteit; een wijziging werkt dienstverband, uren of salaris bij met ingangsdatum.
- De salarisadministratie vult in Nmbrs de Nederlandse fiscale gegevens aan.
- Een termination zet de einddatum van het dienstverband in Nmbrs.
Waar je op let bij ADP Workforce Now en Nmbrs
- KoppelHet filtert in ADP op de payrollgroep van de Nederlandse entiteit. Heeft de organisatie meer Nederlandse entiteiten, dan hoort bij elke payrollgroep één bedrijf in Nmbrs, en daar komt de medewerker terecht.
- Het BSN staat in ADP tussen de nationale nummers, die de API standaard maskeert. De koppeling leest alleen het Nederlandse nummer, en alleen nadat de beheerder het voor dit API Central-project heeft vrijgegeven.
- Workforce Now accepteert en bewaart salaris als bedrag per periode, per uur of per dag; het jaarbedrag rekent het zelf uit. KoppelHet gebruikt het opgeslagen bedrag met de betaalfrequentie en rekent dat om naar het Nederlandse maandsalaris of uurloon in Nmbrs.
- Of een worker nog in dienst is, leidt ADP af van de primaire work assignment. Heeft iemand naast de Nederlandse ook een andere positie, dan kijkt KoppelHet naar de status van de Nederlandse positie zelf voordat het dienstverband in Nmbrs wordt beëindigd.
- ADP geeft per aanroep maximaal honderd workers terug. De volledige vergelijking vóór de Nmbrs-run haalt de payrollgroep daarom in pagina's op, zodat niemand ontbreekt.
- Loonheffingskorting, pensioenregeling en cao bestaan niet in Workforce Now. De salarisadministratie legt ze in Nmbrs vast, en de koppeling laat die velden bij latere wijzigingen ongemoeid.
- Nmbrs stopt per 1 maart 2027 met de SOAP API. Deze koppeling schrijft daarom vanaf het begin via de REST API van Nmbrs.
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
Kunnen we eerst testen zonder productiegegevens?
Een testomgeving van Workforce Now is er alleen als ADP die op verzoek inricht; voor Next Gen en TotalSource is die er volgens ADP niet. Dat vragen we vroeg in het project na.
Gaan loonstroken terug naar ADP?
Nee. Nederlandse loonstroken blijven in Nmbrs. Een stroom terug kan later als uitbreiding.
Wat als een medewerker in ADP naar een andere payrollgroep gaat?
Dan valt hij buiten het filter. KoppelHet zet dat op de verschillenlijst, zodat de salarisadministratie het dienstverband in Nmbrs bewust beëindigt.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- ADP Workforce Now via de Worker Management API - GET /hr/v2/workers met $filter=workers/workAssignments/payrollGroupCode eq '{code}', paginering met $top (maximaal 100) en $skip, Accept application/json;masked=false voor governmentIDs, birthDate en baseRemuneration (na vrijgave in Manage Profiles), plus events worker.hire en worker.terminate. Salaris alleen als payPeriodRateAmount, hourlyRateAmount of dailyRateAmount.
- Naar Nmbrs via de Nmbrs REST API met OAuth 2.0, per bedrijf; de SOAP API stopt per 1 maart 2027.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in ADP Workforce Now | Veld in Nmbrs | Toelichting |
|---|---|---|
workerID/idValue | Personeelsnummer in Nmbrs | Uniek per ADP-klant |
workAssignments/payrollGroupCode | Nmbrs-bedrijf | Eén payrollgroep per Nederlandse entiteit |
person/governmentIDs (NL) | BSN | Alleen ongemaskeerd |
person/legalName | Voornaam, tussenvoegsel, achternaam | |
workAssignments/hireDate | Datum in dienst | |
workAssignments/standardHours | Uren per week | |
baseRemuneration (payPeriodRateAmount of hourlyRateAmount) | Salaris | Omgerekend naar maandbedrag of uurloon |
workAssignments/terminationDate | Datum uit dienst |
Gerelateerd
ADP Workforce Now → 4PS Construct
ADP Workforce Now 4PS Construct koppeling: medewerkers met administratie, dimensies en statistiekgroep in 4PS
ADP Workforce Now → Active Directory
ADP Workforce Now Active Directory koppeling: accounts in het eigen domein, met vervaldatum en herindiensttreding uit ADP
ADP Workforce Now → AFAS Profit
ADP Workforce Now AFAS koppeling: Nederlandse medewerkers uit het Amerikaanse HR-systeem in AFAS Profit
ADP Workforce Now → AllSolutions
ADP Workforce Now AllSolutions koppeling: medewerkers met afdeling, kostenplaats en leidinggevende in AllSolutions