Leren en certificaten
UKG Pro GoodHabitz koppeling: GoodHabitz-trainingen als cursussen in UKG Pro en afgeronde trainingen als deelname
Met een koppeling tussen UKG Pro en GoodHabitz staat elke GoodHabitz-training als cursus in UKG Pro, en komt elke afgeronde of behaalde training daarna als deelname met resultaat en score bij de juiste medewerker in UKG Pro. Wie GoodHabitz mag gebruiken, volgt UKG Pro via jullie inlogomgeving.
Wat de koppeling doet
Organisaties met UKG Pro als HR-systeem en GoodHabitz als online trainingsaanbod zien in UKG Pro niet wat medewerkers bij GoodHabitz leren. HR haalt rapporten uit GoodHabitz en legt verplichte trainingen met de hand vast, of laat ze buiten de personeelsdossiers.
- KoppelHet registreert GoodHabitz eenmalig als extern leerplatform in UKG Pro.
- Elke training uit de GoodHabitz-catalogus wordt een cursus met één doorlopende sessie in UKG Pro.
- Toegang tot GoodHabitz loopt via single sign-on; de inlogomgeving volgt aanname en vertrek uit UKG Pro.
- KoppelHet haalt afgeronde trainingen en toetsen op, periode na periode, en zoekt de medewerker in UKG Pro op werkadres.
- Elke afronding wordt in één aanroep met andere afrondingen een deelname met status, resultaat, score en datum.
Terug: Afgeronde trainingen met afrondingsdatum · Toetsen met resultaat PASSED of FAILED en score
Waar je op let bij UKG Pro en GoodHabitz
- De Learning Courses API van UKG Pro is volgens de eigen omschrijving alleen om te schrijven. KoppelHet kan dus niet in UKG Pro opzoeken welke GoodHabitz-trainingen er al staan, en houdt zelf bij welk courseId bij welke GoodHabitz-training hoort.
- Een cursus in UKG Pro moet verwijzen naar een extern leerplatform. KoppelHet legt GoodHabitz één keer vast als dat platform en zet de content-ID van GoodHabitz in externalCourseId, zodat HR in UKG Pro kan zien waar een cursus vandaan komt.
- Een deelname in UKG Pro vraagt naast persoon en cursus ook een sessie, een vervaldatum en een afrondingsdatum. GoodHabitz-trainingen hebben geen sessies; KoppelHet maakt per cursus één doorlopende sessie en gebruikt de afrondingsdatum ook als vervaldatum.
- GoodHabitz meldt Finished, TestPassed en TestFailed, met een toetsscore van 0 tot 100. UKG Pro kent als resultaat alleen PASSED en FAILED en een score als geheel getal, dus de GoodHabitz-uitslag past er zonder omrekenen in; een afronding zonder toets krijgt geen resultaat.
- GoodHabitz geeft de duur als ISO-tekst zoals PT45M. UKG Pro rekent studiebelasting in CEU, minuten of uren. KoppelHet zet de duur om naar minuten, zodat HR in UKG Pro kan optellen hoeveel tijd een team aan training besteedt.
- UKG Pro kan veel deelnames in één aanroep aanmaken en geeft dan 207 terug als een deel mislukt. KoppelHet bundelt de afrondingen van een periode, leest per regel de uitkomst en zet alleen de mislukte regels opnieuw klaar.
- Haalt GoodHabitz een training uit het aanbod, dan zet KoppelHet de cursus in UKG Pro op niet zichtbaar en niet actief in plaats van hem te verwijderen. Eerdere deelnames blijven zo in het dossier van de medewerker staan.
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
Maakt de koppeling accounts aan in GoodHabitz?
Nee, de GoodHabitz-API kan dat niet. Toegang loopt via single sign-on, en wie daar mag inloggen, volgt UKG Pro.
Komen ook gestarte trainingen in UKG Pro?
Niet in de eerste versie: alleen afgeronde trainingen en toetsen. Voortgang van lopende trainingen kan later als uitbreiding.
Wat als een medewerker al uit dienst is als GoodHabitz een afronding meldt?
KoppelHet zoekt de medewerker ook onder vertrokken medewerkers op werkadres. Vindt hij niemand, dan meldt hij de afronding aan HR in plaats van hem weg te gooien.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- GoodHabitz API v2 met een API-sleutel via GoodHabitz support: GET /v2/contents (modified_since), /v2/deleted-contents, /v2/milestones en /v2/progress (test_score), per organisatie. Tijdvenster 0 tot 7 dagen; 10 verzoeken per minuut per sleutel en 20 per IP-adres. Geen endpoint om gebruikers aan te maken; toegang via SSO.
- UKG Pro Learning Courses API (write-only) met een JWT bearer token van de UKG OIDC-provider en de header global-tenant-id: POST /v1/learning/courses (externalLms verplicht, externalCourseId, creditType, url, isVisible, isActive), POST /v1/learning/course-sessions (course verplicht) en POST /v1/learning/course-participants/multi-create (person, course, courseSession, status, dueDate, completionDateTime verplicht; result PASSED of FAILED, score; 207 bij gedeeltelijk succes).
- Medewerkers via de UKG Pro Personnel API employee-changes (minimaal drie uur tussen aanroepen; emailAddress, personId, employeeId, terminationDate) met een serviceaccount en de US-Customer-Api-Key.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in UKG Pro | Veld in GoodHabitz | Toelichting |
|---|---|---|
content id | externalCourseId | KoppelHet bewaart ook het courseId van UKG |
title en description | title en description | |
duration (ISO-8601, bijvoorbeeld PT45M) | creditType MINUTES en creditValue | |
launch_urls.web.complete | url | |
localization.language | defaultLocaleCode | |
user_id (werkadres) | person | Via emailAddress uit employee-changes |
Finished, TestPassed, TestFailed | status, result PASSED of FAILED | |
test_score (0 tot 100) | score | |
timestamp | completionDateTime | |
deleted-contents | isVisible en isActive false |
Gerelateerd
Recruitee → UKG Pro
Recruitee UKG Pro koppeling: Europese aannames via de Global New Hire-service in UKG Pro
Teamtailor → UKG Pro
Teamtailor UKG Pro koppeling: Europese aannames als global new hire
UKG Pro → Active Directory
UKG Pro koppelen met Active Directory: domeinaccounts voor de Nederlandse vestiging
UKG Pro → ADP iHCM
UKG Pro ADP iHCM koppeling: salaris en uitdiensttreding van de Nederlandse paygroup naar ADP