Recruitment naar HR
Carerix Loket koppeling: geslaagde plaatsing als concept-werknemer in Loket
Met een koppeling tussen Carerix en Loket wordt een kandidaat met een geslaagde match in Carerix een concept-werknemer in Loket, bij de werkgever die bij de entiteit van de vacature hoort, met naam, geboortedatum, Nederlands adres en startdatum. De nieuwe medewerker vult BSN en bankrekening daarna zelf aan via Loket, zodat die gegevens niet uit het wervingssysteem hoeven te komen.
Wat de koppeling doet
Organisaties die eigen personeel in Carerix werven en de salarisadministratie in Loket voeren, typen elke geslaagde plaatsing over als nieuwe werknemer. Met meerdere werkgevers in Loket moet HR per plaatsing de juiste werkgever kiezen, en BSN en IBAN worden vaak per mail opgevraagd.
- De recruiter zet de match in Carerix op een status voor een geslaagde plaatsing.
- KoppelHet haalt elk kwartier de gewijzigde matches op en bepaalt met een tabel de werkgever in Loket.
- KoppelHet haalt de keuzelijsten voor een nieuw concept op bij die werkgever en vertaalt geslacht en nationaliteit.
- Het concept komt in Loket met naam, geboortedatum, adres en startdatum.
- De salarisadministratie maakt het concept af; de medewerker vult BSN en IBAN zelf in.
Waar je op let bij Carerix en Loket
- In Loket hangt een nieuw concept aan een werkgever, en de toegestane waarden voor het concept haal je per werkgever op. Een Carerix-vacature kan aan een juridische entiteit hangen; per entiteit leggen we de werkgever in Loket vast, zodat een plaatsing nooit bij de verkeerde werkgever als concept verschijnt.
- Carerix legt voorletters, voornaam, tussenvoegsel en achternaam apart vast, zoals de Nederlandse loonadministratie ze ook gebruikt. KoppelHet zet ze los in het concept, zodat de naam op de loonstrook en in de aangifte zonder handwerk klopt.
- Het adres in Carerix heeft straat, huisnummer, toevoeging, postcode en plaats in eigen velden. Dat sluit aan op een Nederlands woonadres in Loket; KoppelHet hoeft niets uit een tekstregel te knippen.
- Carerix heeft velden voor sofinummer en IBAN bij de kandidaat. KoppelHet neemt die standaard niet over; Loket heeft selfservice voor concept-werknemers, waarmee de nieuwe medewerker deze gegevens zelf invult. Zo staat een BSN niet langer dan nodig in het wervingssysteem en in de koppeling.
- Sommige keuzes voor een concept hangen in Loket af van de gekozen loonadministratie en loonschaal. KoppelHet vult in de eerste versie alleen persoonsgegevens en de datum in dienst; loonschaal, uren en salaris kiest de salarisadministratie in Loket, en meesturen kan later als uitbreiding.
- Loket laat koppelingen pas op productie toe als de applicatie is goedgekeurd, en heeft een acceptatieomgeving met testgegevens. KoppelHet test de vertaling van Carerix-keuzelijsten naar Loket daar eerst, voordat er een echte concept-werknemer ontstaat.
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 Loket-koppeling?
Die vonden we niet in de openbare documentatie van Carerix of op de koppelingenpagina van Loket. KoppelHet bouwt op de API's van beide.
Is dit ook bedoeld voor uitzendkrachten?
Deze pagina gaat over eigen personeel. Flexkrachten verlonen is een ander proces met eigen afspraken, en dus een andere koppeling.
Wie maakt het concept af?
De salarisadministratie in Loket. Die kiest loonschaal, arbeidsvoorwaarden en uren en zet het concept om naar een werknemer.
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; CREmployee initials, firstName, lastNamePrefix, lastName, birthDate, toGenderNode, toNationalityNode, street, houseNumber, houseNumberSuffix, postalCode en city (sofiNumber en paymentIbanCode worden niet gelezen); CRVacancy toLegalEntity.
- Loket via de REST API met OAuth 2.0 (authorization code met refresh token). Metadata voor een nieuw concept via /providers/employers/{id}/jobapplicant/metadata, daarna per loonadministratie en loonschaaltype. Concept employee aanmaken bij de werkgever; selfservice voor concept-werknemers; workflow-endpoints voor het vervolg. Acceptatie op api.loket-acc.nl/v2; productie alleen voor goedgekeurde applicaties.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Carerix | Veld in Loket | Toelichting |
|---|---|---|
CRVacancy toLegalEntity | Werkgever in Loket | Via een vertaaltabel per entiteit |
CREmployee initials, firstName | Voorletters en roepnaam | |
CREmployee lastNamePrefix en lastName | Voorvoegsel en achternaam | Apart, zoals Loket ze vastlegt |
CREmployee birthDate | Geboortedatum | |
CREmployee toGenderNode en toNationalityNode | Geslacht en nationaliteit | Naar de keuzelijst van Loket |
CREmployee street, houseNumber, houseNumberSuffix, postalCode en city | Woonadres | |
CRMatch jobStartDate | Datum in dienst |
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