Verlof, verzuim en uren
Quinyx Loket koppeling: uren en toeslagen als variabele gegevens per periode, verlof terug
Met een koppeling tussen Quinyx en Loket komen de goedgekeurde uren, overuren en toeslagen uit Quinyx als variabele gegevens per dienstverband en kostenplaats in de juiste salarisperiode van Loket. Opgenomen verlof gaat mee naar Loket, en het verlofsaldo dat Loket berekent komt terug in Quinyx.
Wat de koppeling doet
Organisaties die ploegen en uitzendkrachten in Quinyx plannen en hun eigen medewerkers in Loket verlonen, zetten elke periode een bestand uit Quinyx met de hand om naar looncomponenten. Valt een periode in Quinyx niet gelijk met de verloningsperiode in Loket, dan schuiven uren naar de verkeerde loonstrook.
- Medewerkers klokken in Quinyx en leidinggevenden keuren de tijd goed. Quinyx berekent toeslagen en overuren.
- Na de overdracht naar payroll haalt KoppelHet de uren op over precies de datums van de Loket-periode.
- Per dienstverband en kostenplaats staan de uren als variabele gegevens in Loket, op het looncomponent dat bij het salaristype hoort.
- Opgenomen verlof uit Quinyx komt als verlofregel bij het dienstverband in Loket.
- Loket berekent het verlofsaldo; KoppelHet zet het per verlofsoort terug in Quinyx.
Terug: Verlofsaldo per verlofsoort
Waar je op let bij Quinyx en Loket
- Loket verloont per maand, per vier weken of per week, met een periodenummer per jaar. Quinyx zet over payroll over op begin- en einddatum. KoppelHet haalt de uren op over precies de datums van de Loket-periode, zodat bij vier-wekelijkse verloning geen dag in de verkeerde periode valt.
- Loket herkent een regel aan de combinatie van periode, ploeg, strooksoort, verdeeleenheid, kostenplaats en kostendrager. Uren die Quinyx op twee kostenplaatsen registreert, worden daarom twee regels in Loket, en een tweede aanlevering voor dezelfde kostenplaats werkt de bestaande regel bij.
- Bij het inlezen vraagt Loket of bestaande waarden worden overschreven, overgeslagen of opgeteld. Voor uren uit Quinyx kiest KoppelHet overschrijven, zodat een gecorrigeerde overdracht de eerste vervangt en de uren niet dubbel op de loonstrook komen.
- Loket raadt aan eerst de standaardwaarden van een dienstverband op te halen, zoals kostenplaats en ploeg, en die aan te vullen met de looncomponenten. KoppelHet doet dat per dienstverband, zodat uren uit Quinyx niet op een lege kostenplaats landen.
- Loket berekent verlofrecht met eigen verlofregelingen, bijvoorbeeld op leeftijd, loon of dienstjaren. KoppelHet rekent dat niet na in Quinyx, maar zet het saldo dat Loket per verlofsoort teruggeeft op de tracker in Quinyx.
- Een werknemer met twee dienstverbanden heeft in Loket twee afzonderlijke dienstverbanden met eigen variabele gegevens. In Quinyx wijst elke agreement naar één dienstverband, zodat uren op het juiste contract worden verloond.
- Uitzendkrachten staan wel in Quinyx, maar niet in Loket. Hun uren gaan niet naar Loket; KoppelHet slaat ze over op basis van de personeelscategorie in Quinyx en meldt uren van onbekende medewerkers apart.
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
Wij verlonen per vier weken. Werkt dat met Quinyx?
Ja. KoppelHet neemt de periodes van de werkgever in Loket als uitgangspunt en haalt de uren in Quinyx op over precies die datums.
Ons salarisbureau werkt in Loket. Moet dat iets doen?
Het salarisbureau geeft de koppeling toegang tot de werkgever en bevestigt de vertaaltabel van salaristypes naar looncomponenten. Daarna staan de uren elke periode klaar zonder bestand.
Gaan nieuwe medewerkers ook van Loket naar Quinyx?
Dat kan later als uitbreiding. We beginnen met de uren en het verlof, omdat daar de meeste handwerk zit.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Quinyx wordt gelezen via wsdlGetPayrollV2 (fromDate, toDate, salType, hours, costCentre, badgeNo) na wsdlInitiateTransferToPayroll met een unieke extTransferId. Saldi gaan naar Quinyx via wsdlUpdateTimeTrackers.
- Naar Loket schrijven we via de Loket REST API (OAuth 2.0) met PATCH /v2/providers/employers/employees/employments/{employmentId}/payrollperioddata, of de collectieve variant per werkgever. De sleutel is payrollPeriod, shift, payslipType, distributionUnit, costCenter en costUnit; payrollComponent, value en attribute worden ingevoegd of overschreven. Standaardwaarden via /defaults. Bij de CSV-import kiest processingMethod tussen overschrijven, niet overschrijven en optellen.
- Verlof gaat naar Loket via POST .../employments/{employmentId}/leave; saldi komen uit GET .../employments/{employmentId}/leavebalances (jaarsaldo per verlofsoort).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Quinyx | Veld in Loket | Toelichting |
|---|---|---|
badgeNo | Personeelsnummer werknemer | |
extAgreementId | employmentId | De agreement in Quinyx wijst naar het dienstverband in Loket |
salType | payrollComponent | Via een vertaaltabel van salaristypes naar looncomponenten |
hours | value | |
costCentre | costCenter | Elke kostenplaats wordt een eigen regel |
Overdrachtsperiode (fromDate, toDate) | payrollPeriod (year, periodNumber) | Maand, vier weken of week, volgens de werkgever |
Absence (goedgekeurd) | Leave bij het dienstverband | |
Time tracker | leavebalances per verlofsoort |
Gerelateerd
ADP iHCM → Quinyx
ADP iHCM Quinyx koppeling: medewerkers en contracturen uit ADP in de planning, uren per loonperiode terug naar ADP
ADP Workforce Now → Quinyx
ADP Workforce Now Quinyx koppeling: medewerkers met agreements, posities en verlof in uren in de planning
BambooHR → Quinyx
BambooHR Quinyx koppeling: medewerkers, goedgekeurd verlof en saldi uit BambooHR in het rooster
Dayforce → Quinyx
Dayforce Quinyx koppeling: medewerkers, werkuren en goedgekeurde time away from work uit Dayforce in de planning