Payroll koppeling
Factorial ADP iHCM koppeling: contractversies en ontslag van de Nederlandse entiteit naar ADP
Met een koppeling tussen Factorial en ADP iHCM NL gaat elk nieuw salaris uit een contractversie in Factorial met de juiste ingangsdatum naar ADP iHCM, en wordt een ontslag in Factorial ook in ADP verwerkt of weer teruggedraaid. HR werkt in Factorial, de salarisadministratie in ADP, en niemand typt bedragen over.
Wat de koppeling doet
Organisaties die HR in Factorial doen en het Nederlandse loon in ADP iHCM rekenen, hebben voor elke salarisverhoging een tweede handeling in ADP nodig. Draait HR een ontslag terug, dan staat het in ADP vaak nog wekenlang als beëindigd.
- De salarisadministratie maakt een nieuwe medewerker aan in ADP iHCM; KoppelHet koppelt die één keer aan de medewerker in Factorial.
- Factorial meldt een nieuwe of gewijzigde contractversie; KoppelHet haalt salaris, frequentie en ingangsdatum op.
- Hoort de medewerker bij de Nederlandse entiteit, dan gaat het nieuwe salaris met die ingangsdatum naar ADP.
- Een beëindiging in Factorial start de uitdiensttreding in ADP; een teruggedraaide beëindiging annuleert hem.
- Vóór de afsluitdatum vergelijkt KoppelHet de updates in Factorial met wat in ADP staat.
Waar je op let bij Factorial en ADP iHCM
- Factorial legt een salarisverhoging vast als nieuwe contractversie met een eigen ingangsdatum, los van de datum van indiensttreding. KoppelHet gebruikt die ingangsdatum voor ADP, zodat een verhoging per de eerste van de maand ook daar per die datum ingaat.
- Factorial bewaart het salaris in centen, samen met een frequentie zoals per jaar. ADP iHCM wil een bedrag met decimalen en een salariscode. KoppelHet rekent het bedrag om en vertaalt de frequentie naar de code die de paygroup in ADP kent.
- Factorial kan een beëindiging terugdraaien en meldt dat met een aparte webhook. ADP iHCM heeft daarvoor een annulering van de beëindiging. KoppelHet koppelt die twee, zodat een medewerker die toch blijft ook in ADP gewoon doorbetaald wordt.
- In Factorial staan vaak medewerkers van meerdere landen. KoppelHet filtert de updates op de Nederlandse juridische entiteit, zodat alleen contractversies van die entiteit naar ADP iHCM gaan.
- Factorial probeert een mislukte webhook tot twintig keer binnen 48 uur en zet het abonnement daarna uit. Omdat ADP een wijziging vóór de afsluitdatum moet hebben, bewaakt KoppelHet de abonnementen en vergelijkt het vóór die datum alle updates opnieuw.
- ADP iHCM weigert een salariswijziging met een datum vóór de start van het dienstverband. Een contractversie uit de tijd vóór ADP, bijvoorbeeld uit een eerdere overstap, stuurt KoppelHet daarom niet mee.
- Een einddatum wijzigen kan in ADP iHCM niet. Verschuift HR in Factorial het einde van het contract, dan annuleert KoppelHet de beëindiging in ADP en start hem opnieuw met de nieuwe datum.
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
Gaan contracturen ook naar ADP?
Niet in de eerste versie. Factorial heeft uren met een frequentie per contractversie; welk ADP-veld die uren hoort te krijgen, verschilt per paygroup. Dat kan later als uitbreiding.
Maakt de koppeling nieuwe medewerkers aan in ADP?
Nee. In de openbare ADP-gidsen voor iHCM staat daar geen API voor. Een nieuwe medewerker komt als taak bij de salarisadministratie.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Factorial via de Factorial API (versie in het pad, bijvoorbeeld 2026-10-01) met OAuth 2.0. Contract versions (employee_id, effective_on, starts_on, ends_on, salary_amount in centen, salary_frequency, working_hours en working_hours_frequency), employee_updates/summaries gefilterd op legal_entities_ids[] en type[], en webhooks voor ContractVersion Creates en Updates en Employee Terminates en Unterminates. Mislukte webhooks: tot twintig pogingen binnen 48 uur, daarna uitgeschakeld.
- ADP iHCM via de Base Remuneration Change API (worker.work-assignment.base-remuneration.change; 2417 bedrag en 2416 salariscode, één event per aanroep, ingangsdatum niet vóór de start van de work assignment) en de Worker Terminate API (worker.terminate en worker-termination.cancel). Canonical URI's in de Consumer Application Registry (CAR).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Factorial | Veld in ADP iHCM | Toelichting |
|---|---|---|
employee_id | payrollfilenumber | Eenmalig gekoppeld; KoppelHet bewaart de sleutel |
salary_amount (in centen) | 2417 salarisbedrag | Gedeeld door honderd |
salary_frequency | 2416 salariscode | Vertaaltabel per frequentie |
effective_on | effectiveDateTime | |
Legal entity | payrollGroupCode | Alleen de Nederlandse entiteit |
Beëindiging (ends_on) | worker.terminate | |
Teruggedraaide beëindiging | worker-termination.cancel |
Gerelateerd
Factorial → 4PS Construct
Factorial 4PS Construct koppeling: monteurs en uitvoerders met hun kostenplaats als dimensie in 4PS
Factorial → Active Directory
Factorial Active Directory koppeling: domeinaccounts vanuit Factorial
Factorial → AFAS Profit
Factorial koppelen met AFAS: medewerkers en contracten uit Factorial in AFAS Profit Payroll
Factorial → AllSolutions
Factorial AllSolutions koppeling: medewerkers per legal entity met hun hoofdkostenplaats in AllSolutions