Leren en certificaten
Loket GoodHabitz koppeling: afgeronde GoodHabitz-trainingen als opleiding bij de werknemer in Loket
Met een koppeling tussen Loket en GoodHabitz komt elke GoodHabitz-training die een medewerker afrondt automatisch als opleiding bij de juiste werknemer in Loket, met begin- en einddatum en of de toets is gehaald. Wie toegang tot GoodHabitz krijgt, regelt jullie inlogomgeving; de koppeling zorgt dat het opleidingsoverzicht in Loket compleet is zonder overtypen.
Wat de koppeling doet
Organisaties die hun salarisadministratie in Loket doen en medewerkers online laten leren bij GoodHabitz, hebben geen overzicht van gevolgde trainingen bij het personeelsdossier. HR haalt rapporten uit GoodHabitz en zet afgeronde trainingen met de hand bij de werknemer, of laat het liggen.
- Medewerkers openen GoodHabitz via de inlogomgeving of het leerplatform van de organisatie, met hun zakelijke e-mailadres.
- Elke dag haalt KoppelHet de mijlpalen van het afgelopen tijdvak op bij GoodHabitz.
- KoppelHet zoekt bij elk e-mailadres de werknemer en zijn werkgever in Loket.
- Een afgeronde training komt als opleiding bij de werknemer, met de soort GoodHabitz, begin- en einddatum en of de toets is gehaald.
- Hoort een e-mailadres bij niemand in Loket, dan krijgt HR een melding in plaats van een gok.
Terug: Afgeronde training als opleiding met data en diploma ja of nee
Waar je op let bij Loket en GoodHabitz
- GoodHabitz kent in zijn API geen eigen gebruikers; een voortgangsregel draagt het ID dat bij het openen van de training is meegegeven, meestal het e-mailadres. Loket heeft per werknemer een zakelijk e-mailadres. KoppelHet koppelt op dat adres, zodat het werkadres in Loket en in de inlogomgeving hetzelfde moet zijn.
- Een opleiding in Loket heeft een naam van hooguit 50 tekens, en een GoodHabitz-titel kan langer zijn. KoppelHet kort de naam in en zet de volledige titel met het GoodHabitz-ID in het veld bijzonderheden, dat 4.000 tekens toestaat.
- De soort opleiding is in Loket een lijst die per werkgever wordt beheerd. Bij meerdere werkgevers zorgt KoppelHet dat de soort GoodHabitz bij elke werkgever bestaat, zodat HR per werkgever kan filteren op online trainingen.
- GoodHabitz meldt per training de mijlpalen gestart, afgerond, toets gehaald en toets niet gehaald. Loket heeft bij een opleiding een begin- en einddatum en een veld voor een behaald diploma. KoppelHet vult het diploma alleen bij een gehaalde toets, zodat een afgeronde training zonder toets niet als gediplomeerd telt.
- GoodHabitz levert mijlpalen alleen over een tijdvak van hooguit zeven dagen, en staat tien verzoeken per minuut per sleutel toe. KoppelHet vraagt elke dag een overlappend tijdvak op en slaat dubbele mijlpalen over, zodat een dag storing geen afronding laat verdwijnen.
- GoodHabitz meldt mijlpalen voor trainingen, losse lessen en toetsen. Alleen afgeronde trainingen gaan naar Loket, zodat het opleidingsoverzicht van een werknemer niet volloopt met tientallen lessen.
- Haalt GoodHabitz een training uit de catalogus, dan staat die in een aparte lijst met verwijderde content. KoppelHet laat een eerder vastgelegde opleiding in Loket dan staan, omdat de medewerker hem wel heeft gevolgd.
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 ook GoodHabitz-accounts aan?
Nee. De API van GoodHabitz kan geen gebruikers aanmaken. Toegang loopt via single sign-on of jullie leerplatform; daar bepaalt Loket of de identity provider wie mag inloggen.
Gaan ook gedeeltelijk gevolgde trainingen naar Loket?
Niet in de eerste versie. Alleen afgeronde trainingen komen in Loket. Voortgang per afdeling rapporteren kan later als uitbreiding.
Werkt dit als een salarisbureau Loket voor ons beheert?
Ja. Het bureau geeft de koppeling toegang tot jullie werkgevers, met recht om opleidingen bij werknemers vast te leggen.
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 key in de header X-API-Key (aan te vragen bij GoodHabitz). GET /v2/milestones met timestamp_since en timestamp_until (tijdvak 0 tot 7 dagen, niet later dan nu), per organization_id met user_id, content_id, content_type (Course, Lesson, Assessment) en event (Started, Finished, TestPassed, TestFailed). Titels via GET /v2/contents, verwijderde content via GET /v2/deleted-contents. Rate limit 10 verzoeken per sleutel en 20 per IP in 60 seconden.
- Loket via de REST API met OAuth 2.0 (authorization code met refresh token). Werknemers per werkgever (businessEmailAddress, employeeNumber); opleidingssoorten met GetEducationTypesByEmployerId en PostEducationTypeByEmployerId; opleidingen met GetEducationsByEmployeeId en PostEducationByEmployeeId (name tot 50 tekens, typeOfEducation, institute, startDate, endDate, hasDiploma, particularities tot 4.000 tekens). Keuzewaarden via /metadata op de POST-URL.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Loket | Veld in GoodHabitz | Toelichting |
|---|---|---|
user_id (GoodHabitz) | businessEmailAddress (Loket) | Het ID dat bij het openen van GoodHabitz wordt meegegeven, meestal het werkadres |
Titel uit de contentcatalogus | name | Ingekort tot 50 tekens |
Volledige titel en content_id | particularities | |
Mijlpaal Started | startDate | |
Mijlpaal Finished | endDate | |
Mijlpaal TestPassed of TestFailed | hasDiploma | |
Vaste waarde GoodHabitz | typeOfEducation en institute.name | Opleidingssoort per werkgever |
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