HR, salaris & planning

Loket.nl-koppeling laten maken

Ik koppel Loket.nl aan je planning, urenregistratie, HR-systeem, dashboard of boekhouding via de REST API van Loket. Uren en andere variabele gegevens gaan erin, loonresultaten, verlof en journaalposten komen eruit. Loket beslist zelf over toegang: de softwarepartij die koppelt vraagt die aan, en Loket gaat uit van een koppeling die meerdere werkgevers kunnen gebruiken. Dat traject bereid ik met je voor.

Alle integraties

Zo loopt de data

voorbeeldopzet

Sync-log, zoals je hem in het logboek terugziet (voorbeeld)

Gewerkte uren komen uit de planning als mutaties, nieuwe medewerkers uit het HR-systeem als concept, journaalposten gaan naar de boekhouding en loonresultaten en verzuim naar een dashboard.
  • Uren, wordt Mutaties: van Planning naar Loket.nl, per batch.
  • Medewerker, wordt Concept: van HR-systeem naar Loket.nl, periodiek opgevraagd.
  • Journaalpost: van Loket.nl naar Boekhouding, periodiek opgevraagd.
  • Loonrun, Verzuim: van Loket.nl naar Dashboard, op verzoek.

Kort antwoord

Werkgebied: Nederland · Bijgewerkt op door Alisina Nawabi

Wat het is
Een Loket.nl-koppeling verbindt Loket met je andere systemen via de REST API van Loket. Uren, verlof, verzuim en andere variabele gegevens gaan per dienstverband naar Loket; medewerkers, loonresultaten en journaalposten komen eruit. Toegang loopt via OAuth en een client die Loket goedkeurt.
Voor wie
Softwarebedrijven met plannings-, uren-, HR- of verzuimsoftware die Loket willen ondersteunen, en accountantskantoren en salarisbureaus die eigen software of dashboards over veel werkgevers bouwen.
Doorlooptijd
Een eerste koppeling tussen twee systemen staat meestal binnen 2 weken live. Meer objecten, richtingen of administraties kosten meer tijd; dat staat vooraf in de offerte. De aanvraag en goedkeuring bij Loket lopen daar los van.
Prijsindicatie
vanaf €4.000 voor een basisopzetEen basisopzet is één koppeling tussen twee systemen, gebouwd, getest en gedocumenteerd. Meer objecten, richtingen, administraties of uitzonderingen maken het groter. Je krijgt vooraf een vaste prijs.

Welke data synchroniseer ik?

Zo richt ik het meestal in. De tabel is ook het startpunt van de intake: jij bepaalt per object de richting en de bron.

Welke data de koppeling synchroniseert, in welke richting, wie de bron is en hoe vaak
ObjectRichtingBron van waarheidFrequentie
Nieuwe medewerkersAls conceptmedewerker, die de salarisadministratie in Loket aanvult en omzet. Dat raadt Loket zelf aan.naar Loket.nlHR-systeemBij elke indiensttreding
Medewerkers, dienstverbanden en NAWVersienummers laten zien welke vaste gegevens van dienstverbanden veranderden.van Loket.nlLoketDagelijks
Uren, toeslagen en andere variabele gegevensPer dienstverband. Welke looncomponenten er zijn, verschilt per administratie.naar Loket.nlPlanning of urenregistratiePer salarisperiode, vóór de loonrun
Verlof en verlofaanvragenbeide kantenPer organisatie afgesprokenDagelijks
Verzuimbeide kantenVerzuimsysteem of Loket, per afspraakBij elke melding
LoonresultatenEén loonrun kan ook correcties voor eerdere periodes in hetzelfde jaar bevatten.van Loket.nlLoketNa elke afgeronde loonrun
JournaalpostenAlleen met de module journaliseren van Loket. Voor onder meer Exact Online, Twinfield en SnelStart stuurt Loket de journaalpost zelf door, sinds 1 oktober 2026 alleen met het journaalprofiel; maatwerk boekt hem in een pakket dat niet in de lijst met koppelingen van Loket staat.van Loket.nlLoketNa elke journaalrun

Wat je met een Loket.nl-koppeling doet

