Verlof, verzuim en uren

Dyflexis Loket koppeling: verloonde uren en toeslagen per looncomponent, medewerkers terug

Met een koppeling tussen Dyflexis en Loket gaan de uren en toeslagen van een afgesloten salarisperiode in Dyflexis automatisch als variabele mutatie naar het juiste dienstverband in Loket. Nieuwe medewerkers, contracturen en einddatums uit Loket komen terug in Dyflexis, zodat de planning roostert met de gegevens die de salarisadministratie ook gebruikt.

Bespreek je koppeling Zo werkt de koppeling

Geschreven door Marcel van Beek, oprichter en integratiespecialistLaatst bijgewerkt: 9 november 2026

Wat de koppeling doet

Werkgevers die in Dyflexis roosteren en via een administratiekantoor in Loket verlonen, vergrendelen de periode per vestiging. Met meerdere werkgevers zoekt het kantoor daarna uit welke uren bij welke werkgever horen, en een correctie na het heropenen van een periode levert soms dubbele uren op de loonstrook op.

HR of het administratiekantoor legt een nieuwe werknemer met dienstverband en arbeidstijd vast in Loket.
KoppelHet zet de medewerker met contract, vestiging en contracturen in Dyflexis. Een beheerder verbindt hem daar de eerste keer met een Dyflexis-medewerker.
De planner keurt de uren goed, vergrendelt de periode en zet die klaar voor verloning.
KoppelHet haalt de uren per dag op, vertaalt elk onderdeel naar een looncomponent in Loket en zet ze bij het juiste dienstverband en de juiste werkgever.
In Dyflexis ziet de planner per periode of Loket alles heeft aangenomen. Afgekeurde regels staan met reden in het platform.

Heen: Gewerkte uren per dag en per looncomponent · Toeslagen en vergoedingen uit de afgesloten periode · Kostenplaats per regel · Werknemer en dienstverband (terug naar Dyflexis) · Contracturen en einddatum (terug naar Dyflexis)
Terug: Nieuwe werknemers met dienstverband · Contracturen per week uit de arbeidstijd · Einddatum dienstverband

Waar je op let bij Dyflexis en Loket

Dyflexis levert uren per combinatie van vestiging, contracttypegroep en periode. Wijzigt een contract halverwege de periode, dan staat dezelfde medewerker er meer dan eens in. Loket boekt per dienstverband. KoppelHet telt de regels per dienstverband bij elkaar, zodat ze op de juiste loonstrook komen.
Dyflexis geeft elk onderdeel van de uren een eigen naam, zoals gewerkte uren of een toeslag van 150 procent, ingesteld in de kolommen van de urenstaat. Loket herkent een looncomponent aan het nummer dat salarisprofessionals uit hun hoofd kennen. De vertaling van naam naar nummer leggen we vast met de salarisadministratie, voor de eerste verloning.
Heropent de planner een vergrendelde periode en sluit hij die opnieuw af, dan krijgt de periode in Dyflexis een nieuw kenmerk. Loket overschrijft de waarde van een looncomponent als dezelfde periode en kostenplaats al bestaan, in plaats van er een regel bij te zetten. KoppelHet stuurt daarom steeds het volledige totaal van de periode, zodat een correctie de uren niet verdubbelt.
Dyflexis houdt de werkdagen apart van de salarisperiode waarin de uren betaald moeten worden. Uren uit de laatste week van december kunnen zo in januari worden verloond. KoppelHet boekt op de salarisperiode die Dyflexis aangeeft, niet op de datum van de dienst.
Eén Loket-omgeving kan meerdere werkgevers bevatten, en hetzelfde personeelsnummer kan bij twee werkgevers voorkomen. Dyflexis geeft per medewerker een werkgeverskenmerk mee. KoppelHet gebruikt dat om de werkgever te kiezen, zodat uren van vestiging A niet bij werkgever B terechtkomen.
Loket raadt aan eerst de standaardwaarden van een dienstverband op te vragen, zoals kostenplaats en ploeg, voordat je periodegegevens aanlevert. KoppelHet doet dat per dienstverband. Uren landen zo op de kostenplaats en ploeg die de salarisadministratie heeft ingesteld, tenzij Dyflexis een andere kostenplaats meegeeft.
Dyflexis toont op de salarispagina per verstuurde periode een status, van bezig tot gelukt, mislukt of deels gelukt. KoppelHet zet die status na elke aanlevering aan Loket, zodat de planner in Dyflexis ziet of de periode is aangekomen zonder het administratiekantoor te bellen.

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, architectuur en compliance

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.

Prijsindicatie · Basis

