Recruitment naar HR
Teamtailor koppelen met HoorayHR: aangenomen kandidaten als nieuwe collega in HoorayHR
Met een koppeling tussen Teamtailor en HoorayHR wordt een kandidaat die in Teamtailor naar de gekozen stap gaat automatisch een nieuwe medewerker in HoorayHR, met naam, e-mail, startdatum, functie, entiteit en team. KoppelHet haalt die uit het aanbod en de vacature in Teamtailor en zet het getekende contract als intern document klaar.
Wat de koppeling doet
Organisaties die in Teamtailor werven en HoorayHR gebruiken voor personeelsdossier, verlof en verzuim, zetten nieuwe collega's met de hand over in HoorayHR. Startdatum, functie en team vult HR opnieuw in, en bij meerdere entiteiten moet iemand de nieuwe collega op de goede plek zetten.
- Een beheerder in HoorayHR maakt een API-sleutel met de scopes voor medewerkers en documenten.
- De recruiter zet de kandidaat in Teamtailor op de gekozen stap.
- KoppelHet haalt kandidaat, vacature en aanbod op en maakt de medewerker aan in HoorayHR, met het getekende contract als intern document.
- De medewerker staat in HoorayHR als niet uitgenodigd; HR vult aan en een beheerder stuurt de uitnodiging.
Waar je op let bij Teamtailor en HoorayHR
- Wij raden af BSN en bankrekening in het wervingssysteem te verzamelen. HoorayHR heeft een eigen onboarding waarin de nieuwe collega ze zelf invult.
- HoorayHR accepteert startdatum, functie, entiteit en team bij het aanmaken van een medewerker. KoppelHet haalt ze uit het aanbod en de vacature in Teamtailor, zodat HR ze niet opnieuw invoert.
- HoorayHR houdt tussenvoegsel en achternaam apart, Teamtailor kent alleen voor- en achternaam. KoppelHet haalt het tussenvoegsel uit de achternaam, zodat sorteren en zoeken in HoorayHR op de achternaam werkt.
- Medewerkers zijn in de API van HoorayHR aan te maken maar niet te wijzigen, en zoeken kan alleen op ID. Een verschoven startdatum na de aanname past HR dus zelf aan, en KoppelHet onthoudt per kandidaat welke HoorayHR-medewerker is aangemaakt, zodat een tweede stapwijziging geen dubbele collega oplevert.
- HoorayHR kan via de API documenten bij een medewerker zetten, als intern of als zichtbaar voor de medewerker. KoppelHet zet het getekende contract uit Teamtailor als intern document in de juiste map, zodat de nieuwe collega het pas ziet als HR het publiceert.
- Geslacht, burgerlijke staat en land moeten in HoorayHR uit een vaste lijst komen. Een vrij ingevulde waarde in Teamtailor past daar niet altijd in. KoppelHet vertaalt de antwoorden en meldt een onbekende waarde aan HR.
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 de nieuwe collega direct inloggen in HoorayHR?
Nee. Via de API aangemaakte medewerkers staan op niet uitgenodigd; een beheerder in HoorayHR stuurt de uitnodiging.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- KoppelHet leest Teamtailor via de company webhook job_application.update (handtekening v2 in TT-Signature; volgens de docs geen herhaling, daarom ook een controle per uur) en de Teamtailor API voor kandidaat, vacature en aanbod. HoorayHR via POST /users (email verplicht; firstName, insertion, lastName, gender, companyStartDate, jobTitle, entityId, teams als lijst van team-ID's) en POST /documents (userId, categoryId, fileData in Base64, status INTERNAL of PUBLISHED). API-sleutel van een beheerder met scopes en vervaldatum.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Teamtailor | Veld in HoorayHR | Toelichting |
|---|---|---|
first-name en last-name | firstName, insertion en lastName | KoppelHet splitst het tussenvoegsel |
email | email | Verplicht aan beide kanten |
phone | phone | |
Eigen veld geslacht | gender | Alleen waarden uit de lijst van HoorayHR |
Startdatum uit het aanbod | companyStartDate | |
Functie van de vacature | jobTitle | |
Afdeling of locatie van de vacature | entityId en teams |
Gerelateerd
Teamtailor → ADP Workforce Now
Teamtailor ADP Workforce Now koppeling: aangenomen kandidaten als in-progress hire
Teamtailor → AFAS Profit
Teamtailor AFAS koppeling: aangenomen kandidaten direct als nieuwe medewerker
Teamtailor → BambooHR
Teamtailor BambooHR koppeling: aangenomen kandidaten als medewerker in BambooHR
Teamtailor → BuddeeHR
Teamtailor Buddee koppeling: aangenomen kandidaat als nieuwe medewerker in BuddeeHR