{"article":{"id":360010294760,"url":"https://loket.zendesk.com/api/v2/help_center/nl/articles/360010294760.json","html_url":"https://helpdesk.loket.nl/hc/nl/articles/360010294760-Handleiding-koppeling-externe-partijen","author_id":53469751,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":1,"vote_count":1,"upvote_count":1,"downvote_count":0,"section_id":360003683339,"created_at":"2019-11-06T08:55:47Z","updated_at":"2026-09-30T19:25:54Z","name":"Handleiding koppeling externe partijen","title":"Handleiding koppeling externe partijen","source_locale":"nl","locale":"nl","outdated":false,"outdated_locales":[],"edited_at":"2026-09-24T10:15:59Z","user_segment_id":null,"permission_group_id":273009,"content_tag_ids":[],"label_names":["handleiding","koppeling","API","REST","consent flow","endpoints","developer portal"],"body":"<p><span style=\"color: hsl(334,57%,47%);\"><strong>Introductie</strong> </span><br><span style=\"color: hsl(231,50%,30%);\">Loket biedt veilige en efficiënte gegevensuitwisseling met externe applicaties via een RESTful API. Deze handleiding beschrijft de stappen voor het opzetten van een koppeling, inclusief gebruikersbeheer, consent flow en technische documentatie. </span></p><p><span style=\"color: hsl(334,57%,47%);\"><strong>Hoe werkt het?</strong> </span></p><p><span style=\"color: hsl(334,57%,47%);\"><strong>1. Aanmaken van een gebruiker</strong> </span><br><span style=\"color: hsl(231,50%,30%);\">Voor een koppeling is een Loket-gebruiker nodig: </span></p><ul>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"ede37764d8644df1c5b027a77dcb7e021\"><span style=\"color: hsl(231,50%,30%);\">Bij voorkeur op werkgeverniveau (niet op providerniveau), om datalekken tussen werkgevers te voorkomen. Bij gebruikers op providerniveau is er sprake van een team waaronder meerdere werkgevers kunnen hangen welke mogelijk niets met elkaar te maken hebben.</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e59d282bedcf1ff985381db1b16c8f48c\"><span style=\"color: hsl(231,50%,30%);\">Geen webservicegebruiker, maar een normale gebruiker die uitsluitend voor de koppeling wordt gebruikt. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e79b9d88fa5836cce0afbc738ce80c71d\"><span style=\"color: hsl(231,50%,30%);\"><strong>De gebruiker moet actief en niet geblokkeerd zijn</strong>. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"ef44d05a15691f71335517c33275219b7\"><span style=\"color: hsl(231,50%,30%);\"><strong>De gebruiker moet toegang hebben tot de juiste werkgever</strong>. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e6dbbd87f7587de8857bcdd56a25ad357\">\n<span style=\"color: hsl(231,50%,30%);\"><strong>Rechten afhankelijk van de koppeling</strong>. Zie: </span><a href=\"https://www.loket.nl/koppelingsrechten/\"><span style=\"color: hsl(231,50%,30%);\">Een koppeling? Deze rechten heb je nodig · Loket.nl</span></a>\n</li>\n</ul><p><span style=\"color: hsl(231,50%,30%);\">Gebruik van bestaande gebruiker:</span></p><p><span style=\"color: hsl(231,50%,30%);\">Een bestaande gebruiker mag worden gebruikt, mits deze voldoet aan de voorwaarden. Een aparte gebruiker is echter aan te raden voor overzicht en continuïteit (bijvoorbeeld bij uitdiensttreding). </span></p><p><span style=\"color: hsl(334,57%,47%);\"><strong>2. Consent flow (OAuth)</strong></span><span style=\"color: hsl(231,50%,30%);\"> </span><br><span style=\"color: hsl(231,50%,30%);\">De consent flow is een veilige methode om een derde partij toegang te geven tot specifieke gegevens: </span></p><ol>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"ee570e7d1a2716c31de789ffcaafdcd06\"><span style=\"color: hsl(231,50%,30%);\">De derde partij leidt je naar de Loket.nl consentpagina. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e502aceba773ec0fcbf3c47a3702c717b\"><span style=\"color: hsl(231,50%,30%);\">Je logt in met de Loket-gebruiker die voor de koppeling is bedoeld. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e41b3fa9f645ce61e9850f3ebc7b5e6ff\"><span style=\"color: hsl(231,50%,30%);\">Je ziet welke gegevens worden opgevraagd. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"ec791e870b1a41549f20b217013372fca\"><span style=\"color: hsl(231,50%,30%);\">Je geeft toestemming. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e022ecdf6d6c00f7b6a7c8f0da3912ad6\"><span style=\"color: hsl(231,50%,30%);\">Je wordt teruggeleid naar de externe applicatie. </span></li>\n</ol><p><span style=\"color: hsl(334,57%,47%);\"><strong>3. Activities / Endpoints</strong> </span><br><span style=\"color: hsl(231,50%,30%);\">Endpoints zijn gegevensgroepen zoals dienstverbanden, loonruns en arbeidstijd. Elke koppeling heeft toegang tot specifieke endpoints: </span></p><ul style=\"list-style-type: disc;\">\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e3457eb165bf82846e9c2919d4f261e83\"><span style=\"color: hsl(231,50%,30%);\">Rechten van de gebruiker bepalen wat zichtbaar is. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e9211535788dac142a2989b6f42f77029\"><span style=\"color: hsl(231,50%,30%);\">Alleen vrijgegeven endpoints worden gebruikt in de koppeling. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e1b9b331d0d64ee596c857637d573d9b1\"><span style=\"color: hsl(231,50%,30%);\">We raden aan om alleen noodzakelijke rechten te geven. </span></li>\n</ul><p><span style=\"color: hsl(334,57%,47%);\"><strong>4. Developer portal</strong> </span><br><span style=\"color: hsl(231,50%,30%);\">Technische documentatie is beschikbaar via het </span><a href=\"https://developer.loket.nl/\"><span style=\"color: hsl(231,50%,30%);\">Loket.nl Developer Portal</span></a><span style=\"color: hsl(231,50%,30%);\">: </span></p><ul style=\"list-style-type: disc;\">\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e6ffe30f83fda8131f7fddb4f843defb9\"><span style=\"color: hsl(231,50%,30%);\">Uitleg over autorisatie en consent flow. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"ee061cf4546367045a513d68c5553afa9\"><span style=\"color: hsl(231,50%,30%);\">Overzicht van beschikbare endpoints. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"eb1930260db39be4e0c830d84df0de892\"><span style=\"color: hsl(231,50%,30%);\">Veelgestelde vragen en foutmeldingen. </span></li>\n</ul><p><span style=\"color: hsl(334,57%,47%);\"><strong>Handig om te weten</strong> </span></p><ul style=\"list-style-type: disc;\">\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e9170415089ec19a9199e3f032d758dcd\"><span style=\"color: hsl(231,50%,30%);\">Bij sommige koppelingen (zoals ASR via BenefitsPlaza of VCSW/De Goudse) is een gebruiker op providerniveau vereist vanwege extra validatie op W<em>erkgever</em>. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e10d25752b61f11d9af16ef56507f365a\"><span style=\"color: hsl(231,50%,30%);\">Loket heeft geen inzicht in de werkwijze van externe partijen; zorg dus voor correcte inrichting aan jouw kant. </span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: hsl(231,50%,30%);\" data-list-item-id=\"e0517a3739c9eb2522db21614fbd13ce4\"><span style=\"color: hsl(231,50%,30%);\">Gebruikersbeheer en rechten zijn de verantwoordelijkheid van de accountant en/of werkgever. </span></li>\n</ul><p><span style=\"color: hsl(334,57%,47%);\"><strong>Contact: </strong></span><a href=\"mailto:api@loket.nl\" target=\"_blank\" rel=\"noopener noreferrer\"><span style=\"color: hsl(334,57%,47%);\"><strong>api@loket.nl</strong></span></a><span style=\"color: hsl(334,57%,47%);\"> </span><br><span style=\"color: hsl(231,50%,30%);\">Voor vragen over API-koppelingen kun je contact opnemen via </span><a href=\"mailto:api@loket.nl\" target=\"_blank\" rel=\"noopener noreferrer\"><span style=\"color: hsl(231,50%,30%);\"><strong>api@loket.nl</strong></span></a><span style=\"color: hsl(231,50%,30%);\">. </span></p><p> </p><p> </p><p> </p>","user_segment_ids":[]}}