Recruitment naar HR
Carerix Personio koppeling: geslaagde plaatsing als nieuwe medewerker in Personio
Met een koppeling tussen Carerix en Personio wordt een kandidaat met een geslaagde match in Carerix een persoon met dienstverband in Personio, in de status onboarding, met startdatum, uren per week, entiteit en functie. Carerix meldt een statuswijziging niet uit zichzelf, dus KoppelHet kijkt elk kwartier welke matches zijn veranderd.
Wat de koppeling doet
Organisaties die voor de eigen formatie in Carerix werven en Personio als HR-systeem gebruiken, nemen elke geslaagde plaatsing met de hand over in Personio. Uren en entiteit staan bij de vacature in Carerix, de startdatum bij de match, en HR zoekt ze voor elke nieuwe collega bij elkaar.
- De recruiter zet de match in Carerix op een status voor een geslaagde plaatsing.
- KoppelHet haalt elk kwartier de gewijzigde matches op en houdt alleen de geslaagde over.
- KoppelHet leest kandidaat en vacature en kijkt of het e-mailadres al in Personio bestaat.
- Persoon en dienstverband komen in Personio, in de status onboarding.
- Het afgesproken salaris gaat als taak naar HR, die het in Personio vastlegt.
Waar je op let bij Carerix en Personio
- In Carerix bepaalt de inrichting van de statussen wat een geslaagde plaatsing is, met een vinkje per status. KoppelHet gebruikt dat vinkje en niet de naam van de status, zodat een voorstel of tweede gesprek nooit een medewerker in Personio oplevert.
- Carerix stuurt volgens de openbare documentatie geen melding bij een statuswijziging, maar houdt per match bij wanneer de status veranderde. KoppelHet vraagt elk kwartier alleen die gewijzigde matches op; een nieuwe collega staat dus binnen een kwartier in Personio.
- Carerix legt het tussenvoegsel apart vast, terwijl Personio bij het aanmaken alleen voornaam en achternaam vraagt. KoppelHet zet het tussenvoegsel vooraan in de achternaam, zodat de naam in Personio leest als in het paspoort.
- Het afgesproken salaris staat in Carerix als tekst bij de match, en de compensatie-API van Personio wil een bedrag met een interval. KoppelHet probeert die tekst niet te lezen als bedrag; het salaris gaat als taak naar HR.
- Een Carerix-vacature heeft een vast veld voor uren per week. KoppelHet zet die als contracturen in Personio en vult de fulltime uren per entiteit aan, zodat de deeltijdfactor in Personio klopt.
- Een vacature in Carerix kan aan een juridische entiteit hangen. Per entiteit leggen we de entiteit in Personio vast, zodat een plaatsing bij de ene bv niet bij een andere in Personio terechtkomt.
- Een kandidaat kan in Carerix op meerdere vacatures een match hebben, en Personio accepteert een e-mailadres maar bij één persoon. KoppelHet onthoudt welke match een persoon opleverde en legt een tweede plaatsing van dezelfde persoon voor 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
Gaan alle plaatsingen naar Personio?
Alleen matches op statussen die als geslaagd zijn ingericht, en alleen voor vacatures van de eigen organisatie.
Waarom elk kwartier en niet direct?
Carerix meldt een statuswijziging niet. Een kwartier is ruim op tijd, omdat een indiensttreding meestal weken later ingaat.
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.
- Carerix via de GraphQL API (https://api.carerix.io/graphql/v1/graphql), confidential client met client credentials, scope urn:cx/cx5Wrapper:data/crmatch:read. crMatchPage met een qualifier op statusInfoModificationDate; statusInfo.isSuccessfullyFilled; CRMatch jobStartDate en agreedSalary (String); CREmployee firstName, lastNamePrefix, lastName en emailAddress; CRVacancy hoursPerWeek (Float), toLegalEntity, toFunctionLevel1 en toWorkUnitNode.
- 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, weekly_working_hours, full_time_weekly_working_hours, legal_entity, org_units en position.title).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Carerix | Veld in Personio | Toelichting |
|---|---|---|
CREmployee firstName | first_name | |
CREmployee lastNamePrefix en lastName | last_name | Tussenvoegsel vooraan in de achternaam |
CREmployee emailAddress | email | Uniek in Personio |
CRMatch jobStartDate | employment_start_date | |
CRVacancy hoursPerWeek | weekly_working_hours | Met fulltime uren per entiteit |
CRVacancy toLegalEntity | legal_entity | Via een vertaaltabel |
CRVacancy toFunctionLevel1 | position.title | |
CRVacancy toWorkUnitNode | org_units (department) | Via een vertaaltabel |
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 → BambooHR
Carerix BambooHR koppeling: geslaagde plaatsing als medewerker met dienstverbandstatus in BambooHR
Carerix → Dayforce
Carerix Dayforce koppeling: geslaagde plaatsing als gecontroleerde nieuwe medewerker in Dayforce