Voor bedrijven die zelf met de software werken, en voor wie er een product op bouwt voor eigen klanten.

  1. Uren uit je eigen planning als mutaties in Loket

    Salarisbureau of werkgever met een eigen plannings- of urensysteem

    1. Client aangevraagd bij Loket en goedgekeurd
    2. Uren goedgekeurd in de planning
    3. Als variabele gegevens per dienstverband in Loket
    4. Salarisadministratie controleert vóór de loonrun

    Gewerkte uren en toeslagen staan in de loonrun zonder importbestand en zonder overtypen.

    Wat de API hiervoor biedt: Uren en andere variabele gegevens gaan per dienstverband en per salarisperiode naar Loket; één aanroep voegt toe of werkt bij, zonder eerst op te halen. Welke looncomponenten beschikbaar zijn, hangt af van de salarisadministratie. Toegang vraagt de softwarepartij aan, en Loket beslist erover.

    Lees de uitwerking in de gids
  2. Journaalposten naar een boekhouding zonder standaardexport

    Werkgever of accountantskantoor met de module journaliseren

    1. Journaalrun afgerond in Loket
    2. Grootboek, kostenplaats en kostendrager opgehaald
    3. Gemapt op je eigen rekeningschema
    4. Geboekt in de boekhouding of het ERP

    De salariskosten staan na elke run op de juiste rekening en kostenplaats, ook in een pakket waarvoor Loket zelf geen export heeft.

    Wat de API hiervoor biedt: Een journaalrun berekent grootboekrekening, kostenplaats en kostendrager, en de API geeft de uitkomst als de werkgever de module journaliseren heeft. Voor onder meer Exact Online, Twinfield en SnelStart heeft Loket zelf een journaalkoppeling: de koppelingenpagina over Exact Online spreekt van een bestand dat je in Exact inleest, het helpartikel over de journaalapplicatie van een automatische OAuth-koppeling. Automatisch exporteren kan sinds 1 oktober 2026 alleen nog met het journaalprofiel.

  3. Eén overzicht van al je werkgevers

    Accountantskantoor of salarisbureau met veel werkgevers in Loket

    1. Per werkgever een integratiegebruiker met alleen de nodige rechten
    2. Toestemming via OAuth, één keer per gebruiker
    3. Loonresultaten, verlof en verzuim per werkgever opgehaald
    4. Signalen en rapportage in één dashboard van het kantoor

    Het kantoor ziet afwijkingen volgens zijn eigen regels bij al zijn werkgevers op één plek, zonder exports per klant.

    Wat de API hiervoor biedt: Eén Loket-gebruiker kan bij meerdere werkgevers, met per werkgever eigen rechten. Loket raadt voor een koppeling een integratiegebruiker per werkgever aan, zodat gegevens van werkgevers onder dezelfde accountant gescheiden blijven. Loket heeft zelf rapportages die verder kijken dan één werkgever, en werkt aan een Salarismonitor over meerdere werkgevers heen; maatwerk past bij eigen signalen, of bij gegevens van buiten Loket ernaast.

    Lees de uitwerking in de gids

Wat de API van Loket.nl ondersteunt

Per object wat er via de API kan. Dit bepaalt wat een koppeling wel en niet kan doen.

Per object: lezen, aanmaken, wijzigen, verwijderen en webhook-ondersteuning in de Loket.nl-API
ObjectLezenAanmakenWijzigenVerwijderenWebhook
Werkgevers/v2/providers/employersAanmaken doet de provider, meestal het accountantskantoor. Een gebruiker ziet alleen de werkgevers waar hij bij mag.jajajaneenee
Medewerkers/employers/{employerId}/employees, conceptemployeesEen nieuwe medewerker bij voorkeur als concept, dat de salarisadministratie afmaakt.jadeelsjaneenee
Dienstverbanden/employees/employmentsWijzigingen herken je aan versienummers.jadeelsjajanee
Salarisperiodes/payrolladministrations/{id}/payrollperiodsMaand, vier weken of week, per administratie.janeeneeneenee
Variabele gegevens/employments/{employmentId}/payrollperioddataUren en andere mutaties. Een PATCH voegt toe of werkt bij.jajajajanee
Salaris/employments/{employmentId}/wagesjajajajanee
Vaste looncomponenten/employments/{employmentId}/benefitsanddeductionsjajajajanee
Arbeidspatroon/employments/{employmentId}/workinghoursjajajajanee
Verlof/employments/{employmentId}/leave, leaverequestsVerlofaanvragen: aanmaken en status wijzigen. Saldi alleen lezen.jajajajanee
Verzuim/employees/{employeeId}/absencesOp de persoon, niet op het dienstverband.jajajajanee
Loonruns en resultaten/payrollruns, /payrollruns/{id}/resultsEen loonrun starten of terugdraaien gaat via acties; wijzigen alleen voor de datum waarop medewerkers hem zien. Resultaten als gegevens per dienstverband.jajadeelsneenee
Loonstroken en jaaropgaven/payslips, /yearendstatementsDe introductie noemt loonstroken als beschikbare gegevens, maar de referentie markeert de PDF-downloads als alleen voor de Loket-applicatie.deelsneeneeneenee
Journaalposten/journalruns, /journalruns/{id}/resultsEen journaalrun starten, de uitkomst lezen en als geëxporteerd markeren, met de module journaliseren.jajadeelsneenee
Afdelingen/employers/{employerId}/departmentsjajajaneenee
Kostenplaatsen en kostendragers/journal/…/journalprofiles/{id}/costcentersPer journaalprofiel, in de aparte Journal-API.jajajajanee

