Identity en access management
Unit4 HR Omada koppeling: identiteiten en contexten uit Unit4 ERPx in Omada Identity
Met een koppeling tussen Unit4 HR en Omada Identity leest Omada elke goedgekeurde medewerker uit Unit4 ERPx als identiteit, met bedrijf, organisatie-eenheid en kostenplaats als contexten en een status die volgt uit het dienstverband. KoppelHet biedt de REST-collector van Omada per medewerker één platte regel aan, met de waarden die op de dag van de import gelden.
Wat de koppeling doet
Organisaties die HR en financiën samen in Unit4 ERPx hebben en toegang met Omada Identity besturen, missen in Omada vaak de juiste afdeling en kostenplaats. Een overplaatsing die HR vooruit invoert, verandert rollen te vroeg, en een tweede dienstverband geeft rechten die niemand bewust heeft toegekend.
- In Unit4 Identity Services komt een machineclient voor KoppelHet, en Omada krijgt eigen client credentials voor het adres van KoppelHet.
- KoppelHet haalt de gewijzigde medewerkers met hun dienstverbanden en relaties op en houdt een volledige stand bij.
- Per medewerker zet KoppelHet één regel klaar met het hoofddienstverband en de relaties die die dag gelden.
- Omada leest identiteiten, contexten en contexttoewijzingen via de REST-collector en verwerkt ze in het datawarehouse.
- Rollen en goedkeuringen in Omada volgen de contexten; bij beëindiging trekt Omada de toegang in volgens jullie beleid.
Waar je op let bij Unit4 HR en Omada
- Unit4 en de REST-collector van Omada werken allebei met OAuth2 client credentials, dus Omada zou Unit4 in principe zelf kunnen aanroepen. Een machineclient krijgt in Unit4 echter alleen rechten via een gebruiker met de rol SUPER of SYSTEM, die ook bij financiële gegevens kan. Die sleutel blijft bij KoppelHet; Omada leest alleen de identiteitsvelden.
- De REST-collector van Omada kan geneste gegevens volgen, maar neemt dan alleen het eerste element van een lijst. In Unit4 heeft een medewerker een lijst dienstverbanden en relaties. KoppelHet kiest vooraf het hoofddienstverband en de geldende relaties, zodat Omada geen willekeurige functie als rolbasis gebruikt.
- Organisatie-eenheid en kostenplaats hangen in Unit4 als relaties met een datum vanaf en tot. KoppelHet levert de contexttoewijzing pas vanaf de ingangsdatum aan, zodat Omada rollen van de nieuwe afdeling niet al toekent op de dag dat HR de overplaatsing invoert.
- Omada kan naast identiteiten ook contexten met een type inlezen. KoppelHet maakt van elk Unit4-bedrijf, elke organisatie-eenheid en elke kostenplaats een eigen context, zodat eigenaarschap en certificering in Omada langs dezelfde lijnen lopen als de begroting in Unit4.
- Een personId is in Unit4 alleen binnen een bedrijf uniek; een dubbel nummer in hetzelfde bedrijf weigert Unit4 met een conflict. Omada eist een unieke business key. KoppelHet zet het bedrijf voor het persoonsnummer, zodat medewerkers van twee bedrijven in één tenant nooit op één identiteit uitkomen.
- Een nieuwe medewerker kan in Unit4 eerst in een goedkeuringsworkflow staan; Unit4 meldt dat met een aparte status. KoppelHet neemt hem pas op in de regels voor Omada als de workflow klaar is, zodat geen aanvraagproces in Omada start voor iemand die HR nog afkeurt.
- Beëindigen zet in Unit4 de status van de medewerker op Terminate. Omada houdt zelf statusgebeurtenissen bij en waarschuwt dat een HR-status die eigen wijzigingen kan overschrijven. We spreken vooraf af of de Unit4-status of Omada leidend is, en KoppelHet levert alleen de status die daarbij hoort.
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
Waarom leest Omada Unit4 niet rechtstreeks?
Het kan technisch, maar vraagt een Unit4-sleutel met brede rechten en logica voor datums en meer dienstverbanden. KoppelHet houdt die buiten Omada.
Wat gebeurt er met een tweede dienstverband?
Standaard telt alleen het hoofddienstverband. Een extra contexttoewijzing per tweede dienstverband kan later als uitbreiding.
Gaan er financiële of loongegevens naar Omada?
Nee. Alleen naam, status, bedrijf, eenheid, kostenplaats en functie.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Unit4 ERPx via de employees-API en de ObjectAPI met OAuth 2.0 client credentials via Unit4 Identity Services (scope u4erp, M2M-gebruiker met rol SUPER of SYSTEM, maximaal tien per tenant). Velden onder meer companyId, personId, personnelType, status, nameInformation (firstName, surname, aliasName), employments en relatedValues met dateFrom en dateTo; incrementeel op lastUpdated; 202 bij een invoer in workflow; DELETE zet de status op Terminate.
- Omada leest via de REST-collector met OAuth2 Client Credentials: identiteiten (Business key, Unique ID, Name, Status), contexten (Business key, Name, Type) en contexttoewijzingen (Context business key, Identity UID). Thresholds voor nieuwe, gewijzigde en verwijderde objecten staan standaard op 0 (uit); we zetten de drempel voor verwijderde objecten aan.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Unit4 HR | Veld in Omada | Toelichting |
|---|---|---|
companyId + personId | Business key en Unique ID | personId is uniek binnen een bedrijf |
nameInformation (aliasName of firstName, surname) | Name | |
status en einddatum hoofddienstverband | Status | |
Bedrijf | Context (type bedrijf) | |
Organisatie-eenheid (relatie op datum) | Context (type afdeling) en contexttoewijzing | |
Kostenplaats (relatie op datum) | Context (type kostenplaats) en contexttoewijzing | |
Functie van het hoofddienstverband | Identiteitsattribuut functie |
Gerelateerd
Greenhouse → Unit4 HR
Greenhouse Unit4 HR koppeling: geaccepteerd aanbod als medewerker in het juiste Unit4-bedrijf
Recruitee → Unit4 HR
Recruitee Unit4 HR koppeling: aangenomen kandidaat als medewerker in Unit4, gecontroleerd voordat hij wordt opgeslagen
SmartRecruiters → Unit4 HR
SmartRecruiters Unit4 HR koppeling: aanname op de positie uit SmartRecruiters, met onboardingstatus terug
Teamtailor → Unit4 HR
Teamtailor Unit4 HR koppeling: aangenomen kandidaten als medewerker in Unit4 ERPx, met bedrijf en positie