Payroll koppeling
Deel IRIS Payroll koppeling: eigen Britse werknemers uit Deel als employee in Staffology Payroll
Een koppeling tussen Deel en IRIS Staffology Payroll maakt een eigen werknemer van de Britse rechtspersoon in Deel aan als employee bij de juiste employer in Staffology, werkt het loon bij en zet bij vertrek de leaver-gegevens. EOR-medewerkers in het Verenigd Koninkrijk en contractors blijven buiten IRIS, omdat Deel die zelf betaalt.
Wat de koppeling doet
Organisaties die Deel als HR-systeem gebruiken en hun eigen Britse Ltd in Staffology verlonen, typen een Britse starter na in de payroll. Een loonsverhoging in Deel en een vertrek komen vaak pas na een mail van HR in Staffology.
- HR maakt in Deel een eigen werknemer aan bij de Britse rechtspersoon.
- KoppelHet ontvangt de webhook, kiest de Staffology-employer bij de legal entity en haalt het profiel op.
- KoppelHet maakt de employee aan in Staffology met naam, adres, startdatum en loon.
- Bij een wijziging leest KoppelHet de employee eerst op en schrijft het volledige record terug met alleen het gewijzigde loon.
- Een afgeronde beëindiging in Deel zet de employee in Staffology als leaver met de laatste werkdag.
Waar je op let bij Deel en IRIS Payroll
- Deel noemt het aanmaken van een direct employee de route voor werknemers die een eigen payrollleverancier betaalt. KoppelHet volgt alleen die werknemers en alleen de Britse legal entity. Wie Deel als EOR in het Verenigd Koninkrijk in dienst heeft, krijgt zo geen tweede loonstrook uit Staffology.
- Staffology kent geen PATCH op een employee; een PUT vervangt het hele record. De webhook Employee Updated Direct van Deel zegt bovendien niet welk veld veranderde. KoppelHet vergelijkt daarom het profiel met de vorige stand, leest de employee in Staffology op en zet alleen het gewijzigde veld terug, zodat taxcode en andere payrollvelden blijven staan.
- In Staffology hoort elke employee bij één employer, en de API-key werkt namens een gebruiker met toegang tot die employers. Deel geeft per werknemer een legal_entity_id. Heeft de organisatie twee Britse entiteiten, dan legt KoppelHet per entiteit de employerId vast en weigert een werknemer zonder bekende entiteit.
- Deel bewaart het loon met een scale zoals ANNUAL, MONTHLY, WEEKLY of HOURLY. Staffology rekent met PayOptions, met een periode en een basis zoals per maand of per uur. KoppelHet zet een jaarloon om naar het bedrag per payperiode van de employer en stuurt een uurloon als uurtarief, alleen in pond.
- Het NI-nummer geeft Deel alleen in additional_details terug als de feature flag aanstaat en persoonsgegevens niet worden afgeschermd. Zonder die instelling vult payroll het nummer in Staffology in. KoppelHet stuurt dan geen leeg veld mee in de PUT, zodat een ingevuld NI-nummer niet verdwijnt.
- Een beëindiging in Deel doorloopt statussen zoals PENDING, IN_PROGRESS en COMPLETED, en de laatste werkdag kan in die tijd nog schuiven. KoppelHet zet hasLeft en leaveDate in Staffology pas als de status COMPLETED is, en meldt een lopende beëindiging eerder aan payroll.
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 ook met IRIS Earnie of andere IRIS-producten?
Deze pagina gaat over Staffology Payroll, dat de open API heeft. Voor andere IRIS-producten kijken we eerst welke importroute er is.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Deel via de HRIS-API met bearer token: webhooks Employee Created Direct en Employee Updated Direct, GET /rest/people met employments, compensation, active_worker_termination_status en direct_employee_termination_last_day; additional_details alleen met feature flag.
- Staffology Payroll REST-API met een API-key als wachtwoord in Basic-authenticatie: POST /employers/{employerId}/employee, GET en PUT op /employers/{employerId}/employee/{id} met het volledige record, PayOptions en leaverDetails (hasLeft, leaveDate).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Deel | Veld in IRIS Payroll | Toelichting |
|---|---|---|
legal_entity_id | employerId in Staffology | Vertaaltabel per Britse entiteit |
first_name, last_name | personalDetails (firstName, lastName) | |
addresses | personalDetails.address | |
additional_details (NI-nummer) | personalDetails.niNumber | Alleen met feature flag; nooit een bestaand nummer overschrijven |
employment.start_date | employmentDetails.startDate | |
compensation_details (salary, scale, currency) | payOptions (basis, period, payAmount) | |
direct_employee_termination_last_day | leaverDetails (hasLeft, leaveDate) |
Gerelateerd
Ashby → Deel
Ashby Deel koppeling: aannames bij de eigen entiteit als direct employee in Deel
Bullhorn → Deel
Bullhorn Deel koppeling: eerste plaatsing als direct employee met contract in Deel
Carerix → Deel
Carerix Deel koppeling: geslaagde plaatsing als persoon of contract in Deel
Deel → 4PS Construct
Deel 4PS Construct koppeling: eigen werknemers van de bouwentiteit in 4PS, met afdeling en kostenplaats als dimensie