
Recruitment naar HR
Bullhorn Personio koppeling: plaatsingen als persoon met dienstverband in Personio
Met een koppeling tussen Bullhorn en Personio wordt de eerste goedgekeurde plaatsing van een kandidaat een persoon met dienstverband in Personio, in de status onboarding, met startdatum, uren per week, entiteit en een interne of externe soort. Een volgende plaatsing van dezelfde persoon maakt geen nieuwe persoon aan, en een gewijzigde plaatsing gaat als melding naar HR.
Wat de koppeling doet
Organisaties die mensen via Bullhorn plaatsen en Personio als HR-systeem gebruiken, nemen elke nieuwe collega met de hand over in Personio. Bullhorn noemt uren per dag en de kostenplaats van de klant, Personio wil uren per week en een eigen kostenplaats, en HR rekent dat voor elke plaatsing om.
- De recruiter zet de Placement in Bullhorn op goedgekeurd.
- KoppelHet leest de plaatsing uit de eventwachtrij en kijkt of de kandidaat al in Personio staat.
- KoppelHet rekent de uren om en bepaalt entiteit, soort en kostenplaats met een tabel.
- Persoon en dienstverband komen in Personio in de status onboarding.
- Wijzigt de plaatsing daarna, dan krijgt HR een melding in plaats van een automatische wijziging.
Waar je op let bij Bullhorn en Personio
- Personio kent bij een dienstverband de soort intern of extern. Het soort medewerker in Bullhorn, met waarden als Employee of Contractor, vertaalt KoppelHet per waarde naar die soort, zodat een zzp'er in Personio niet als eigen medewerker meetelt.
- Bullhorn legt per plaatsing het aantal uren per dag vast, Personio de contracturen per week met twee decimalen. KoppelHet vermenigvuldigt met het aantal werkdagen per week dat in de tabel staat en vult de fulltime uren van de entiteit aan, zodat de deeltijdfactor klopt.
- Het kostenplaatsveld op een Bullhorn-plaatsing is dat van de klant en bepaalt de factuurgroepering. Personio verdeelt een medewerker over eigen kostenplaatsen met een weging die samen 100 is. KoppelHet neemt dus niet het klantveld, maar zet de eigen kostenplaats uit de tabel op 100.
- Een goedgekeurde plaatsing is in Bullhorn niet meer rechtstreeks aan te passen; een wijziging loopt via een change request met goedkeuring en kan een latere ingangsdatum voor het loon hebben. KoppelHet past Personio daarom niet automatisch aan, maar meldt HR wat er na goedkeuring is veranderd.
- Een kandidaat kan in Bullhorn meerdere plaatsingen na elkaar hebben, en Personio staat een e-mailadres maar bij één persoon toe. KoppelHet maakt alleen bij de eerste plaatsing een persoon aan en herkent latere plaatsingen aan het Bullhorn-kandidaatnummer in een eigen attribuut.
- Bij een tijdelijke plaatsing heeft Bullhorn een einddatum en soms een duur in weken; bij een vaste plaatsing is de einddatum leeg. KoppelHet zet bij een einddatum een taak voor HR om het contracteinde in Personio vast te leggen, omdat de opdracht en het contract niet altijd gelijk lopen.
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
Heeft Bullhorn een eigen Personio-koppeling?
Die vonden we niet in de openbare documentatie van Bullhorn of Personio. KoppelHet bouwt op de API's van beide.
Gaan contractors ook naar Personio?
Alleen als jullie dat willen, en dan als externe medewerker. Per soort in Bullhorn leggen we dat vast.
Doet Personio de Nederlandse salarisverwerking?
Nee. Personio levert gegevens aan een Nederlandse salarisadministratie; dat is een aparte koppeling.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Bullhorn via de REST API na OAuth 2.0 en een REST-login met BhRestToken. Event subscription op Placement (INSERTED en UPDATED), gelezen met GET event/subscription. Placement-velden status, employeeType, employmentStartDate, dateBegin, dateEnd, durationWeeks, hoursPerDay en costCenter (Client Cost Center); wijzigingen via PlacementChangeRequest met dateEffective. Candidate firstName, lastName en email.
- Personio via POST /v2/persons (scope personio:persons:write; first_name en last_name verplicht; e-mail uniek; employment met status ONBOARDING, employment_start_date, type INTERNAL of EXTERNAL, weekly_working_hours, full_time_weekly_working_hours, legal_entity en cost_centers met weging tot 100; custom_attributes met id en value).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Bullhorn | Veld in Personio | Toelichting |
|---|---|---|
Candidate.id | Eigen attribuut in Personio | Herkent een volgende plaatsing |
Candidate.firstName en lastName | first_name en last_name | |
Candidate.email | email | Uniek in Personio |
Placement.employmentStartDate (anders dateBegin) | employment_start_date | |
Placement.hoursPerDay | weekly_working_hours | Maal het afgesproken aantal werkdagen |
Placement.employeeType | type (INTERNAL of EXTERNAL) | Via een tabel per soort |
Bullhorn-kantoor van de plaatsing | legal_entity en cost_centers | Eigen kostenplaats met weging 100 |
Gerelateerd
Bullhorn → AFAS Profit
Bullhorn AFAS koppeling: eerste plaatsing van een consultant start de onboarding
Bullhorn → BambooHR
Bullhorn BambooHR koppeling: eerste plaatsing als medewerker met statusregel in BambooHR
Bullhorn → Dayforce
Bullhorn Dayforce koppeling: eerste plaatsing van een werknemer als medewerker in Dayforce
Bullhorn → Deel
Bullhorn Deel koppeling: eerste plaatsing als direct employee met contract in Deel