ShVerlof, verzuim en uren
Personio Shiftbase koppeling: medewerkers en contracten per kostenplaats uit Personio in de planning
Met een koppeling tussen Personio en Shiftbase komen medewerkers en hun contracten uit Personio direct na elke wijziging in Shiftbase. KoppelHet maakt per kostenplaats een contract, zodat een medewerker die in Personio over meerdere kostenplaatsen is verdeeld in elk team in de planning staat.
Wat de koppeling doet
Organisaties die HR in Personio voeren en roosteren in Shiftbase, verdelen een dienstverband in Personio soms over meerdere kostenplaatsen. In de planning moet die medewerker dan in meerdere teams staan.
- KoppelHet krijgt API-gegevens in Personio en een token voor de Public API van Shiftbase.
- HR legt in Personio een dienstverband vast of verdeelt het over kostenplaatsen.
- Personio stuurt een melding en KoppelHet haalt het dienstverband op.
- KoppelHet maakt of wijzigt per kostenplaats een contract in Shiftbase.
Waar je op let bij Personio en Shiftbase
- Personio kan een dienstverband over meerdere kostenplaatsen verdelen, elk met een gewicht. KoppelHet maakt in Shiftbase per kostenplaats een contract, zodat de medewerker in elk team te plannen is.
- Personio stuurt een aparte melding als de verdeling over kostenplaatsen verandert (employment.updated.cost-centers). KoppelHet past de contracten in Shiftbase dan direct aan.
- Een melding uit Personio bevat alleen ID's. KoppelHet haalt na elke melding het volledige dienstverband op via de Personio API v2.
- Personio ondertekent meldingen met HMAC-SHA256 en verwacht binnen 3 seconden een bevestiging. KoppelHet controleert de handtekening, bevestigt direct en verwerkt de melding daarna.
- Een contractwijziging die HR overdag in Personio doet, staat direct in Shiftbase. Wie vandaag voor morgen plant, plant dus met de actuele contracturen.
- Personio legt uren per week vast, terwijl een Shiftbase-contract contracturen per dag heeft. Bij een dienstverband over twee kostenplaatsen rekent KoppelHet per contract de weekuren maal het gewicht van die kostenplaats uit, en deelt dat door het aantal werkdagen dat we per vestiging vastleggen.
- Wijzig je een contract in Shiftbase, dan rekent Shiftbase alle uitkomsten binnen de looptijd opnieuw uit, ook die uit het verleden. Personio geeft het dienstverband zoals het nu is. KoppelHet past daarom geen lopend contract aan, maar sluit het af op de dag voor de wijziging en begint een nieuw contract.
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
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- KoppelHet leest Personio via webhooks (employment.created, employment.updated, employment.updated.cost-centers; alleen ID's, HMAC-SHA256, bevestigen binnen 3 seconden) en de Personio API v2 (employments met weekly_working_hours, office, legal_entity en cost_centers met weight), en schrijft naar Shiftbase via de Shiftbase API met een token voor de Public API.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Personio | Veld in Shiftbase | Toelichting |
|---|---|---|
Personio-persoon | Shiftbase-medewerker | |
cost_centers (met weight) | Contract per kostenplaats | |
weekly_working_hours | Contracturen per dag | Weekuren maal het gewicht van de kostenplaats, gedeeld door de werkdagen |
position.title | Functie in het contract | |
employment_start_date | Contract vanaf | |
employment_end_date | Contract tot | Leeg bij een contract voor onbepaalde tijd |
Gerelateerd
Ashby → Personio
Ashby Personio koppeling: aannames met uren en entiteit als nieuwe medewerker in Personio
Bullhorn → Personio
Bullhorn Personio koppeling: plaatsingen als persoon met dienstverband in Personio
Carerix → Personio
Carerix Personio koppeling: geslaagde plaatsing als nieuwe medewerker in Personio
Greenhouse → Personio
Greenhouse Personio koppeling: aangenomen kandidaten als medewerker in Personio