ja kan via de APIdeels kan met beperkingennee kan niet

Techniek en deadlines

De feiten waar een koppeling op rust, met de bron erbij. En wat er de komende tijd verandert.

API
REST met JSON op api.loket.nl, versie 2. Elke resource heeft daarnaast een eigen versie per datum in de Accept-header. Nieuwere onderdelen, zoals de journaal-API, staan in aparte microservices met eigen documentatie. De oude SOAP-webservices zijn sinds 2021 uit.
Authenticatie
Alleen OAuth 2.0 met authorization code, met scope all. Geen wachtwoord-grant en geen andere automatische flow voor externe partijen. Een refresh token is meestal een jaar geldig en nu maar drie keer bruikbaar; sla steeds de nieuwste op.
Rechten
Twee lagen. De client van de softwarepartij krijgt van Loket alleen de activiteiten die de koppeling echt gebruikt; de gebruiker heeft rechten per werkgever, en die beheert de accountant of werkgever, niet Loket. Het token geeft toegang tot de API, niet tot Loket zelf.
Testen
Een acceptatieomgeving op api.loket-acc.nl met een beperkte set testdata. Na een goedgekeurde aanvraag krijg je een testgebruiker en een algemene testclient.
Limieten
Loket handhaaft nu geen expliciete limieten, maar volgt het gebruik en neemt contact op bij extreem gebruik. Lijsten geven standaard 250 regels per pagina.
Webhooks
Geen. Wijzigingen in vaste gegevens van dienstverbanden herken je aan versienummers; variabele gegevens vallen daar buiten en vraag je per periode op.
Wijzigingen
Loket kan de API zonder aankondiging wijzigen. Het streven is twee weken vooraf, en bij een nieuwe versie van een resource blijft de oude nog zes maanden werken; elk antwoord meldt een obsoleteDate.
Toegang
Een aanvraag begint commercieel, via het partnerformulier van Loket. Productie volgt pas na goedkeuring, gebruikersdocumentatie en een API-gebruikersovereenkomst via DocuSign; daarna volgen een demo aan het Loket-team en de publicatie van de koppeling.
Hosting
Microsoft Azure in Nederlandse datacenters, met een ISAE 3402 type II-verklaring sinds 2010.
Bereik
Loket noemt meer dan 145.000 werkgevers, 400 accountantskantoren en koppelingen met meer dan 100 applicaties.

Deadlines en wijzigingen

Wat de leverancier heeft aangekondigd, en wat het voor een bestaande koppeling betekent.

  1. al ingegaan

    Download van het overzicht loonaangifte verouderd

    Het oude endpoint voor het overzicht van de loonaangifte is verouderd; een koppeling die het gebruikt, gaat naar de vervanger.

  2. al ingegaan

    Downloads van loonrunrapporten krijgen nieuwe endpoints

    Loonstaten, betaaloverzichten en andere PDF-rapporten van een loonrun hebben nieuwe adressen. De oude werken nog, maar zijn verouderd; een einddatum noemt Loket niet.

  3. komt eraan

    Huidige versie van de fiscale eigenschappen vervalt

    Er is een nieuwe versie van de fiscale eigenschappen. Een koppeling die de huidige versie leest of schrijft, moet vóór 1 januari 2027 over.

App, iPaaS of maatwerk?

Niet elke koppeling hoeft maatwerk te zijn. Zo kies je de route die past.

Een koppeling uit de Marketplace van Loket

Past als: Loket noemt koppelingen met meer dan 100 applicaties, en de Marketplace in Loket toont de gecertificeerde. Gebruikt je planning of HR-pakket er een, begin daar.

Grens: Je volgt de logica van de leverancier. Eigen looncomponenten, afwijkende uurcodes of een eigen dashboard over veel werkgevers lukken vaak niet.

Zapier, Make of n8n

Past als: Voor een losse melding of export, als je software al een goedgekeurde client van Loket heeft.

Grens: Loket laat alleen goedgekeurde clients toe via OAuth, met een refresh token dat maar drie keer bruikbaar is. Dat moet de flow foutloos bijhouden, en voor salarisgegevens is een losse flow kwetsbaar.

