KOPPELINGENLOKET.NLAPI-koppeling met Loket.nl
Loket.nl werkt in lagen: het accountantskantoor verloont, de werkgever kijkt mee, en een koppeling krijgt alleen de handelingen die hij echt gebruikt. Wie Loket koppelt aan een HR-systeem, planning of boekhouding, moet die lagen kennen. Dan komen uren in de juiste periode en staat de journaalpost zonder overtypen in de boekhouding.
ISO 9001 & 27001- Werknemers en dienstverbanden gaat heen en weer met Je andere systemen
- Uren en variabele looncomponenten gaat heen en weer met Je andere systemen
- Loonruns en resultaten gaat heen en weer met Je andere systemen
- Journaalposten gaat heen en weer met Je andere systemen
Onder meer gebouwd voor Tata Steel, M&G Investments, Digistore24, Toppers in Concert, Bar-le-Duc en Loogman
Dit zijn de gegevens die organisaties het vaakst tussen systemen laten lopen. Welke daarvan voor jou tellen, hangt af van waar het werk nu blijft liggen.
Werknemers en dienstverbanden
In Loket heeft een werknemer één of meer dienstverbanden, altijd binnen één werkgever. HR-gegevens horen meestal bij de werknemer, salarisgegevens bij het dienstverband. Wie dat onderscheid mist, koppelt uren aan de verkeerde plek.
Uren en variabele looncomponenten
Gewerkte uren en andere looncomponenten per periode, per dienstverband. Welke componenten mogelijk zijn, verschilt per loonadministratie; de API geeft de mogelijke waarden op.
Loonruns en resultaten
Afgeronde loonruns met per dienstverband de looncomponenten en hun waarde, plus downloads zoals loonstroken in pdf. Correcties met terugwerkende kracht verwerkt Loket in de eerstvolgende run.
Journaalposten
De journaalruns met de boekingen voor de financiële administratie. Daarvoor moet bij de werkgever de module journaliseren actief zijn: van de drie journaalmodules werkt de API alleen met deze nieuwste.
Nieuwe medewerkers als concept
Een HR-systeem kan een conceptwerknemer aanmaken met de gegevens die het heeft. Het salariskantoor vult aan en zet hem om naar een echte werknemer. Loket raadt die route aan boven een volledige werknemer via de API.
Afdelingen en functies
De organisatorische eenheden per dienstverband, zoals afdeling en functie. Die bepalen of loonkosten in de boekhouding of rapportage op de juiste plek landen.
Per combinatie: welke gegevens er heen en weer gaan, wat de standaardkoppeling doet en waar je op moet letten.
- Koppeling Exact Online en LoketKoppeling tussen Exact Online en Loket.nl: hoe de loonjournaalpost in Exact komt, wie hem activeert en wanneer je de journaalrun zelf via de API ophaalt.
- Koppeling Loket en AFASKoppeling tussen Loket.nl en AFAS: de standaardkoppeling voor AFAS SB, journaalposten in AFAS Profit en nieuwe medewerkers uit AFAS als concept in Loket.
Niet altijd. Doet een bestaande koppeling voor Loket.nl precies wat je nodig hebt, dan zeggen we dat ook.
Loket koppelt volgens de eigen site met meer dan honderd applicaties, voor uren, mutaties, journaalposten en meer. Op het koppelingenoverzicht staan onder meer Exact Online, SnelStart, Twinfield, e-Boekhouden.nl, HiBob en Personio.
Voor de journaalpost naar de boekhouding is een standaardkoppeling vaak genoeg. Bij Exact Online maakt Loket een bestand in het formaat van Exact, dat in Exact Online wordt ingelezen; het kantoor activeert de koppeling voor de werkgever. Voor AFAS SB gaan de journaalposten elke nacht automatisch over.
Uren uit een eigen planning, medewerkers uit een HR-systeem zonder standaardkoppeling of loonkosten terug naar een projectsysteem vragen een eigen koppeling op de API. We kunnen Loket aan elk systeem koppelen.
- Uren en toeslagen uit je eigen planning moeten per dienstverband in de juiste periode in Loket landen.
- Nieuwe medewerkers uit je HR-systeem moeten als conceptwerknemer klaarstaan voor het salariskantoor.
- Je wilt loonkosten per project of afdeling terug in een ander systeem dan de boekhouding.
- Je verloont als kantoor voor veel werkgevers en wilt toestemmingen en fouten per werkgever overzien.
REST API met JSON
Loket heeft een REST API met JSON. De oudere SOAP-webservices zijn sinds 2021 niet meer beschikbaar. Er is een acceptatieomgeving met een beperkte set testdata, op api.loket-acc.nl, en een productieomgeving met echte klantgegevens.
OAuth met toestemming van de gebruiker
Toegang loopt via OAuth 2.0 met een code flow, waarin de gebruiker zelf toestemming geeft. Met het refresh token haal je een access token op, dat beperkt geldig is. Een refresh token kun je een beperkt aantal keren gebruiken; bewaar het nieuwe dat je terugkrijgt.
Rechten voor client én gebruiker
Een aanroep slaagt alleen als de client toegang heeft tot die handeling én de gebruiker de rechten heeft. De client richt Loket in, de gebruiker meestal het accountantskantoor. In productie krijgt een client alleen de handelingen die de koppeling echt gebruikt; die lijst lever je aan bij de aanvraag.
Van aanvraag tot productie
Je vraagt eerst een koppeling aan bij Loket; die stap is commercieel. Na akkoord krijg je inloggegevens voor een algemene testclient en een testgebruiker. Productie volgt pas na ontwikkeling en de eerste testfases, met een eigen client en vooraf geregistreerde redirect-URI's.
Limieten, pagina's en versies
Er gelden nu geen expliciete limieten, maar Loket houdt het gebruik in de gaten, bijvoorbeeld bij veel foutieve aanroepen. Lijsten geven standaard 250 records per pagina. Resources hebben versies; raakt een versie verouderd, dan is het veld obsoleteDate niet meer leeg.
Een koppeling verplaatst gegevens. AI kan daartussen lezen, sorteren en een voorstel klaarzetten. Waar het ertoe doet, beslist een mens.
Uren nakijken vóór de run
Voordat uren naar Loket gaan, vergelijkt AI ze met het rooster en met vorige periodes, en markeert opvallende regels. De salarisadministrateur beslist. Loket rekent het salaris uit, AI niet.
Een nieuwe medewerker compleet maken
AI legt een conceptwerknemer naast het contract en meldt wat ontbreekt of niet klopt, zoals een afwijkende ingangsdatum. Het salariskantoor vult aan en zet de werknemer om.
Geen salarisgegevens in een prompt
Loonstroken en BSN horen niet in een AI-stap. Geef AI alleen wat nodig is, zoals uren en roosters, en laat hem niets wijzigen in Loket.
Een nul is geen leeg veld
Wil je een looncomponent in een periode leegmaken, stuur hem dan met de waarde null, niet met 0. Loket raadt een 0 af, omdat die onverwachte gevolgen voor de verloning kan hebben.
Records die lijken te ontbreken
Mis je werknemers of runs in een antwoord, dan ligt het volgens Loket meestal aan de rechten van de gebruiker of aan de paginering. De API filtert zelf niets weg. Blader door alle pagina's en controleer de rechten voordat je je eigen code gaat doorzoeken.
Ook oude dienstverbanden
De lijst met dienstverbanden van een werkgever bevat ook dienstverbanden die al jaren zijn beëindigd. Filter in de aanroep, anders zet je oud-medewerkers terug in je planning.
Lege tekst wordt geweigerd
De API accepteert lege tekst meestal niet als waarde en geeft dan een foutmelding die nergens op lijkt te slaan. Stuur null in plaats van een lege string.
Wat moet waarheen
Welke gegevens gaan over, in welke richting, en welk systeem leidend is als twee waarden verschillen. Dat staat op papier voordat er iets gebouwd wordt. Voor deze koppeling gaat het om: Werknemers en dienstverbanden, Uren en variabele looncomponenten, Loonruns en resultaten, Journaalposten, Nieuwe medewerkers als concept, Afdelingen en functies.
Velden en regels
Per veld de vertaling tussen de systemen: statussen, btw-codes, grootboekrekeningen, artikelnummers. En wat er gebeurt bij een dubbel of een ontbrekend gegeven. Voor deze koppeling gaat het om: REST API met JSON, OAuth met toestemming van de gebruiker, Rechten voor client én gebruiker, Van aanvraag tot productie, Limieten, pagina's en versies.
Testen met echte gevallen
In een testomgeving of testadministratie, met de uitzonderingen die in de praktijk voorkomen: creditnota's, deelleveringen, gewijzigde klantgegevens.
Live, met logging en bewaking
Elke synchronisatie wordt gelogd en bij een fout krijgt iemand een melding. Verandert de API van een leverancier, dan passen wij de koppeling aan.
Geen accountmanager. Je spreekt iemand die zelf koppelingen bouwt, en die zegt het ook als een standaardkoppeling genoeg is.
- Kantoor aan de Duivendrechtsekade in Amsterdam
- ISO 9001 en ISO 27001, gecertificeerd door Kiwa
- 500 projecten opgeleverd
- 4,8 uit 127 reviews
Heeft Loket.nl een API?
Ja. Loket heeft een REST API met JSON en OAuth 2.0, met een acceptatie- en een productieomgeving. De oude SOAP-webservices zijn sinds 2021 niet meer beschikbaar.
Hoe krijg ik toegang tot de API van Loket?
Je vraagt een koppeling aan via de site van Loket; die eerste stap is commercieel. Na akkoord krijg je inloggegevens voor de acceptatieomgeving. Productie volgt na ontwikkeling en testen, met een eigen client die alleen de handelingen krijgt die je koppeling gebruikt.
Heeft de Loket API limieten?
Op dit moment gelden er geen expliciete limieten. Loket houdt het gebruik wel in de gaten en neemt contact op bij extreem gebruik, zoals veel foutieve aanroepen.
Kan Loket journaalposten naar de boekhouding sturen?
Op het koppelingenoverzicht van Loket staan onder meer Exact Online, Twinfield, SnelStart en e-Boekhouden.nl. Via de API haal je journaalruns ook zelf op, als de werkgever de module journaliseren heeft.
Kan ik nieuwe medewerkers via de API in Loket zetten?
Ja, het liefst als conceptwerknemer. Je HR-systeem levert wat het weet, het salariskantoor vult aan en zet de werknemer om. Een volledige werknemer via de API vraagt veel verplichte velden, en daar komen er door nieuwe regels bijna elk jaar bij.
Wie beheert de gebruikers voor een Loket-koppeling?
In productie meestal het accountantskantoor, soms de werkgever. Loket maakt in productie zelf geen gebruikers aan. De client van de koppeling beheert Loket wel.
- AFAS koppelen aan je andere systemenBedrijfssoftware van AFAS die HR en salaris, financiën, verkoop, inkoop en projecten in één omgeving samenbrengt.
- Nmbrs koppelen aan je andere systemenOnline salarisadministratie en HR-software voor werkgevers en voor accountants die voor meerdere werkgevers verlonen.
Bronnen
De technische feiten op deze pagina komen uit de officiële documentatie van de leveranciers, gecontroleerd op 19 september 2026. Leveranciers passen hun API's en limieten aan; bij een koppeling kijken we altijd naar de actuele stand.