Leren en certificaten
Sympa GoodHabitz koppeling: afgeronde GoodHabitz-trainingen als rij in de opleidingstabel van Sympa
Met een koppeling tussen Sympa en GoodHabitz komt elke afgeronde of behaalde GoodHabitz-training automatisch als rij in de opleidingstabel van de medewerker in Sympa, met datum, uitslag en duur. Wie GoodHabitz mag gebruiken, volgt Sympa via jullie inlogomgeving.
Wat de koppeling doet
Organisaties die Sympa als HR-systeem gebruiken en GoodHabitz als online trainingsaanbod, houden opleidingen in Sympa met de hand bij of helemaal niet. Wat medewerkers bij GoodHabitz afronden, ontbreekt dan in het dossier en in de opleidingsrapportage van Sympa.
- De Sympa-beheerder maakt een API-interface op de medewerkers, met het werkadres als unieke sleutel en de opleidingstabel als veld.
- KoppelHet haalt afgeronde trainingen en toetsen op uit GoodHabitz, periode na periode, met de titel en duur uit de catalogus.
- Alle afrondingen van een dag gaan in één verzoek naar Sympa, als nieuwe rijen bij de juiste medewerkers.
- KoppelHet controleert de foutmelding per veld en zet geweigerde rijen opnieuw klaar of meldt ze aan HR.
- Toegang tot GoodHabitz loopt via single sign-on en volgt aanname en vertrek in Sympa.
Terug: Afgeronde trainingen met datum en duur · Toetsen met uitslag en score
Waar je op let bij Sympa en GoodHabitz
- Sympa heeft geen vaste veldenlijst voor de API: een beheerder stelt per interface in welke velden en tabellen erin zitten. KoppelHet vraagt een interface met alleen het werkadres en de opleidingstabel, met schrijfrecht, zodat de koppeling geen andere HR-gegevens kan lezen.
- Sympa staat standaard honderd verzoeken per uur per interface toe, voor lezen en schrijven samen. Eén verzoek kan wel rijen voor veel medewerkers tegelijk toevoegen. KoppelHet bundelt daarom alle GoodHabitz-afrondingen van een dag in één verzoek, in plaats van één verzoek per training.
- Rijen die via de API in Sympa komen, krijgen direct de status goedgekeurd. Een GoodHabitz-afronding komt zo zonder goedkeuringsstap in het dossier; KoppelHet stuurt daarom alleen afgeronde en behaalde trainingen, geen gestarte.
- De Sympa-API kan niets verwijderen. Haalt GoodHabitz een training uit het aanbod, dan blijven eerdere rijen in Sympa gewoon staan, wat voor het dossier ook de bedoeling is.
- Een keuzelijst in Sympa accepteert via de API alleen waarden die in de mappingtabel van de interface staan. KoppelHet zet de GoodHabitz-categorieën daarom bij de start in die tabel; een nieuwe categorie meldt hij aan de beheerder in plaats van de rij te laten mislukken.
- Sympa leest via de API uit een rapportagedatabase, waar nieuwe rijen meestal binnen een minuut en soms pas na dertig minuten staan. KoppelHet houdt zelf bij welke GoodHabitz-afrondingen al zijn verstuurd, en controleert niet direct na het schrijven met een leesverzoek.
- Een datumveld in Sympa neemt alleen een datum zonder tijd, en een getal alleen met een punt als decimaalteken. GoodHabitz levert tijdstempels in UTC en duur als ISO-tekst; KoppelHet zet een late afronding om naar de Nederlandse datum en de duur naar uren, zoals 0.75.
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 Sympa.
Hebben we al een opleidingstabel in Sympa nodig?
Ja, een tabel op de medewerkerkaart waarin opleidingen staan. Hoe die heet en welke kolommen hij heeft, verschilt per inrichting; dat stemmen we bij de start af.
Wat als een medewerker niet in Sympa te vinden is?
Sympa weigert dan de rij voor die medewerker. KoppelHet meldt de afronding aan HR, met het werkadres uit GoodHabitz, 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.
- Sympa Integration API op https://api.sympahr.net/api met een API-sleutel (X-ApiKey of basic): PATCH op de interface met @context #$delta en per medewerker de tabel met suffix @delta om rijen voor meerdere medewerkers in één verzoek toe te voegen. Rijen worden goedgekeurd ingevoegd; geen Delete. Antwoord 204 bij succes, anders code, message en fieldErrors. 100 verzoeken per uur per interface; het API-logboek toont de laatste tien verzoeken.
- GoodHabitz API v2 met een API-sleutel via GoodHabitz support: /v2/contents (title, duration, category), /v2/milestones (Finished, TestPassed, TestFailed) en /v2/progress (test_score). Tijdvenster 0 tot 7 dagen; 10 verzoeken per minuut per sleutel. Geen endpoint om gebruikers aan te maken; toegang via SSO met SAML 2.0.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Sympa | Veld in GoodHabitz | Toelichting |
|---|---|---|
user_id (werkadres) | Unieke sleutel van de interface (e-mailadres) | |
content title | Naam van de opleiding | |
category.name | Soort opleiding (keuzelijst) | Waarde moet in de mappingtabel van de interface staan |
timestamp van Finished of TestPassed | Datum (yyyy-MM-dd) | |
duration (ISO-8601) | Duur in uren (getal met punt) | |
TestPassed of TestFailed | Geslaagd ja of nee | |
test_score (0 tot 100) | Score | |
GoodHabitz | Aanbieder |
Gerelateerd
Greenhouse → Sympa
Greenhouse Sympa koppeling: aangenomen kandidaat als datakaart met contractregel in Sympa
Recruitee → Sympa
Recruitee Sympa koppeling: aangenomen kandidaten als datakaart in Sympa
SmartRecruiters → Sympa
SmartRecruiters Sympa koppeling: klaar voor onboarding wordt een datakaart in Sympa
Sympa → 4PS Construct
Sympa 4PS Construct koppeling: monteurs van de Nederlandse werkgever uit Sympa in 4PS, met kostenplaats als dimensie