Maatwerk op de Loket REST API

Past als: Als je software Loket voor meerdere werkgevers moet ondersteunen, als uren en looncomponenten precies goed moeten landen, of als je per werkgever rechten wilt controleren.

Grens: Loket beslist over toegang en productie, en gaat uit van een koppeling die meerdere werkgevers kunnen gebruiken. Voor een systeem dat niet in de lijst met koppelingen staat, noemt Loket ook zijn eigen integratiepartners.

Standaard-app, iPaaS of maatwerk voor Loket.nl?

Bestaat er al een app in de marktplaats die precies doet wat je met Loket.nl wilt?

Zo pak ik het aan

Vier stappen, met een vaste prijs vooraf. Een basisopzet begint vanaf €4.000.

  1. 1

    Dag 1

    Intake

    Een kort gesprek over je systemen, je proces en wat er misgaat. Ik vul samen met jou de sync-tabel in: welk object, welke richting, wie de bron is en hoe vaak.

  2. 2

    Binnen een paar dagen

    Vaste offerte

    Je krijgt een voorstel met scope, vaste prijs en planning. Geen uurtje-factuurtje: je weet vooraf wat het kost en wat je krijgt.

  3. 3

    Week 1-2

    Bouwen en testen

    Ik bouw de koppeling op jouw eigen account en test met echte voorbeelden, inclusief de randgevallen: creditnota's, dubbele records, een API die even niet antwoordt. Een eerste koppeling staat binnen 2 weken live.

  4. 4

    Daarna

    Live en beheer

    De koppeling gaat live met monitoring en een foutenlijst die je kunt inzien. Je krijgt documentatie en een overdracht. Onderhoud kan, maar hoeft niet bij mij.

Veilig, en van jou

Hoe ik met je toegang omga, en waarom de koppeling op jouw account draait.

Ik vraag nooit om je Loket-wachtwoord.

  • Toestemming loopt via OAuth met een eigen integratiegebruiker, met alleen de rechten die de koppeling nodig heeft. De accountant of werkgever beheert die gebruiker.
  • Salarisgegevens gaan rechtstreeks tussen jouw systemen en Loket, zonder omweg via derden.
  • Tokens staan versleuteld, in jouw omgeving of op een Europese server.
  • Ik bouw en test op de acceptatieomgeving van Loket met testdata, nooit in je echte salarisadministratie.

Wie beheert de koppeling

De koppeling draait op jouw account, niet op dat van mij. Ik bouw, documenteer en onderhoud hem; jij houdt het eigendom en de toegang.

Account
De koppeling draait op een API-client van de softwarepartij die koppelt: jouw bedrijf als het je eigen software is, of de leverancier van je systeem. Loket maakt die client aan na een aanvraag en zet hem pas na goedkeuring in productie. De integratiegebruiker in Loket beheert de accountant of werkgever.
Sleutels
Client ID, client secret en tokens staan in jouw omgeving. Gebruikers en rechten in Loket beheert de accountant of werkgever; wie de rechten van de integratiegebruiker intrekt, zet de koppeling stil.
Goedkeuring door de leverancier
Loket keurt elke koppeling zelf goed en vraagt gebruikersdocumentatie, een API-gebruikersovereenkomst via DocuSign en daarna een demo aan het Loket-team. Dat traject loopt op naam van de softwarepartij; ik bereid het met je voor. Een plek in de Marketplace van Loket is aan Loket.
  • Jouw account en jouw app-registratie bij de leverancier. Ik verkoop geen eigen koppel-abonnement en zit er niet tussen.
  • Jij bent eigenaar van de code en de documentatie. Stop je met mij, dan kan een andere ontwikkelaar verder.
  • Bouw je zelf een product voor jouw klanten? Dan draait het op jouw toegang en, waar de leverancier dat vraagt, op jouw certificering.

Onderhoud en monitoring

Een koppeling is pas af als je merkt dat er iets misgaat voordat je klant het merkt.

