Identity en access management
Visma Peple Active Directory koppeling: accounts vanuit Peple HRM & Payroll
Met een koppeling tussen Visma Peple en Active Directory krijgt een nieuwe medewerker uit Peple automatisch een account in Active Directory, in de map van zijn organisatie-eenheid en met functie en leidinggevende. Op de einddatum van zijn laatste contract in Peple verloopt het account.
Wat de koppeling doet
Organisaties die Peple gebruiken voor HR en salaris en een eigen Active Directory hebben, vaak gesynchroniseerd met Entra ID, verwerken in- en uitstroom met formulieren en handwerk. Bij veel tijdelijke contracten en invalkrachten loopt Active Directory dan achter, en verlopen contracten laten actieve accounts achter.
- IT installeert eenmalig het programma van KoppelHet op een server in het domein, en de organisatie geeft KoppelHet via Visma leestoegang tot de Reporting API.
- KoppelHet haalt de organisatie-eenheden uit Peple op en zet ze om naar mappen en groepen volgens de afspraken met IT.
- Voor een nieuwe medewerker maakt het programma een account aan in de map van zijn organisatie-eenheid, met gebruikersnaam volgens de naamgevingsregel.
- Wisselt het contract van eenheid of functie, dan verhuist het account en past het groepslidmaatschap zich aan.
- Het account krijgt de einddatum van het laatste contract als vervaldatum en gaat daarna naar de map voor vertrekkers.
Waar je op let bij Visma Peple en Active Directory
- Organisatie-eenheden in Peple hebben een bovenliggende eenheid en een eigen begin- en einddatum. KoppelHet bouwt daarmee de boom op en maakt alleen mappen en groepen voor eenheden die nog geldig zijn, zodat een opgeheven eenheid geen nieuwe accounts meer krijgt.
- Peple levert elke export als bestand dat pas na enige tijd klaarstaat, en kan KoppelHet een signaal sturen als dat zo is. Het programma in het domein wacht op dat signaal en hoeft Peple dus niet steeds opnieuw te vragen.
- Peple geeft alle datums in UTC. Een contract dat op 31 december eindigt, staat daardoor als 30 december 23:00 in de export. KoppelHet rekent terug naar Nederlandse tijd voordat het de vervaldatum in Active Directory zet, zodat niemand een dag te vroeg wordt buitengesloten.
- Medewerkers met meerdere contracten, zoals een vaste aanstelling en een tijdelijke uitbreiding bij een andere eenheid, staan in Peple met een apart contract per eenheid. KoppelHet zet het account in de map van het hoofdcontract en geeft daarnaast de groepen van de andere eenheden.
- In de contractgegevens van Peple wijst de leidinggevende naar een gebruikers-ID en niet naar een medewerker. Met het gebruikersoverzicht, waarin elk gebruikers-ID een personeelsnummer heeft, zoekt KoppelHet het account van de leidinggevende in Active Directory op.
- Volledige exports staat Peple maar twee keer per dag per onderdeel toe. De dagelijkse vergelijking tussen Peple en Active Directory gebruikt daarom één volledige export in de nacht; overdag werkt KoppelHet met de wijzigingen sinds de vorige ronde.
- Op zaterdagavond heeft Peple een onderhoudsvenster en weigert het tijdelijk nieuwe exports. KoppelHet wacht de aangegeven tijd af en probeert het daarna opnieuw, zodat een wijziging in dat venster niet verloren gaat.
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
Moet Peple bij ons netwerk kunnen?
Nee. Het signaal van Peple komt binnen op het KoppelHet platform, en het programma in jullie netwerk haalt de opdrachten daar op met een uitgaande verbinding.
Wat gebeurt er met invalkrachten die vaak terugkomen?
Die houden hetzelfde account. Bij een nieuw contract onder hetzelfde personeelsnummer zet KoppelHet het account weer aan en schuift de vervaldatum op.
Werkt dit ook met alleen Entra ID?
Ja. Dan schrijft KoppelHet rechtstreeks naar Entra ID; de regels voor contracten, eenheden en leidinggevenden blijven gelijk.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Peple wordt gelezen via de Visma.net HRM & Payroll Reporting API (Visma Connect, client credentials per tenant) met scopes voor employees, contracts, organization units en users. Exports met POST /v1/command/nl/hrm/... en optioneel callbackAddress; resultaat via GET /v1/query/nl/hrm/.../{jobId}; incrementeel met changeTimestampAfter en changeTimestampBefore; datums in UTC; 503 met Retry-After tijdens onderhoud (zaterdag rond 23:30 UTC).
- Een KoppelHet-agent in het domein voert de wijzigingen uit via een uitgaande verbinding. AD-attributen onder meer employeeID, sAMAccountName (maximaal 20 tekens), userPrincipalName, mail, givenName, sn, displayName, title, department, company, manager en accountExpires; OU per organisatie-eenheid en een OU voor vertrekkers.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Visma Peple | Veld in Active Directory | Toelichting |
|---|---|---|
employeeid | employeeID | |
Naamgevingsregel | sAMAccountName | Maximaal 20 tekens, uniek |
nickname en achternaam volgens nameusage | givenName, sn en displayName | |
businessemailaddress | mail en userPrincipalName | |
functionname | title | |
orgunit en orgunitparentid | OU en department | |
manageruserid | manager | Via het gebruikersoverzicht naar het account van de leidinggevende |
companyname | company | |
enddate van het laatste contract | accountExpires |
Gerelateerd
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
Visma Peple → Freshservice
Visma Peple koppelen met Freshservice: aanvragers per contract en verzoeken bij in- en uitdienst