Recruitment naar HR
Carerix BambooHR koppeling: geslaagde plaatsing als medewerker met dienstverbandstatus in BambooHR
Met een koppeling tussen Carerix en BambooHR wordt een kandidaat met een geslaagde match in Carerix een medewerker in BambooHR, met indiensttredingsdatum, afdeling, functie en een eerste regel in de dienstverbandstatus die de contractsoort uit Carerix volgt. KoppelHet kijkt elk kwartier naar gewijzigde matches in Carerix, omdat Carerix een plaatsing niet zelf doorgeeft.
Wat de koppeling doet
Organisaties die in Carerix werven en BambooHR als HR-systeem gebruiken, nemen elke geslaagde plaatsing met de hand over. Afdeling, functie en contractsoort staan in Carerix als keuzelijsten met eigen namen, en BambooHR accepteert alleen de opties uit de eigen lijsten.
- De recruiter zet de match in Carerix op een status voor een geslaagde plaatsing.
- KoppelHet haalt elk kwartier de gewijzigde matches op en leest kandidaat en vacature.
- KoppelHet vertaalt de Carerix-keuzes naar geldige opties in BambooHR.
- KoppelHet maakt de medewerker aan in BambooHR en bewaart het ID dat BambooHR teruggeeft.
- Daarna zet KoppelHet de contractsoort als regel in de tabel met dienstverbandstatus.
Waar je op let bij Carerix en BambooHR
- BambooHR accepteert bij het aanmaken van een medewerker het veld voor de soort dienstverband, maar slaat het stil niet op. De contractsoort uit de Carerix-vacature zet KoppelHet daarom na het aanmaken als aparte regel in de tabel met dienstverbandstatus, met de startdatum als ingangsdatum.
- Lijstvelden in BambooHR, zoals afdeling en functie, accepteren alleen bestaande opties; een onbekende waarde geeft een fout. In Carerix zijn afdeling en functie datanodes met eigen namen. KoppelHet haalt de opties van BambooHR op en houdt een tabel bij van Carerix-node naar BambooHR-optie.
- BambooHR geeft bij een nieuwe medewerker een ID terug, en raadt aan dat te gebruiken in plaats van het personeelsnummer. KoppelHet bewaart dat ID bij het Carerix-matchnummer, zodat een tweede statuswijziging op dezelfde match geen tweede medewerker oplevert.
- Carerix legt het tussenvoegsel apart vast, BambooHR heeft voornaam en achternaam. KoppelHet zet het tussenvoegsel vooraan in de achternaam, zodat de naam in BambooHR overeenkomt met het identiteitsbewijs.
- Een pasfoto meesturen bij het aanmaken heeft geen zin; BambooHR negeert fotovelden daar zonder foutmelding. Foto's en het cv uit Carerix blijven in de eerste versie in Carerix, en meesturen als bestand kan later als uitbreiding.
- Carerix kent per vacature een veld voor uren per week en per match een salaris met eenheid. BambooHR legt beide vast in eigen tabellen met ingangsdatum; in de eerste versie gaan ze als taak naar HR, zodat de compensatie in BambooHR niet op een verkeerde eenheid komt.
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 Carerix een eigen BambooHR-koppeling?
Die vonden we niet in de openbare documentatie van Carerix of BambooHR. KoppelHet bouwt op de API's van beide.
Wat als er in BambooHR een nieuwe afdeling bijkomt?
Dan vult HR de vertaaltabel aan. Tot die tijd stopt een plaatsing met die afdeling met een melding.
Komen BSN en bankrekening uit Carerix?
Nee, standaard niet. De medewerker of HR vult ze in BambooHR of de salarisadministratie in.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Carerix via de GraphQL API (https://api.carerix.io/graphql/v1/graphql), confidential client met client credentials. crMatchPage met een qualifier op statusInfoModificationDate en statusInfo.isSuccessfullyFilled; CRMatch jobStartDate, salary en salaryUnitTag; CREmployee firstName, lastNamePrefix, lastName, emailAddress en mobileNumber; CRVacancy toWorkUnitNode, toFunctionLevel1, toContractTypeNode en hoursPerWeek.
- BambooHR via POST /api/v1/employees (minimaal firstName en lastName; hireDate als JJJJ-MM-DD; 201 met Location-header en id; 409 bij ongeldige lijstwaarden; employmentType en fotovelden worden genegeerd). Opties via list-fields. Daarna een regel in de tabel employmentStatus. OAuth-scope employee.write.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Carerix | Veld in BambooHR | Toelichting |
|---|---|---|
CRMatch _id | Opgeslagen bij het BambooHR-ID | Om een plaatsing maar één keer te verwerken |
CREmployee firstName | firstName | |
CREmployee lastNamePrefix en lastName | lastName | Tussenvoegsel vooraan |
CREmployee emailAddress en mobileNumber | homeEmail en mobilePhone | |
CRMatch jobStartDate | hireDate | |
CRVacancy toWorkUnitNode | department | Via een tabel naar een geldige optie |
CRVacancy toFunctionLevel1 | jobTitle | Via een tabel naar een geldige optie |
CRVacancy toContractTypeNode | employmentStatus (tabelregel) | Ingangsdatum gelijk aan de startdatum |
Gerelateerd
Carerix → ADP Workforce Now
Carerix ADP Workforce Now koppeling: plaatsing in Noord-Amerika als in-progress hire
Carerix → AFAS Profit
Carerix koppelen met AFAS: een geplaatste kandidaat start de onboarding in AFAS Profit
Carerix → Dayforce
Carerix Dayforce koppeling: geslaagde plaatsing als gecontroleerde nieuwe medewerker in Dayforce
Carerix → Deel
Carerix Deel koppeling: geslaagde plaatsing als persoon of contract in Deel