Veelgestelde vragen

Dyflexis heeft zelf een loonkoppeling met Loket. Waarom zouden we KoppelHet nemen?

Vaak is die voldoende. Kies KoppelHet als jullie Loket-omgeving meerdere werkgevers heeft, als uren op wisselende kostenplaatsen moeten landen of als je per medewerker wilt zien wat is geboekt en wat niet.

Wat gebeurt er als de planner een periode weer opent?

Na het opnieuw vergrendelen staat de periode weer klaar. KoppelHet stuurt het nieuwe totaal, en Loket overschrijft de eerdere waarden van dezelfde periode. Is de salarisrun voor die periode al gedraaid, dan krijgt de salarisadministratie een melding.

Gaan verlofsaldi uit Loket ook naar Dyflexis?

Loket kan verlofsaldi leveren, maar de openbare Dyflexis API heeft geen ingang om verlof of saldi aan te leveren. Daarom zit dit niet in de koppeling. Komt die ingang er, dan kan het later als uitbreiding.

Technische details voor IT

Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.

Dyflexis meldt een klaargezette periode via de webhook Payroll period ready of via de wachtrij GET /api2/payroll/queue/from/{lastQueueId} (maximaal 10 items per aanroep; de afnemer houdt zelf bij welke queueId verwerkt is). De uren komen uit GET /api/payroll/v3/hours-per-day/{officeUrl}/{contractTypeGroupName}/{period}, met per medewerker personnelNumber, employerReferenceId en costCenter en per dag components (bijvoorbeeld work, break, Allowance.150). De status gaat terug via POST /api2/payroll/queue/{queueId}/status (in progress, success, failed, partial). Scopes payroll en payroll_hours; token in de header Authorization met het voorvoegsel Token.
Naar Loket schrijven we via de Loket REST API met OAuth (authorization code flow) met PATCH /v2/providers/employers/employees/employments/{employmentId}/payrollperioddata, de REST-opvolger van ImporteerGegevens (Variabele Gegevens). Een record is uniek op payrollPeriod, shift, payslipType, distributionUnit, costCenter en costUnit; meegeleverde payrollComponents overschrijven bestaande waarden, niet meegeleverde blijven staan. Standaardwaarden via /defaults. Loket kent maximaal 15 ploegen per loonadministratie.
Medewerkers gaan naar Dyflexis via POST /api2/external-employees/{employeeReference} en /contracts (upsert op employeeReference en contractReference, scope external_employees). Een nieuwe medewerker is eerst een externe medewerker die een beheerder in Dyflexis koppelt.

Welke velden overgaan

De belangrijkste velden. De volledige mapping stellen we per klant vast.

Veld in Dyflexis	Veld in Loket	Toelichting
`personnelNumber`	`employeeNumber (via het dienstverband)`	Het Loket-personeelsnummer is de sleutel in beide richtingen
`employerReferenceId`	`Werkgever (employerId)`	Bepaalt bij welke werkgever in Loket de uren landen
`period.targetYear en targetPeriod`	`payrollPeriod.year en periodNumber`
`components (bijvoorbeeld work, Allowance.150)`	`payrollComponents (key en value)`	Via een vertaaltabel die de salarisadministratie goedkeurt
`costCenter`	`costCenter van de periodegegevens`	Anders de standaardkostenplaats van het dienstverband
`Loket firstName, prefix, lastName (terug)`	`firstName, lastNamePrefix, lastName`
`Loket begin- en einddatum dienstverband (terug)`	`employmentStart en employmentEnd`
`Loket averageHoursPerWeek (terug)`	`hours van het Dyflexis-contract`

Bronnen

Gerelateerd

Kerngegevens

Richting: Dyflexis ⇄ Loket · Twee richtingen
Wanneer: De planner vergrendelt een salarisperiode in Dyflexis en zet die klaar voor verloning; voor de weg terug een nieuwe werknemer of gewijzigd dienstverband in Loket
Frequentie: Uren zodra Dyflexis meldt dat een periode klaarstaat; medewerkers op een vast interval dat we per klant afspreken
Wat gaat er over: Gewerkte uren per dag en per looncomponent
Toeslagen en vergoedingen uit de afgesloten periode
Kostenplaats per regel
Werknemer en dienstverband (terug naar Dyflexis)
Contracturen en einddatum (terug naar Dyflexis)
Doorlooptijd implementatie: Indicatie: twee tot vier weken

Past dit bij jullie situatie?

Doe de online intake. Een consultant bereidt de vragen voor op jullie systemen en werkt daarna het ontwerp en de offerte uit.

Bespreek je koppeling