X4HR naar ITSM
Dayforce Xurrent koppeling: personen en verzoeken bij indienst, overplaatsing en vertrek
Met een koppeling tussen Dayforce en Xurrent staat elke medewerker uit Dayforce als persoon in Xurrent, met organisatie, site en leidinggevende, en zet een aanname, overplaatsing of vertrek in Dayforce een verzoek klaar vanuit het juiste sjabloon. KoppelHet leest de Dayforce REST API en schrijft via de REST API van Xurrent.
Wat de koppeling doet
Organisaties met Dayforce als HR-systeem en Xurrent voor IT- en facilitaire dienstverlening laden personen vaak met een periodiek importbestand. Tussen twee imports ontbreken nieuwe collega's, en een overplaatsing naar een andere vestiging komt pas na weken in Xurrent.
- KoppelHet vraagt Dayforce om aannames binnen de onboardingtermijn en om gewijzigde werkplekken.
- Per medewerker haalt KoppelHet werkplek, organisatie-eenheid, contactgegevens en leidinggevende op met de ingangsdatum als peildatum.
- De leidinggevende wordt eerst persoon als hij dat nog niet is, daarna de medewerker, met de XRefCode als sourceID.
- Een verzoek uit het juiste sjabloon gaat in voor de medewerker, ingediend door de leidinggevende.
- Na een afgerond offboardingverzoek schakelt KoppelHet de persoon uit.
Waar je op let bij Dayforce en Xurrent (4me)
- KoppelHet leest de Dayforce REST API met een gebruiker die alleen leest en schrijft personen en verzoeken via de Xurrent API, met een OAuth-token van een eigen koppelgebruiker.
- Een persoon in Xurrent kan niet zonder primair e-mailadres. Dayforce geeft het werkadres alleen als de rol van de API-gebruiker veldtoegang tot contactgegevens heeft; ontbreekt het, dan meldt KoppelHet een rechtenprobleem in plaats van de persoon over te slaan.
- Het werkadres is in Xurrent ook de inlognaam en verandert bij een naamswijziging. KoppelHet zet de Dayforce-XRefCode als sourceID, zodat dezelfde persoon het nieuwe adres krijgt.
- Dayforce kan medewerkers opvragen zoals ze op een gekozen datum zijn. Bij een overplaatsing dient KoppelHet het verzoek voor toegang direct in, maar zet de nieuwe organisatie en site in Xurrent pas op de ingangsdatum, zodat goedkeuringen tot die dag bij de huidige afdeling blijven.
- Een verzoek vraagt in Xurrent een indiener en een ontvanger. KoppelHet zet de leidinggevende uit Dayforce als indiener; is die zelf nieuw, bijvoorbeeld een vestigingsmanager die tegelijk met zijn team begint, dan maakt KoppelHet hem eerst aan.
- Organisatie-eenheden in Dayforce worden organisaties in Xurrent met de bovenliggende eenheid als parent. Dayforce kan op eenheid filteren, zodat alleen de eenheden van deze Xurrent-omgeving meegaan.
- Een uitgeschakelde persoon mag in Xurrent niet meer aan nieuwe records worden gekoppeld. Dayforce meldt een vertrek vaak ruim vooruit; KoppelHet dient het offboardingverzoek direct in en schakelt de persoon pas uit als dat verzoek klaar is.
Deze koppeling hoort ook bij in-, door- en uitstroom.
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
Kan het periodieke importbestand blijven?
Dat vervalt, zodat niet twee bronnen dezelfde personen bijwerken. Een grote reorganisatie kan KoppelHet wel als importbestand aanleveren.
Gaan salarisgegevens naar Xurrent?
Nee. KoppelHet vraagt alleen naam, contactgegevens, werkplek, organisatie en leidinggevende op.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Dayforce via de REST API op /api/{clientName}/v1/Employees met FilterHireStartDate, FilterTerminationStartDate, OrgUnitXRefCode en FilterUpdatedStartDate met filterUpdatedEntities; daarna Employees/{XRefCode} met expand (WorkAssignments, Contacts, EmployeeManagers) en ContextDate. Velden alleen bij veldtoegang in de rol van de API-gebruiker.
- Xurrent via de REST API met een OAuth-token. Personen via /people (primary_email verplicht, employeeID, job_title, organization, site, manager, disabled), organisaties via /organizations, sites via /sites. Verzoeken via POST /requests met subject, category, team, requested_for, requested_by, template en desired_completion_at. Rate limiting per gebruiker met HTTP 429.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Dayforce | Veld in Xurrent (4me) | Toelichting |
|---|---|---|
XRefCode | source en sourceID | |
Werkadres uit Contacts | primary_email | Verplicht in Xurrent |
FirstName, LastName | name | |
Job uit WorkAssignments | job_title | |
OrgUnit | organization | |
Location uit WorkAssignments | site | |
EmployeeManagers | manager en requested_by | |
Aannamedatum of laatste dag | desired_completion_at |
Gerelateerd
Ashby → Dayforce
Ashby Dayforce koppeling: aanname eerst laten controleren door Dayforce, dan pas opslaan
Bullhorn → Dayforce
Bullhorn Dayforce koppeling: eerste plaatsing van een werknemer als medewerker in Dayforce
Carerix → Dayforce
Carerix Dayforce koppeling: geslaagde plaatsing als gecontroleerde nieuwe medewerker in Dayforce
Dayforce → 4PS Construct
Dayforce 4PS Construct koppeling: monteurs en uitvoerders uit Dayforce in 4PS, met kostenplaats en einddatum