Identity en access management
Loket Omada koppeling: werknemers uit Loket.nl als identiteiten in Omada Identity, per werkgever
Met een koppeling tussen Loket.nl en Omada Identity leest Omada elke werknemer uit Loket als identiteit, met werkgever en organisatorische eenheid als context en een status die volgt uit het dienstverband. KoppelHet beheert de toestemming bij Loket en biedt per werknemer één regel aan die de REST-collector van Omada direct inleest, zonder loon- of bankgegevens.
Wat de koppeling doet
Organisaties die hun salarisadministratie in Loket.nl hebben, vaak via een salarisbureau, en toegang met Omada regelen, krijgen werknemers meestal via een export in Omada. Die export volgt de loonstrook en niet de organisatie, en een salarisbureau dat de export voor meerdere werkgevers draait, levert soms een bestand met werknemers van één werkgever te weinig.
- Een eigen Loket-gebruiker met alleen leesrechten op jullie werkgevers geeft KoppelHet eenmalig toestemming.
- KoppelHet leest per werkgever de werknemers, dienstverbanden en organisatorische eenheden.
- KoppelHet biedt op een eigen beveiligd adres drie collecties aan, identiteiten, contexten en contexttoewijzingen.
- De REST-collector van Omada leest dat adres met OAuth2 Client Credentials en Omada kent rollen toe op context.
- Na het einde van het laatste dienstverband wordt de status beëindigd en trekt Omada de toegang in.
Waar je op let bij Loket en Omada
- Loket geeft toegang via de toestemming van een Loket-gebruiker, met een authorization code en een refresh token. De REST-collector van Omada kent onder meer client credentials en een wachtwoordflow, maar niet die authorization code. KoppelHet beheert de toestemming bij Loket en biedt Omada een eigen adres met client credentials.
- Omada kan naast identiteiten ook contexten inlezen, elk met een sleutel, naam en type, en toewijzingen van identiteiten aan die contexten. KoppelHet maakt van elke Loket-werkgever en elke organisatorische eenheid een context, zodat rollen en eigenaarschap in Omada per werkgever en afdeling kunnen.
- Een personeelsnummer in Loket is alleen binnen één werkgever uniek. Omada eist een unieke sleutel per identiteit; KoppelHet zet de werkgevercode voor het nummer, zodat werknemers van twee werkgevers bij hetzelfde salarisbureau nooit op één identiteit samenvallen.
- Dienstverbanden staan in Loket als een keten van perioden, soms met een gat ertussen. Omada kent de statussen actief, inactief en beëindigd. KoppelHet zet een werknemer in een gat tussen twee perioden op inactief en pas na de laatste periode op beëindigd, zodat een herintreder zijn identiteit en historie in Omada houdt.
- Een werknemer kan in Loket eerst als concept bestaan, als sollicitant die nog niet is omgezet. KoppelHet neemt alleen omgezette werknemers op in wat Omada leest, zodat een aanbod dat niet doorgaat geen identiteit oplevert die rollen en goedkeuringen in gang zet.
- Verliest de Loket-gebruiker van het salarisbureau de rechten op één werkgever, dan ontbreken al diens werknemers ineens. De drempel op verwijderde objecten staat in Omada standaard uit. We zetten die drempel aan en KoppelHet levert geen collectie als een werkgever die gisteren werknemers had nu leeg terugkomt.
- Loket stuurt meldingen over wijzigingen alleen per e-mail aan mensen. KoppelHet vraagt daarom per werkgever de vastgelegde wijzigingen op, zodat de collectie die Omada inleest bij elke geplande import de stand van die ochtend toont.
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 Omada niet zelf bij Loket aanmelden?
Loket werkt met toestemming van een gebruiker, en die vorm staat niet tussen de opties van de REST-collector. KoppelHet neemt dat deel over.
Werkt dit als ons salarisbureau in Loket werkt?
Ja. De koppeling krijgt een eigen Loket-gebruiker met alleen leesrechten op jullie werkgevers.
Gaan er loongegevens naar Omada?
Nee. Alleen naam, nummer, werkgever, eenheid, functie en de status uit het dienstverband.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Loket wordt gelezen via de Loket REST API (oauth.loket.nl, authorization code en refresh token; geen client credentials) onder /v2/providers/employers/{employerId}/employees, de dienstverbanden met begin- en einddatum en de organisatorische eenheden; paginering met pageNumber en pageSize. Event notifications zijn alleen e-mailontvangers. Geen BSN, loon of bankgegevens in de uitvoer.
- Omada leest via de REST-collector met OAuth2 Client Credentials. Identiteiten met Business key, Unique ID, Name en Status; contexten met Business key, Name en Type; contexttoewijzingen met Context business key en Identity UID. Status kent in Enterprise Server actief, inactief en beëindigd; Thresholds voor nieuwe, gewijzigde en verwijderde objecten (standaard 0, uit).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Loket | Veld in Omada | Toelichting |
|---|---|---|
Werkgevercode + employeeNumber | Business key en Unique ID | Verplicht voor identiteiten |
firstName, prefix en lastName volgens naamgebruik | Name | Verplicht |
Begin- en einddatum in de keten van dienstverbanden | Status | Afgeleid door KoppelHet |
Werkgever | Context (Business key, Name, Type werkgever) | |
Organisatorische eenheid | Context (Business key, Name, Type afdeling) | |
Werkgever en eenheid van de werknemer | Contexttoewijzing (Context business key, Identity UID) | |
Functie | Identiteitsattribuut functie |
Gerelateerd
ADP Workforce Now → Loket
ADP Workforce Now koppelen met Loket: aanname, loon, uren en bonussen uit ADP naar de Nederlandse loonrun
AlexisHR → Loket
AlexisHR Loket koppeling: medewerkers van het Nederlandse bedrijf uit AlexisHR in de salarisadministratie
BambooHR → Loket
BambooHR koppelen met Loket: HR-mutaties uit BambooHR voor de Nederlandse salarisverwerking
Bullhorn → Loket
Bullhorn Loket koppeling: plaatsing als conceptwerknemer in de juiste loonadministratie