Recruitment naar HR
Lever Personio koppeling: getekend aanbod wordt een medewerker in onboarding
Met een koppeling tussen Lever en Personio komt een kandidaat die in Lever is aangenomen als medewerker met de status onboarding in Personio, met startdatum, afdeling, kantoor, juridische entiteit en salaris uit het aanbod. KoppelHet verbindt daarvoor de webhook van Lever met de API van Personio.
Wat de koppeling doet
Organisaties die met Lever werven en Personio als HR-systeem gebruiken, typen elke aanname opnieuw in Personio. Lever heeft het aanbod met startdatum en salaris, Personio wil daarnaast kantoor, entiteit en uren, en die moeten per kandidaat worden opgezocht.
- De opportunity gaat in Lever naar aangenomen.
- KoppelHet haalt opportunity, aanbod en posting op en controleert dat iedereen heeft getekend.
- Uit de labels van de posting bepaalt KoppelHet afdeling, kantoor en juridische entiteit in Personio.
- KoppelHet maakt de persoon met dienstverband aan in Personio, met de status onboarding.
- Daarna volgt het salaris als aparte vergoeding vanaf de startdatum.
Waar je op let bij Lever en Personio
- Personio weigert een tweede medewerker met hetzelfde e-mailadres. Komt een oud-medewerker via Lever terug, dan maakt KoppelHet geen nieuwe persoon maar meldt het aan HR, die de herindiensttreding in Personio regelt.
- Afdeling, kantoor en juridische entiteit zijn in Personio verwijzingen naar bestaande ID's. In Lever zijn het labels op de posting. KoppelHet vertaalt elk label via een tabel en stopt met een melding bij een label dat er nog niet in staat.
- Lever kent geen contracturen; het soort werk staat als label, zoals fulltime of parttime. Personio rekent met uren per week tegenover de volledige week. Per label leggen we vaste uren vast, of we voegen een urenveld toe aan het aanbiedingssjabloon in Lever.
- Personio kent voor terugkerende vergoedingen alleen de perioden maand, kwartaal, halfjaar en jaar. Een uurloon uit Lever gaat daarom als vergoeding van het type uurloon, en niet als vast salaris met een uurperiode.
- Een bonus uit het Lever-aanbod kan niet via de compensatie-API van Personio. KoppelHet neemt alleen het basissalaris mee en zet in de melding aan HR dat er een bonus in het aanbod staat.
- Een Lever-aanbod staat al op getekend zodra één partij tekent. KoppelHet zet de medewerker pas in Personio als kandidaat en bedrijf allebei hebben getekend, zodat de onboarding niet start op een aanbod dat nog kan veranderen.
- Welke velden meegaan, bepalen jullie zelf. KoppelHet bewaakt elke aanname en meldt een fout in het platform.
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 cv en aanbiedingsbrief mee?
Niet in de eerste versie. Het getekende aanbod als document in Personio kan later als uitbreiding.
Wat als de startdatum na de aanname verschuift?
Dan past HR de datum in Personio aan. De koppeling stuurt alleen de aanname zelf.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Lever via de webhook candidateHired (data.opportunityId, data.contactId; HMAC-SHA256 over token en triggeredAt) en de Lever API met een API-key via basic authentication. GET /opportunities/:opportunity, /opportunities/:opportunity/offers (fields per identifier, signatures per ondertekenaar) en /postings/:posting (categories, country). Lever probeert een mislukte webhook vijf keer.
- Personio via POST /v2/persons (scope personio:persons:write) met first_name, last_name, email en een employment met employment_start_date, status ONBOARDING, position.title, org_units, office, legal_entity en weekly_working_hours. Salaris via POST /v2/compensations (scopes personio:compensations:read en write; value, currency, interval MONTHLY tot YEARLY, effective_from; geen bonussen).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Lever | Veld in Personio | Toelichting |
|---|---|---|
name | first_name en last_name | Lever heeft één naamveld; KoppelHet splitst |
emails[0] | email | Moet uniek zijn in Personio |
Offer field anticipated_start_date | employment_start_date | |
Offer field job_title | position.title | |
categories.department en team | org_units (id en type) | Via een vertaaltabel |
categories.location en country | office.id en legal_entity.id | Via een vertaaltabel |
categories.commitment | weekly_working_hours | Vaste uren per label, of een eigen aanbodsveld |
salary_amount, compensation_currency, salary_interval | Compensation met value, currency, interval en effective_from |
Gerelateerd
Lever → BambooHR
Lever BambooHR koppeling: aangenomen kandidaat als nieuw medewerkersprofiel in BambooHR
Lever → Dayforce
Lever Dayforce koppeling: getekend aanbod als gecontroleerde nieuwe medewerker in Dayforce
Lever → Deel
Lever Deel koppeling: aangenomen kandidaat als eigen medewerker of EOR-contract in Deel
Lever → HiBob
Lever HiBob koppeling: aangenomen kandidaat met aanbod als medewerker in Bob