Recruitment naar HR
Bullhorn BambooHR koppeling: eerste plaatsing als medewerker met statusregel in BambooHR
Met een koppeling tussen Bullhorn en BambooHR wordt de eerste goedgekeurde plaatsing van een kandidaat een medewerker in BambooHR, met indiensttredingsdatum en een eerste statusregel die het soort medewerker uit Bullhorn volgt. Heeft de plaatsing een einddatum, dan zet KoppelHet een taak voor HR klaar, omdat BambooHR een einddatum bij het aanmaken negeert.
Wat de koppeling doet
Organisaties die via Bullhorn mensen plaatsen en BambooHR voor hun eigen personeel gebruiken, nemen na elke eerste plaatsing de nieuwe collega met de hand op in BambooHR. Of iemand vast, tijdelijk of als zzp'er werkt, staat in Bullhorn, maar moet in BambooHR opnieuw worden gekozen.
- De recruiter keurt de Placement in Bullhorn goed.
- KoppelHet leest de plaatsing en kijkt of de kandidaat al medewerker is in BambooHR.
- Bij een eerste plaatsing maakt KoppelHet de medewerker aan met een statusregel op de startdatum.
- Heeft de plaatsing een einddatum, dan krijgt HR een taak om het contracteinde vast te leggen.
- Een waarde die BambooHR weigert, of een volgende plaatsing, komt als melding bij HR.
Waar je op let bij Bullhorn en BambooHR
- Een BambooHR-koppeling van Bullhorn vonden we niet in de BambooHR Marketplace; een listing voor Bullhorn bestaat daar niet. KoppelHet leest de plaatsingen uit de eventwachtrij van Bullhorn en maakt de medewerker aan met de API van BambooHR.
- BambooHR maakt een medewerker zonder dienstverbandstatus aan als die niet wordt meegegeven. Het soort medewerker op de Bullhorn-plaatsing, zoals Employee of Contractor, vertaalt KoppelHet naar een waarde uit de statuslijst van BambooHR, met de startdatum als datum van de regel.
- Een tijdelijke plaatsing heeft in Bullhorn een einddatum, een vaste plaatsing niet. BambooHR negeert een einddatum en een soort dienstverband bij het aanmaken van een medewerker zonder foutmelding. KoppelHet zet het contracteinde daarom als taak bij HR, in plaats van te denken dat het is opgeslagen.
- Een lijstveld in BambooHR met een waarde die niet in de lijst staat, geeft een conflictfout. Bullhorn-waarden zoals het soort medewerker zijn per installatie in te richten, dus KoppelHet controleert elke waarde tegen de tabel en meldt een nieuwe waarde aan HR.
- Dezelfde kandidaat kan in Bullhorn meerdere plaatsingen na elkaar hebben. KoppelHet zet het Bullhorn-kandidaatnummer in een eigen veld in BambooHR en zoekt daar eerst op, zodat een volgende opdracht geen tweede medewerker oplevert.
- Bullhorn onderscheidt de begindatum van het werk en de dag waarop het betaalde dienstverband ingaat. KoppelHet gebruikt de tweede als indiensttreding in BambooHR en als datum van de eerste statusregel; zonder die datum valt KoppelHet terug op de begindatum.
- Wijzigingen aan een goedgekeurde plaatsing lopen in Bullhorn via een wijzigingsverzoek met een eigen ingangsdatum. KoppelHet werkt BambooHR daarom niet vanzelf bij, maar stuurt HR na goedkeuring wat er is veranderd.
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
Komen zzp'ers ook in BambooHR?
Dat kiezen jullie per soort medewerker in de tabel. Ze krijgen dan een eigen status in BambooHR.
Gaat het salaris van de plaatsing mee?
Niet in de eerste versie. Een salarisregel uit bedrag en eenheid van de plaatsing kan later als uitbreiding.
Wat als de opdracht wordt verlengd?
Dan krijgt HR een melding met de nieuwe einddatum en past die het contract in BambooHR aan.
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) met GET event/subscription. Placement status, employeeType, employmentStartDate, dateBegin en dateEnd; PlacementChangeRequest met dateEffective; Candidate firstName, lastName, email en mobile.
- BambooHR via POST /api/v1/employees (firstName en lastName verplicht; employmentHistoryStatus met employeeStatusDate, anders hireDate; employmentType en terminationDate worden genegeerd; 409 bij een ongeldige lijstwaarde). OAuth 2.0 met employee.write of basic auth met een API-sleutel.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Bullhorn | Veld in BambooHR | Toelichting |
|---|---|---|
Candidate firstName en lastName | firstName en lastName | |
Candidate email | homeEmail | |
Candidate mobile | mobilePhone | |
Placement employmentStartDate | hireDate en employeeStatusDate | |
Placement employeeType | employmentHistoryStatus | Vertaaltabel naar de statuslijst in BambooHR |
Placement dateEnd | Taak voor HR | Leeg bij een vaste plaatsing |
Candidate id | Eigen veld met het Bullhorn-nummer |
Gerelateerd
Bullhorn → AFAS Profit
Bullhorn AFAS koppeling: eerste plaatsing van een consultant start de onboarding
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
Bullhorn → HiBob
Bullhorn HiBob koppeling: een goedgekeurde plaatsing als nieuwe medewerker in Bob