Foutenlijst met herkansing
Wat niet lukt, verdwijnt niet. Het komt in een wachtrij met de reden erbij en wordt opnieuw geprobeerd, met steeds langere tussenpozen.
Geen dubbele of gemiste records
Elke boeking krijgt een vaste sleutel, zodat een herhaalde poging nooit een tweede factuur of order maakt.
Alarm bij stilte
Komt er een tijd geen data binnen terwijl dat wel zou moeten, dan krijg je een melding. Een stilgevallen koppeling merk je zo voordat je klant belt.
Logboek
Per record zie je wanneer het ging, wat er ging en wat het andere systeem antwoordde. Handig voor je boekhouder en voor jezelf.
Refresh tokens zuinig gebruikt
Een refresh token van Loket is nu maar drie keer bruikbaar. De koppeling bewaart steeds het nieuwste en waarschuwt als een gebruiker opnieuw toestemming moet geven.
Resourceversies bijgehouden
Elk antwoord van Loket meldt wanneer een versie vervalt. Ik volg dat en de changelog, en zet een koppeling om voordat een oude versie stopt, zoals de fiscale eigenschappen per 1 januari 2027.
Rechten per werkgever gecontroleerd
Voor elke werkgever controleert de koppeling eerst of de integratiegebruiker de nodige rechten heeft, en meldt het als er een ontbreekt in plaats van stil te falen.
Rapporten op de nieuwe endpoints
Loket vervangt de downloads van loonrunrapporten. Ik gebruik de nieuwe adressen en houd de lijst met vervangers bij.

Verder lezen

Mijn gidsen en artikelen die dieper ingaan op Loket.nl.

HR-software kiezen: test één wijziging van dossier tot salaris
Gids
Uitgebreide gids20 min

1 nov 09:00

HR-software kiezen: test één wijziging van dossier tot salaris

Test één personeelswijziging van dossier via planning naar salaris voordat je HR-software kiest. Vergelijk een geïntegreerde suite, een bestaande koppeling en maatwerk op rechten, correcties, vrijgave en read-back.

Schoonmaakbedrijf: van uren per locatie naar een kloppende factuur per contract
Gids
Uitgebreide gids14 min

2 sep 09:00

Schoonmaakbedrijf: van uren per locatie naar een kloppende factuur per contract

Aan het eind van de maand weten wie waar hoe lang stond, of dat binnen de contractnorm past en welk meerwerk je mag doorbelasten. Met de drie beslissingen die je neemt voordat welk pakket dan ook helpt.

Wtta als uitlener: zo maak je je administratie klaar voor de overgangsregeling
Gids
Uitgebreide gids18 min

9 sep 09:00

Wtta als uitlener: zo maak je je administratie klaar voor de overgangsregeling

Leen je personeel uit, ook af en toe vanuit een bouw-, schoonmaak- of installatiebedrijf? Zo bepaal je of de Wtta geldt, splits je de uitleenomzet en bouw je het bewijsdossier voor 2027.

Verzuimdossier op orde: welk bewijs je per week 6, 8, 42 en 52 nodig hebt
Gids
Uitgebreide gids18 min

8 sep 17:00

Verzuimdossier op orde: welk bewijs je per week 6, 8, 42 en 52 nodig hebt

Een praktische dossierinventarisatie voor werkgevers zonder HR-afdeling. Vind per mijlpaal het juiste document, de bron, de eigenaar, de AVG-grens en het bewijs dat je bij spoor 2 en een arbodienstwissel niet mag verliezen.

KING Financieel en KING Factureren stoppen op 31 oktober 2026: welke route kost jou het minst?
Gids
Uitgebreide gids14 min

7 aug 09:00

KING Financieel en KING Factureren stoppen op 31 oktober 2026: welke route kost jou het minst?

Op 31 oktober 2026 kun je KING Financieel en KING Factureren alleen nog raadplegen. Je koppelingen verhuizen bij geen enkele route mee. Vier routes naast elkaar, met de prijzen en een tijdlijn die terugrekent.

Nmbrs stopt met de SOAP-API op 1 maart 2027: zo weet je of jouw salariskoppeling erop draait
Gids
Uitgebreide gids12 min

6 aug 09:00

Nmbrs stopt met de SOAP-API op 1 maart 2027: zo weet je of jouw salariskoppeling erop draait

Nmbrs zet zijn SOAP-API uit op 1 maart 2027. Zo stel je vast of jouw salariskoppeling erop draait, wie het migratiewerk doet en betaalt, en hoe je terugrekent naar een deadline waar een jaarovergang in past.

Andere koppelingen

Werk je met meer tools? Combineer Loket.nl met je andere systemen en zie hoe er één workflow van ontstaat.

FAQ

Veelgestelde vragen over de Loket.nl-koppeling

Antwoorden op wat het vaakst gevraagd wordt over Loket.nl koppelen.

Klaar om Loket.nl te koppelen?

Vertel me welke systemen je gebruikt en wat er nu misgaat. Ik denk mee en zeg eerlijk wat er kan, vrijblijvend.

Bekijk alle integraties

Liever eerst zelf kijken waar de winst zit? Doe de gratis automatiseringsscan