Verlof, verzuim en uren
Quinyx Nmbrs koppeling: gewerkte uren per uurcode in de salarisperiode, roosters en verlof terug
Met een koppeling tussen Quinyx en Nmbrs komen de goedgekeurde uren, overuren en toeslagen uit Quinyx als variabele uren op de juiste uurcode en kostenplaats in de lopende salarisperiode van Nmbrs. Nieuwe medewerkers, roosters en het verlofsaldo uit Nmbrs gaan terug naar Quinyx, zodat de planning en de salarisverwerking van dezelfde gegevens uitgaan.
Wat de koppeling doet
Werkgevers die in Quinyx plannen en in Nmbrs verlonen, met een eigen bedrijf per bv, zetten de uren elke maand per bedrijf in Nmbrs. Wie op twee vestigingen werkt, staat dan soms bij het verkeerde bedrijf, en uren op een andere kostenplaats verdwijnen in de totalen.
- HR legt een nieuwe medewerker met rooster vast bij het juiste bedrijf in Nmbrs. KoppelHet maakt de medewerker en de agreement aan in Quinyx.
- Medewerkers klokken in Quinyx en vragen daar verlof aan. Leidinggevenden keuren tijd en verlof goed.
- Na de overdracht naar payroll haalt KoppelHet de uren per medewerker, salaristype en kostenplaats op.
- De uren staan als variabele uren in de lopende periode van het juiste bedrijf in Nmbrs, op de uurcode die bij het salaristype hoort en met de kostenplaats uit Quinyx.
- Goedgekeurd verlof gaat als verlof naar Nmbrs; het saldo per verlofsoort komt terug in Quinyx.
Terug: Nieuwe medewerkers en uitdiensttreding · Rooster met uren per week · Verlofsaldo per verlofsoort
Waar je op let bij Quinyx en Nmbrs
- Nmbrs boekt variabele uren in een periode van een bedrijf. Een periode die het bedrijf al voorbij is, accepteert Nmbrs alleen als de aanlevering uitdrukkelijk in onbeschermde modus gaat; anders geeft Nmbrs een fout. KoppelHet boekt late correcties uit Quinyx daarom standaard in de lopende periode.
- In Nmbrs worden uren via een uurcode met het uurloon vermenigvuldigd; vaste bedragen lopen via looncomponenten. Quinyx levert toeslagen als uren per salaristype, dus die gaan naar een uurcode, en alleen vergoedingen die Quinyx als bedrag berekent gaan naar een looncomponent.
- Een uurregel in Nmbrs heeft een eigen kostenplaats en kostendrager. Werkt iemand een dienst op een andere vestiging, dan staan die uren in Nmbrs ook op de kostenplaats van die vestiging, zoals Quinyx ze heeft geregistreerd.
- Eén Nmbrs-omgeving kan meerdere bedrijven bevatten, terwijl Quinyx in winkels of vestigingen denkt. KoppelHet legt per Quinyx-unit vast bij welk Nmbrs-bedrijf de uren horen, zodat een medewerker in een tweede bv geen uren bij de eerste krijgt.
- Nmbrs kan alle extra uren van een periode in één keer wissen. Dat raakt ook uren die de salarisadministratie met de hand heeft ingevoerd. KoppelHet gebruikt dat niet en werkt alleen de regels bij die het zelf uit Quinyx heeft geboekt.
- Nmbrs kent vier verlofsoorten per medewerker, met een status van aangevraagd tot goedgekeurd. Verlof dat in Quinyx is goedgekeurd, komt in Nmbrs direct als goedgekeurd binnen, op de soort die bij het afwezigheidstype in Quinyx hoort.
- Het rooster in Nmbrs staat als uren per dag over twee weken. Quinyx rekent met uren per week en een verdeling over de dagen in de agreement. KoppelHet rekent het tweeweekse rooster om, zodat een medewerker met een even en oneven week de juiste contracturen houdt.
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
Wat als de periode in Nmbrs al is afgesloten?
Dan boekt KoppelHet de uren in de lopende periode en meldt dat in het platform. Alleen als de salarisadministratie dat wil, boeken we in een eerdere periode.
Werkt dit ook als we meerdere bedrijven in Nmbrs hebben?
Ja. Per winkel of vestiging in Quinyx leggen we vast bij welk bedrijf de uren horen. Medewerkers die bij twee bedrijven in dienst zijn, krijgen de uren bij het bedrijf van de unit waar ze hebben gewerkt.
Gaan vaste looncomponenten ook mee?
Nee. Vaste looncomponenten zoals salaris en vaste toelagen blijven in Nmbrs. Quinyx levert alleen wat per periode varieert.
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; approvedSalaryStatus) na wsdlInitiateTransferToPayroll. Het Nmbrs-bedrijf per unit leggen we vast in de Quinyx Mapping API (mappingType EXTERNAL_COMPANY_CODE) of in een eigen tabel.
- Naar Nmbrs schrijven we variabele uren met HourComponentVar_Insert (EmployeeId, HourCode, Hours, CostCenterId, CostUnitId, Period, Year, UnprotectedMode) in de SOAP EmployeeService, of met het REST-endpoint voor variabele uren. HourComponentVar_Clear wist alle extra uren van een periode en gebruiken we niet. Verlof met Leave_Insert (Type1 tot Type4, Status), saldo met LeaveBalance_GetPerType. De SOAP API stopt per 1 maart 2027.
- Naar Quinyx gaan medewerkers via wsdlUpdateEmployees of de Employees API v3, agreements via wsdlUpdateAgreementsV2 en saldi via wsdlUpdateTimeTrackers.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Quinyx | Veld in Nmbrs | Toelichting |
|---|---|---|
badgeNo | Personeelsnummer | Per bedrijf; samen met het bedrijf uniek |
salType | HourCode | Via een vertaaltabel van salaristypes naar uurcodes |
hours | Hours | |
costCentre | CostCenterId | Via een vertaaltabel van Quinyx-kostenplaatsen naar Nmbrs-kostenplaatsen |
Overdrachtsperiode (fromDate, toDate) | Period en Year | |
Unit of EXTERNAL_COMPANY_CODE | Bedrijf in Nmbrs | Bepaalt bij welk bedrijf de uren landen |
Absence (goedgekeurd) | Leave (Status Approved, Type) | Per verlofsoort een type in Nmbrs |
Time tracker | LeaveBalance per type |
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