Identity en access management
Visma Peple Omada koppeling: medewerkers, contracten en invallers uit Peple als HR-bron in Omada
Met een koppeling tussen Visma Peple en Omada Identity leest Omada elke medewerker uit Peple als identiteit, met organisatie-eenheden als contexten, de leidinggevende en een status die volgt uit contracten en vervangingen. KoppelHet zet de exports van Peple om in een vaste lijst die de REST-collector van Omada bij elke import leest, zodat Omada rollen toekent en toegang intrekt.
Wat de koppeling doet
Organisaties die Visma Peple voor HR gebruiken en Omada voor identity governance, vinden in de Connectivity Directory van Omada geen connector voor Peple. Omada krijgt dan een handmatige export, waarin invallers en medewerkers met contracten bij meerdere eenheden niet goed uit de verf komen.
- In Visma Connect krijgt KoppelHet een client met alleen de exportscopes voor medewerkers, contracten, organisatie-eenheden en vervangingen.
- In Omada maakt de beheerder een REST-collector die het adres van KoppelHet leest, met OAuth2 Client Credentials.
- KoppelHet start de exports in Peple, haalt de bestanden op zodra ze klaarstaan en werkt de lijst bij.
- Omada leest identiteiten, contexten en contexttoewijzingen en past rollen aan.
- Na het laatste contract of de laatste vervanging staat de identiteit op beëindigd en trekt Omada toegang in.
Waar je op let bij Visma Peple en Omada
- Omada heeft geen connector voor Peple of voor andere Visma-HR-producten in de documentatie die we vonden. De REST-collector is voor zulke bronnen bedoeld. Peple levert gegevens echter als export die eerst gestart moet worden en later klaarstaat, en daar kan een collector niet op wachten. KoppelHet doet dat werk en houdt een lijst klaar die Omada direct leest.
- Een medewerker kan in Peple contracten bij meer organisatie-eenheden hebben. Bij geneste gegevens gebruikt de REST-collector alleen het eerste element van een lijst. KoppelHet levert daarom per eenheid een context en per contract een contexttoewijzing als platte regels, zodat Omada alle eenheden ziet en niet alleen de eerste.
- Peple heeft een aparte export voor vervangingen, met begin- en einddatum. KoppelHet geeft een invaller zonder eigen lopend contract de status actief zolang de vervanging loopt en daarna beëindigd, zodat Omada toegang van invallers op de einddatum van de vervanging intrekt.
- In Peple staat de leidinggevende als gebruikers-ID bij het contract. Omada heeft voor goedkeuringen en reviews de business key van de identiteit van de leidinggevende nodig. KoppelHet zoekt bij dat gebruikers-ID het personeelsnummer op, dat ook de business key is.
- Peple weigert exports tijdelijk tijdens onderhoud op zaterdagavond en staat twee volledige exports per dag per onderdeel toe. De drempels voor verwijderde objecten in de REST-collector staan standaard uit. KoppelHet blijft de laatste volledige stand tonen als een export mislukt, en we raden aan in Omada een drempel voor verwijderingen in te stellen.
- Omada waarschuwt dat een status uit de HR-bron statuswijzigingen in Omada zelf kan overschrijven. Bij invallers wisselt de status vaker dan bij vaste medewerkers. Met jullie leggen we vast dat een blokkade die security in Omada zet voorrang houdt op de volgende import uit Peple.
- Peple geeft het zakelijke e-mailadres zonder extra scope; privécontactgegevens en BSN vragen een eigen scope. KoppelHet vraagt die scopes niet aan, zodat Omada alleen werkgegevens leest en een privéadres nooit in een identiteit belandt.
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 daarna zelf accounts maken in Entra ID of Active Directory?
Ja, met de connectoren van Omada. KoppelHet levert alleen de HR-bron.
Komen BSN of privéadres in Omada?
Nee. De koppeling vraagt de scopes voor contact- en belastinggegevens niet aan.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Peple via de Visma.net HRM & Payroll Reporting API (Visma Connect client credentials) met scopes voor de exports van employees, contracts, organizationunits en employeereplacement (POST command, GET query op jobId); incrementeel met changeTimestampAfter; twee volledige refreshes per endpoint per tenant per 24 uur; 503 met Retry-After tijdens onderhoud. Geen exportcontactinformation of exporttaxinformation.
- Omada leest via de REST-collector (Content: Identity data) met OAuth2 Client Credentials: identiteiten met Business key, Unique ID, Name en Status, contexten met business key, Name en Type, en context assignments per identiteit. Paginering via Link-header (rel=next); Thresholds voor nieuwe, gewijzigde en verwijderde objecten in procenten (standaard 0, uit); Error message JSON path voor foutmeldingen.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Visma Peple | Veld in Omada | Toelichting |
|---|---|---|
Personeelsnummer | Business key en Unique ID | Vast, verandert nooit |
Voornaam en achternaam volgens nameusage | Name, First name en Last name | |
businessemailaddress | Email | |
functionname (hoofdcontract) | Job title | |
orgunit met naam | Context met business key, Name en Type | |
Contracten per orgunit | Context assignments | |
manageruserid | Manager | Omgezet naar het personeelsnummer |
Contract- en vervangingsdatums | Status (active, inactive, terminated) |
Gerelateerd
Visma Peple → Active Directory
Visma Peple Active Directory koppeling: accounts vanuit Peple HRM & Payroll
ASVisma Peple → Arbodienst (SIVI)
Visma Peple arbodienst koppeling via SIVI: ziek- en herstelmeldingen uit Peple naar de arbodienst
Visma Peple → Microsoft Entra ID
Visma Peple Entra ID koppeling: Microsoft-accounts vanuit Peple HRM & Payroll
Visma Peple → Exact Online
Visma Peple Exact Online koppeling: kostenplaatsen klaar in Exact en medewerkerswijzigingen op een werklijst