Verlof, verzuim en uren
Quinyx YouForce koppeling: uren en toeslagen als looncomponent, dienstverbanden en verlof terug
Met een koppeling tussen Quinyx en Visma Raet YouForce gaan goedgekeurde uren, overuren en toeslagen uit Quinyx per dienstverband als looncomponent naar YouForce, klaar voor de salarisverwerking. Andersom komen dienstverbanden, geplande contractwijzigingen, goedgekeurd verlof en ziekmeldingen uit YouForce in Quinyx, zodat de planning niemand inroostert die afwezig is of minder uren heeft.
Wat de koppeling doet
Organisaties die teams in Quinyx plannen en salarissen in Visma Raet YouForce verwerken, zetten gewerkte uren en toeslagen per maand via een export over, die de salarisadministratie met de hand verwerkt. Een ziekmelding of verlof in YouForce bereikt de planner pas als iemand belt, en contractwijzigingen staan soms weken later in Quinyx.
- HR legt een dienstverband of contractwijziging vast in YouForce, ook als die pas later ingaat. KoppelHet zet de medewerker en de agreement in Quinyx.
- Goedgekeurd verlof en ziekmeldingen uit YouForce komen als afwezigheid in het rooster van Quinyx.
- Medewerkers registreren hun tijd in Quinyx en de teamleider keurt goed. Quinyx berekent overuren en toeslagen.
- Na de overdracht naar payroll stuurt KoppelHet de uren per dienstverband en looncomponent naar YouForce.
- KoppelHet controleert of YouForce elke aanlevering heeft verwerkt en meldt afgewezen regels in het platform.
Terug: Dienstverbanden en geplande contractwijzigingen · Goedgekeurd verlof als afwezigheid · Ziek- en betermeldingen
Waar je op let bij Quinyx en Visma Raet YouForce
- YouForce neemt looncomponenten aan per dienstverband, niet per medewerker. Wie in Quinyx op twee agreements werkt, bijvoorbeeld een vast contract en een oproepcontract, krijgt de uren in YouForce op het dienstverband waarop ze zijn gewerkt.
- Een aanlevering bij YouForce wordt eerst in een wachtrij gezet en later verwerkt. KoppelHet vraagt de status per aanlevering op en laat een afgewezen regel zien voordat de salarisrun start, in plaats van dat hij pas op de loonstrook opvalt.
- Quinyx geeft uren per kostenplaats, maar een looncomponent in YouForce draagt via deze route alleen een code, een waarde en een ingangsdatum. Moeten uren op een andere kostenplaats dan de vaste worden verantwoord, dan regelen we dat met een eigen looncomponent per kostenplaats of in de kostenverdeling van YouForce.
- Verlof kan niet via de API als verlofboeking in YouForce komen; YouForce neemt langs die weg alleen looncomponenten aan. Daarom blijft verlof in YouForce aangevraagd en goedgekeurd, en zet KoppelHet het als afwezigheid in Quinyx.
- Een ziekmelding met terugwerkende kracht over een periode die in Quinyx al naar payroll is overgezet, weigert Quinyx. KoppelHet meldt dat aan de planner, die de overdracht in Quinyx terugdraait of de correctie in YouForce zelf verwerkt.
- Een urenwijziging die volgende maand ingaat, staat in YouForce als geplande wijziging. KoppelHet zet die met de juiste ingangsdatum in Quinyx, zodat de planning het nieuwe contract al ziet bij het maken van het rooster voor die maand.
- Quinyx maakt voor elk toeslagpercentage een eigen salaristype; in YouForce horen daar eigen looncomponenten bij. De salarisadministratie beheert de vertaaltabel, en een salaristype zonder looncomponent gaat niet ongemerkt verloren.
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
Kunnen medewerkers verlof in de Quinyx-app aanvragen?
Dat kan, maar dan staat het verlof niet in YouForce, want YouForce neemt via de API geen verlofboekingen aan. Wij raden aan verlof in YouForce aan te vragen; de planner ziet het daarna in Quinyx.
Wat gebeurt er met uren die na de afsluiting worden gecorrigeerd?
De correctie gaat mee in de volgende periode, met de ingangsdatum van die periode. Zo blijft een afgesloten salarisrun in YouForce ongemoeid.
Gaan verlofsaldi ook naar Quinyx?
Dat kan later als uitbreiding. YouForce levert verlofrechten en opgenomen uren; welk saldo medewerkers in Quinyx moeten zien, spreken we dan per verlofsoort af.
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 (salType, hours, costCentre, badgeNo) na een overdracht met wsdlInitiateTransferToPayroll. Afwezigheid gaat naar Quinyx via de v2 Absences API (POST /v2/schedule/groups/{groupId}/absences); een periode die al naar payroll is overgezet geeft SALARY_PERIOD_LOCKED of SHIFT_ALREADY_TRANSFERRED_TO_PAYROLL.
- Naar YouForce schrijven we via de WFM API, POST /v1.0/PayComponents/{employment} met per regel elementCode, value en effectiveDate (scope Youforce-WFM:Write_Basic). De status volgt per ticket via /v1.0/payComponents/{TicketId}/status.
- YouForce wordt gelezen via de WFM API (employments, employments/plannedChanges, leavePeriods, leaveHours en sickleaves) op latestSync, met OAuth 2.0 client credentials via Visma Connect.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Quinyx | Veld in Visma Raet YouForce | Toelichting |
|---|---|---|
badgeNo | personCode | Het YouForce-personeelsnummer is het badgenummer in Quinyx |
extAgreementId | employmentCode | Elk dienstverband een eigen agreement |
salType | elementCode | Via een vertaaltabel van salaristypes naar looncomponenten |
hours (opgeteld per periode) | value | |
Eerste dag van de salarisperiode | effectiveDate | |
Agreement fromDate | plannedChanges (ingangsdatum) | Geplande wijzigingen worden toekomstige agreements of gedateerde regels |
Absence (absenceTypeId) | leavePeriods en sickleaves | Per verlof- en ziektesoort een afwezigheidstype in Quinyx |
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