Verlof, verzuim en uren
Dyflexis Nmbrs koppeling: afgesloten salarisperiodes naar Nmbrs, medewerkers terug naar de planning
Met een koppeling tussen Dyflexis en Nmbrs gaan de gewerkte uren en toeslagen van een afgesloten salarisperiode in Dyflexis automatisch als uurcomponenten naar het juiste Nmbrs-bedrijf, en komen medewerkers en contracten uit Nmbrs vanzelf in de planning. KoppelHet houdt daarbij meerdere Nmbrs-bedrijven, kostenplaatsen en uurcodes uit elkaar.
Wat de koppeling doet
Organisaties die alle diensten in Dyflexis plannen en in Nmbrs verlonen, sluiten de periode vaak per vestiging af. De salarisadministratie controleert daarna per vestiging of de toeslagen goed zijn overgekomen en zet de kostenplaats van invallers op een andere vestiging met de hand om.
- HR legt in Nmbrs een nieuwe medewerker met dienstverband en rooster vast.
- KoppelHet stuurt de medewerker en het contract naar Dyflexis. Een beheerder verbindt de medewerker de eerste keer met een Dyflexis-medewerker.
- De planner sluit de salarisperiode af per vestiging en contracttypegroep en stuurt die door. Dyflexis zet de periode in een wachtrij.
- KoppelHet haalt de uren per dag op, telt ze per looncomponent op en zet ze als uurcomponent in het juiste Nmbrs-bedrijf.
- KoppelHet zet de uitkomst terug in de wachtrij van Dyflexis, zodat de planner op de salarispagina ziet of de periode goed is verwerkt.
Terug: Nieuwe medewerkers met werkgever naar Dyflexis · Contracten met uren en dagen per week naar Dyflexis · Datum uit dienst naar Dyflexis
Waar je op let bij Dyflexis en Nmbrs
- Dyflexis levert de uren per vestiging, per contracttypegroep en per periode. Een medewerker die in één periode op twee vestigingen werkte, staat dus in twee aanleveringen. KoppelHet voegt die samen per Nmbrs-medewerker en houdt de vestiging vast als kostenplaats.
- Bij elke afgesloten periode geeft Dyflexis aan in welke doelperiode en welk jaar de uren verloond worden. KoppelHet boekt op die periode in Nmbrs, ook als de planner een periode van vorige maand pas nu doorstuurt.
- Nmbrs weigert uren in een periode die al voorbij is, tenzij dat expliciet wordt toegestaan. Valt de doelperiode van Dyflexis vóór de huidige Nmbrs-periode, dan zet KoppelHet de aanlevering op gedeeltelijk en meldt de reden, in plaats van stilletjes in een andere periode te boeken.
- Dyflexis kent per medewerker een werkgeversreferentie, en één Nmbrs-omgeving kan meerdere bedrijven hebben. KoppelHet zet het Nmbrs-bedrijf als werkgeversreferentie in Dyflexis, zodat uren van een vestiging van BV A nooit bij BV B landen.
- Looncomponenten in Dyflexis zijn kolommen in het urenoverzicht die de klant zelf instelt. Nmbrs werkt met uurcodes per bedrijf. Een nieuwe toeslag in Dyflexis zonder uurcode in Nmbrs wordt niet geboekt en verschijnt als melding, zodat er geen uren ongezien wegvallen.
- Dyflexis laat meerdere toepassingen dezelfde wachtrij verwerken, elk met een eigen status. Verwerkt een andere toepassing al een deel van de vestigingen, dan kan KoppelHet ernaast werken zonder dat periodes dubbel worden verloond.
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 ziet de planner als er iets misgaat?
KoppelHet zet per afgesloten periode een status in Dyflexis, met een korte reden bij een fout of gedeeltelijke verwerking. De planner ziet dat op de salarispagina van Dyflexis, de details staan in het platform.
Wat verandert er als Nmbrs stopt met de SOAP API?
Nmbrs stopt in 2027 met de SOAP API. KoppelHet bouwt nieuwe koppelingen op de REST API. Bij een bestaande koppeling op SOAP plannen we de overstap ruim voor die datum.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Dyflexis via de Dyflexis API met een token per omgeving en scopes. De wachtrij met GET /api2/payroll/queue/from/{lastQueueId} (maximaal 10 items per aanroep) of de webhook payrollPeriodReady; uren met GET /api/payroll/v3/hours-per-day per vestiging, contracttypegroep en periode; status terug met POST /api2/payroll/queue/{queueId}/status (in progress, success, failed, partial) met een eigen application-ID.
- Medewerkers en contracten naar Dyflexis met POST /api2/external-employees/{employeeReference} (personnelNumber, employerReferenceId, costCenter, employmentStart, employmentEnd) en POST /api2/external-employees/{employeeReference}/contracts (contractReference, office, type, hours, days).
- Nmbrs via de EmployeeService met HourComponentVar_Insert_Batch (EmployeeId, HourCode, Hours, CostCenterId, Period, Year; UnprotectedMode voor een eerdere periode). Nmbrs noemt de SOAP API deprecated en stopt ermee in 2027; nieuwe koppelingen bouwen we op de REST API.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Dyflexis | Veld in Nmbrs | Toelichting |
|---|---|---|
employee.personnelNumber | Medewerker in het Nmbrs-bedrijf | Het Nmbrs-personeelsnummer, door de koppeling in Dyflexis gezet |
employee.employerReferenceId | Nmbrs-bedrijf | Bepaalt in welk bedrijf de uren landen |
components (bijvoorbeeld work, Allowance.150) | HourCode | Via een vertaaltabel van Dyflexis-looncomponenten naar Nmbrs-uurcodes |
Som per component over de periode | Hours | |
period.targetPeriod en targetYear | Period en Year | |
employee.costCenter | CostCenterId | Via een vertaaltabel |
Dienstverband en rooster (terug) | contractReference, hours en days | |
Bedrijf in Nmbrs (terug) | employerReferenceId |
Gerelateerd
DyADP iHCM → Dyflexis
ADP iHCM Dyflexis koppeling: medewerkers en contracten in de planning, uren terug naar ADP
DyADP Workforce Now → Dyflexis
ADP Workforce Now Dyflexis koppeling: medewerkers en contracten van de Europese vestigingen in de planning
DyAFAS Profit → Dyflexis
AFAS Dyflexis koppeling: medewerkers per werkgever naar de planning, verloonde uren als loonmutatie terug
DyBambooHR → Dyflexis
BambooHR Dyflexis koppeling: Nederlandse medewerkers en contracturen uit BambooHR in het rooster