Verlof, verzuim en uren
Deel Quinyx koppeling: eigen medewerkers en goedgekeurd verlof uit Deel in de Quinyx-planning
Met een koppeling tussen Deel en Quinyx komen de medewerkers van de entiteiten die in Quinyx roosteren automatisch in de juiste unit, en staat verlof dat in Deel is goedgekeurd meteen als afwezigheid in Quinyx. Wordt verlof in Deel gewijzigd of geannuleerd, dan past KoppelHet de afwezigheid in Quinyx aan, inclusief halve dagen.
Wat de koppeling doet
Organisaties die hun HR in Deel voeren en winkels, magazijnen of klantenservice in Quinyx plannen, zetten nieuwe medewerkers en goedgekeurd verlof met de hand in Quinyx. Verlof dat in Deel wordt ingetrokken, blijft in het rooster staan, en de planner ontdekt dat pas als iemand onverwacht komt werken.
- HR maakt een medewerker aan in Deel bij een entiteit die in Quinyx roostert.
- KoppelHet maakt de medewerker aan in Quinyx, in de unit van de werklocatie, met een agreement.
- Een leidinggevende keurt verlof goed in Deel; Deel meldt de beoordeling direct.
- KoppelHet zet het verlof in Quinyx als hele of gedeeltelijke afwezigheid.
- Bij een wijziging of annulering in Deel verwijdert KoppelHet de oude afwezigheid en boekt zo nodig de nieuwe.
Waar je op let bij Deel en Quinyx
- Deel meldt het moment dat een leidinggevende verlof beoordeelt, met goedgekeurd of afgewezen als uitkomst. KoppelHet boekt alleen bij goedgekeurd een afwezigheid in Quinyx, zodat een aanvraag die nog loopt geen gat in het rooster maakt.
- Bij een halve dag zegt Deel alleen dat de eerste of laatste dag half is, niet of het de ochtend of middag betreft. Quinyx wil weten of de afwezigheid aan het begin of het einde van de dienst valt. KoppelHet boekt een halve eerste dag aan het einde van de dienst en een halve laatste dag aan het begin, tenzij jullie een andere regel kiezen.
- De meldingen van Deel over verlof hangen aan het contract, niet aan de persoon. Een medewerker kan in Deel meerdere contracten hebben. KoppelHet zoekt bij elk contract de Quinyx-medewerker op en negeert contracten bij entiteiten die niet in Quinyx worden gepland.
- Deel heeft in de people-API geen veld voor contracturen. Quinyx roostert niemand zonder agreement. KoppelHet haalt de uren uit een eigen veld in Deel, of kiest een vast agreement-sjabloon per functie, wat we bij de start afspreken.
- Bij het opvragen van verlof laat Deel werken op afstand standaard weg, en verwijderd verlof alleen als je daarom vraagt. KoppelHet houdt werken op afstand buiten Quinyx, want het is geen afwezigheid, en vraagt bij de dagelijkse controle ook verwijderd verlof op, zodat een vergeten verwijdering het rooster niet blokkeert.
- Een verlofaanvraag in Deel kan per dag in hele dagen, halve dagen, uren of een percentage staan, maar alle dagen van één aanvraag hebben hetzelfde soort. Quinyx kent een volledige afwezigheid en een gedeeltelijke met een percentage. KoppelHet rekent uren en percentages per aanvraag om naar dat percentage.
- Quinyx weigert afwezigheid voor een medewerker van wie het dienstverband is beëindigd. Deel geeft de laatste werkdag per contract. KoppelHet zet die als vertrekdatum in Quinyx en boekt verlof dat daarna nog binnenkomt niet meer, met een melding 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 ook EOR-medewerkers en contractors naar Quinyx?
Alleen als jullie ze in Quinyx inroosteren. We kiezen per soort dienstverband en per entiteit wie meegaat.
Gaan gewerkte uren terug naar Deel?
Niet in deze koppeling. Een urenstroom naar de salarisverwerking kan later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Deel via de REST API (versie 2026-01-01) met een API-token of OAuth2-app (scopes people:read en time-off:read). Medewerkers via GET /rest/people en /rest/people/{hris_profile_id} (hiring_type, work_location, client_legal_entity, employments met start_date, work_email en termination_last_day); van dit endpoint staat versie 2026-10-12 in beta. Verlof via webhooks time-off.reviewed, time-off.updated en time-off.deleted (met start_date_is_half_day en end_date_is_half_day, per contract) en GET /rest/time_offs met updated_start_date, status en include_deleted_time_offs.
- Naar Quinyx schrijven we medewerkers via de Employees API v3 (POST /hr/v3/employees met badgeNumber, homeGroupId en employmentStartDate) en rollen via /hr/v3/role-assignments. Afwezigheid via POST /v2/schedule/groups/{groupId}/absences en /absences/part-time (absenceRate, absenceRateDirection FROM_START of FROM_END); verwijderen met reassignBackShifts. INACTIVE_EMPLOYEE na het vertrek. Agreements via wsdlUpdateAgreementsV2, vertrek via wsdlUpdateEmployees (leaveDate).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Deel | Veld in Quinyx | Toelichting |
|---|---|---|
employments[].employee_number of worker_id | badgeNumber | Vaste sleutel, per klant gekozen |
first_name, last_name | personalInformation.firstName, lastName | |
employments[].work_email | email | |
work_location | employment.homeGroupId | Via een tabel van werklocaties naar Quinyx-units |
employments[].start_date | employment.employmentStartDate | |
Eigen veld contracturen | Agreement (contracturen) | Deel heeft geen standaardveld voor uren |
employments[].termination_last_day | leaveDate | |
Time off (APPROVED), time_off_type | Absence, absenceTypeId | |
start_date_is_half_day en end_date_is_half_day | Part-time absence (absenceRateDirection) |
Gerelateerd
Ashby → Deel
Ashby Deel koppeling: aannames bij de eigen entiteit als direct employee in Deel
Bullhorn → Deel
Bullhorn Deel koppeling: eerste plaatsing als direct employee met contract in Deel
Carerix → Deel
Carerix Deel koppeling: geslaagde plaatsing als persoon of contract in Deel
Deel → 4PS Construct
Deel 4PS Construct koppeling: eigen werknemers van de bouwentiteit in 4PS, met afdeling en kostenplaats als dimensie