Ik koppel Nedap Ons aan je HR-systeem, zorgapp, planning of dashboard via de Ons API van Nedap Healthcare. Medewerkers, gebruikers en rapportages gaan erin, cliënten, roosters, uren en facturen komen eruit. Nedap beslist zelf over toegang. Een softwareleverancier doorloopt een intake en tekent een aansluitovereenkomst; een zorgorganisatie die zelf ontwikkelt, geeft alleen haar eigen medewerkers toegang tot het Ons API Dashboard. Connector en clientcertificaat staan op naam van een van die twee, nooit op naam van FLOH. Dat traject bereid ik met je voor.
Zo loopt de data
voorbeeldopzet
Sync-log, zoals je hem in het logboek terugziet (voorbeeld)
Werkgebied: Nederland · Bijgewerkt op door Alisina Nawabi
Zo richt ik het meestal in. De tabel is ook het startpunt van de intake: jij bepaalt per object de richting en de bron.
| Object | Richting | Bron van waarheid | Frequentie |
|---|---|---|---|
| Medewerkers en dienstverbandenMedewerkers en dienstverbanden zijn aan te maken en te wijzigen, niet te verwijderen. | naar Nedap Ons | HR-systeem | Bij elke indiensttreding of wijziging |
| Gebruikers en rollenRollen zelf maakt de zorgorganisatie in Ons Autorisatie; de koppeling kent alleen rollen toe die de zorgorganisatie vrijgeeft en overschrijft daarbij alleen de rollen die ze eerder zelf toekende. Toegekende rollen opvragen kan niet, dus de koppeling houdt zelf bij wie welke rol kreeg. | naar Nedap Ons | HR- of IAM-systeem | Bij elke wijziging |
| CliëntenDe melding bevat alleen het type en het id; de koppeling haalt de cliënt daarna op. | van Nedap Ons | Nedap Ons | Bij elke wijziging (webhook) |
| Rapportages | naar Nedap Ons | Dossier in Nedap Ons | Direct na het schrijven |
| Roosters en dienstenDe meldingen over roosters staan op de documentatiesite van de Ons API, niet in de lijst op het supportportaal. | van Nedap Ons | Ons Planning | Bij elke wijziging (webhook) |
| Uren (aanwezigheidsregistraties)Alleen te lezen: per medewerker, per cliënt of als export. | van Nedap Ons | Nedap Ons | Dagelijks of per periode |
| FacturenAlleen te lezen, als stroom van facturen en factuurregels. | van Nedap Ons | Nedap Ons | Dagelijks |
Voor bedrijven die zelf met de software werken, en voor wie er een product op bouwt voor eigen klanten.
Zorgorganisatie met een HR- of salarissysteem waarvoor nog geen koppeling met Nedap Ons bestaat
Een nieuwe collega kan op dag één in Nedap Ons werken, zonder dat iemand de gegevens overtypt of rechten met de hand toekent.
Wat de API hiervoor biedt: Medewerkers, dienstverbanden en gebruikers zijn via de Ons API aan te maken en te wijzigen, en teamlidmaatschap loopt via de medewerker. Rollen kent de koppeling toe met één aanroep per gebruiker; maken kan niet, dat doet de zorgorganisatie in Ons Autorisatie, die ook bepaalt welke rollen een koppeling mag toekennen. Welke rollen iemand al heeft, is niet op te vragen, dus de koppeling houdt dat zelf bij. Voor veel HR-systemen bestaat al een koppeling: Loket noemt er een die nieuwe en gewijzigde medewerkers in Nedap Ons zet, en Ons Podium toont een koppeling die medewerkers, gebruikers en rollen vanuit AFAS Profit in Nedap Ons zet en een IAM-koppeling die accounts en rechten vanuit het HR-systeem beheert. Qoden (Omniport) noemt ook een koppeling vanuit Nmbrs, en Nedap biedt zelf een XML-import waarmee een HR-leverancier zonder API-koppeling medewerkers aanlevert. AFAS en Nedap laten een pilotgroep vanaf 1 november 2026 een eigen standaardkoppeling testen en vanaf 1 januari 2027 invoeren; de eerste versie stuurt medewerkers, contracten, verzuim en verlofrechten van AFAS naar Nedap Ons, en roltoewijzing volgt later. Logt een medewerker die al in Nedap Ons staat voor het eerst in via SSO, dan maakt Nedap Ons zelf een gebruiker aan, en Ons Autorisatie kent standaardrollen en rollen op basis van een cliëntrelatie automatisch toe, als de zorgorganisatie die instelt; anders heeft een nieuwe gebruiker geen rechten. Dit scenario is voor een HR-systeem waarvoor zo’n koppeling er niet is, en voor rollen per functie.
Lees de uitwerking in de gidsZorgorganisatie die productiviteit en declarabele zorg naast andere bronnen wil zien
Teamleiders en controllers zien geleverde en toegewezen zorg op één plek, naast cijfers die niet in Nedap Ons staan.
Wat de API hiervoor biedt: Aanwezigheidsregistraties zijn via de API alleen te lezen, per medewerker, per cliënt of als export; zorgtoewijzingen en declaratieregels zijn te lezen en te schrijven, facturen alleen te lezen. Nedap levert daarnaast OnsDB, dat zulke tabellen naar een eigen database kopieert, bijvoorbeeld elke dag, voor rapportages en dashboards binnen de eigen organisatie; losse OnsDB-tabellen kunnen ook aan een koppeling worden toegevoegd, volgens Nedap alleen als een API-model de gegevens niet heeft, en zonder filter op velden. Voor stuurinformatie heeft Nedap Ons zelf dashboards, cliënt- en medewerkerrapporten en de Cockpit, die geleverde zorg naast het zorgarrangement en het budget legt. Nedap noemt daarnaast voorbeelden van BI-leveranciers die zorgorganisaties al met Nedap Ons gebruiken, en zegt zelf dat Nedap Ons geen generieke realtime BI-oplossing is waarin elke combinatie van gegevens direct in een dashboard staat. Dit scenario gaat over het combineren met data van buiten Nedap Ons.
Lees de uitwerking in de gidsZorgorganisatie met eigen software voor flexpool, vervoer of bereikbaarheid
Je eigen software volgt het rooster zonder export en zonder dat iemand een wijziging doorbelt.
Wat de API hiervoor biedt: De documentatie van de Ons API noemt meldingen als een rooster of planning van een medewerker in Ons Planning verandert, en bij wijzigingen in roosterdiensten. Die meldingen zijn ondertekend en bevatten geen roostergegevens, alleen ids en een paar velden zoals de datum of periode, dus de koppeling haalt het rooster daarna op. Zonder webhooks blijft ook elke vijf minuten pollen volgens Nedap net achter. Voor flexinzet heeft Nedap Ons zelf de module Flexroosteren, tegen meerprijs, waarmee een team diensten aan flexteams aanbiedt, en medewerkers zien hun rooster al in het medewerkerportaal en de app Vandaag. Voor bereikbaarheid en flexinzet staan er ook koppelingen in Ons Podium, zoals TeamTelefoon en Elanza; dit scenario is voor eigen software zonder zo’n koppeling.
Lees de uitwerking in de gidsSoftwarebedrijf met een product voor zorgorganisaties
Je product praat met Nedap Ons, en elke volgende zorgorganisatie sluit aan met haar eigen toestemming op dezelfde connector.
Wat de API hiervoor biedt: Een externe partij wordt leverancier via de intake, waarin Nedap de partij en haar certificeringen beoordeelt en eist dat er een zorgorganisatie bij betrokken is; daarna tekenen leverancier en Nedap een aansluitovereenkomst. Elke versie van een connector gaat door ontwikkeling, staging en productie, en een zorgorganisatie geeft toestemming per versie. Nedap ziet zowel maatwerk voor één of enkele zorgorganisaties als koppelingen voor veel zorgorganisaties, en een connector kan later naar meer klanten.
Softwarebedrijf met een app voor wijkverpleging, begeleiding of dagbesteding
Zorgmedewerkers werken in jouw app en het dossier blijft compleet, zonder dubbele rapportage.
Wat de API hiervoor biedt: Rapportages zijn via de API aan te maken, te lezen, te wijzigen en te verwijderen; cliënten en zorgplannen zijn te lezen en te schrijven, cliënten niet te verwijderen. Er zijn meldingen bij het aanmaken, wijzigen en verwijderen van cliënten, zorgplannen en rapportages. Een connector krijgt alleen de modellen, handelingen en velden die in zijn versie staan.
Lees de uitwerking in de gidsSoftwarebedrijf met een identity- of HR-product voor de zorg
Wie in dienst komt of vertrekt, heeft op tijd de juiste rechten in Nedap Ons, zonder losse tickets.
Wat de API hiervoor biedt: Gebruikers zijn via de API aan te maken, te wijzigen en te verwijderen. Rollen kent een koppeling toe met één aanroep die de volledige set van haar eigen toewijzingen voor een gebruiker zet; rollen maken of inrichten kan niet via de API, en toegekende rollen opvragen ook niet, dus je product houdt zelf bij wie welke rol kreeg. Rechten die alleen een koppeling krijgt, vragen menselijke goedkeuring: volgens Nedap ongeveer twee weken, en daarna ongeveer een maand tot ze in productie staan. Nieuwe SSO-koppelingen waarmee je vanuit Nedap Ons in een andere applicatie inlogt, ontwikkelt Nedap niet meer; inloggen in Nedap Ons via de eigen SSO-provider van de zorgorganisatie kan wel, met OpenID Connect, en dan maakt Nedap Ons bij de eerste login zelf een gebruiker aan voor een medewerker die er al staat, met de standaardrollen die de zorgorganisatie in Ons Autorisatie instelt.
Per object wat er via de API kan. Dit bepaalt wat een koppeling wel en niet kan doen.
| Object | Lezen | Aanmaken | Wijzigen | Verwijderen | Webhook |
|---|---|---|---|---|---|
Cliënten/v0/administration/clientsWijzigingen ook op te vragen via een stroom met alles wat sinds een datum veranderde. | ja | ja | ja | nee | ja |
Medewerkers/v0/administration/employeesTeamlidmaatschap schrijf je via de medewerker. | ja | ja | ja | nee | ja |
Dienstverbanden/v0/administration/contracts | ja | ja | ja | nee | ja |
Gebruikers/v0/administration/usersRollen toekennen gaat via een aparte aanroep; rollen maken of toegekende rollen opvragen kan niet via de API. | ja | ja | ja | ja | ja |
Teams/v0/administration/teams | ja | nee | nee | nee | ja |
Locaties/v0/administration/locations | ja | ja | ja | nee | ja |
Zorgplannen/v0/administration/dossier/care_plans | ja | ja | ja | ja | ja |
Rapportages/v0/administration/dossier/reports | ja | ja | ja | ja | ja |
Zorgtoewijzingen/v0/administration/careallocations | ja | ja | ja | nee | ja |
Roosters en diensten/v0/plannen_roosterenBasisroosters volledig; roosterdiensten lezen en toewijzen; diensten alleen lezen. Afwezigheid van medewerkers is een experimenteel endpoint. Meldingen staan alleen op de documentatiesite van de Ons API. | ja | deels | deels | deels | deels |
Agenda/v0/agendaReeksen aanmaken, losse afspraken wijzigen of verwijderen. Nedap breidt de lijst met meldingen nog uit. | ja | ja | ja | ja | nee |
Uren (aanwezigheidsregistraties)/v0/administration/presence/presence_logsPer medewerker, per cliënt of als export. | ja | nee | nee | nee | nee |
Declaratieregels/v0/administration/finance/declaration_rules | ja | ja | ja | ja | nee |
Facturen/v0/xstream/invoicesEen stroom met facturen en hun regels. | ja | nee | nee | nee | nee |
Medicatie/v0/medicatie_legacyMedicatieplannen en toedieningen alleen lezen; schrijven kan alleen een dubbele controle. Ons Medicatie is een losse module van de zorgorganisatie. | ja | deels | nee | nee | deels |
ja kan via de APIdeels kan met beperkingennee kan niet
De feiten waar een koppeling op rust, met de bron erbij. En wat er de komende tijd verandert.
Wat de leverancier heeft aangekondigd, en wat het voor een bestaande koppeling betekent.
al ingegaan
Oude aanroepen voor rollen verouderd
Rollen toekennen gaat via de aanroep voor duties. Een HR- of IAM-koppeling die de oude aanroepen gebruikt, zet ik om.
al ingegaan
Nieuwe endpoints vervangen alle oude
Elk endpoint kreeg een nieuw pad onder /v0/, en 41 endpoints kregen ook andere parameters. De migratiegids en de specificatie noemen 19 november 2025, de pagina met de oude API’s 18 november 2025.
al ingegaan
Oude relatie-endpoints tussen cliënt en medewerker verouderd
Deze relatie-aanroepen gaan naar de vervangers onder /administration. Nedap verwijdert een verouderde resource op zijn vroegst zes maanden later.
al ingegaan
Verwijdering van de oude /t/-endpoints aangekondigd
Volgens de migratiegids werkten oude en nieuwe endpoints naast elkaar tot 19 mei 2026, waarna de oude zouden verdwijnen. Een koppeling die nog /t/-paden aanroept, moet over op /v0/.
komt eraan
Oude id in eigen webhookmeldingen vervalt
Bij de eigen meldingen van Nedap, zoals over roosters, staan de gegevens nu onder payload. Het oude id bovenin blijft alleen voor achterwaartse compatibiliteit en verdwijnt na 1 maart 2027.
Niet elke koppeling hoeft maatwerk te zijn. Zo kies je de route die past.
Past als: Nedap noemt meer dan 300 koppelingen, en Ons Podium toont de koppelingen die Nedap valideerde, voor HR onder meer een koppeling die medewerkers en rollen vanuit AFAS Profit in Nedap Ons zet en een IAM-koppeling voor accounts en rechten. Voor HR noemt Loket ook een koppeling met Nedap Ons, Qoden (Omniport) onder meer een vanuit Nmbrs, en AFAS en Nedap testen een eigen standaardkoppeling. Nedap zegt zelf: vraag je leverancier om een koppeling, en heeft die geen API-koppeling, dan kan hij ook via de XML-import van Nedap aanleveren.
Grens: Je volgt de inrichting van de standaardkoppeling. De eerste versie van de standaardkoppeling van AFAS en Nedap stuurt nog niets van Nedap Ons terug, en eigen velden of een eigen dashboard vallen vaak buiten zo’n koppeling. De XML-import gaat alleen naar Nedap Ons: een bestand dat niet aan het schema voldoet, keurt Nedap Ons helemaal af, en de leverancier krijgt geen bericht of een import lukte; dat staat alleen in het log van Nedap Ons.
Past als: Voor een losse melding of een export, als je toch al een connector met certificaat bij Nedap hebt.
Grens: De Ons API vraagt een clientcertificaat van Nedap, een vastgezette connectorversie en toestemming van de zorgorganisatie. Een flow die zelf meldingen herkent, certificaten vernieuwt en gemiste webhooks opnieuw opvraagt, is voor zorgdata kwetsbaar.
Past als: Als je systeem geen standaardkoppeling heeft, als je product veel zorgorganisaties moet bedienen, of als je meldingen, rollen en dossiergegevens precies goed wilt laten landen.
Grens: Een softwareleverancier gaat door de intake van Nedap, en elke versie van zijn connector gaat langs een beoordeling door Nedap en vraagt toestemming van de zorgorganisatie. Er moet minstens één zorgorganisatie meedoen, de API is niet bedoeld voor uitwisseling tussen zorgorganisaties, en Nedap helpt zelf niet bij de use case.
Bestaat er al een app in de marktplaats die precies doet wat je met Nedap Ons wilt?
Vier stappen, met een vaste prijs vooraf. Een basisopzet begint vanaf €4.000.
Dag 1
Een kort gesprek over je systemen en je proces. Ik vul samen met jou de sync-tabel in en kijk welke zorgorganisatie meedoet, welke modellen en velden de koppeling echt nodig heeft en wie bij Nedap de leverancier is.
Binnen een paar dagen
Je krijgt een voorstel met scope, vaste prijs en planning. Ben je een softwareleverancier en nog niet bekend bij Nedap, dan vul je het intakeformulier in; ontwikkelt je zorgorganisatie zelf, dan geef je je eigen medewerkers toegang tot het Ons API Dashboard. Ik bereid dat met je voor, net als de specificatie van de connector. Bij die tweede route vraag ik eerst bij Nedap na of ze ook buiten OnsDB 5 zonder intake loopt en of ik als externe ontwikkelaar zonder dashboardtoegang als koppelpartner geld, want dat zeggen de pagina’s van Nedap niet.
Week 1-2
Voor een softwareleverancier bouw ik eerst op de ontwikkelomgeving van Nedap met fictieve data. Op de testomgeving van een zorgorganisatie werkt volgens Nedap alleen een vastgezette versie, na haar toestemming. Ontwikkelt je zorgorganisatie zelf, dan is er geen ontwikkelomgeving van Nedap: pas als de versie is vastgezet en zij toestemming gaf, begin ik op haar eigen testomgeving, waarop volgens Nedap meestal gegevens uit productie staan; die behandel ik als productiegegevens. Een vastgezette versie is niet te wijzigen, dus een extra model of veld wordt een nieuwe versie. Ik test ook de randgevallen: gemiste meldingen, dubbele records, een verlopen certificaat. Het bouwen zelf is meestal binnen 2 weken klaar; de beoordeling door Nedap en de toestemming per omgeving komen daar los bij.
Daarna
Voordat een vastgezette versie verder gaat, beoordeelt Nedap haar, met onder meer de webhooks en rechten die ze gebruikt, en de zorgorganisatie geeft per omgeving toestemming in Ons Podium; die beoordeling plan ik in. Daarna gaat de koppeling live met monitoring, documentatie en een overdracht. Onderhoud kan, maar hoeft niet bij mij.
Hoe ik met je toegang omga, en waarom de koppeling op jouw account draait.
Ik vraag nooit om je wachtwoord voor Nedap Ons.
De koppeling draait op jouw account, niet op dat van mij. Ik bouw, documenteer en onderhoud hem; jij houdt het eigendom en de toegang.
Een koppeling is pas af als je merkt dat er iets misgaat voordat je klant het merkt.
Vergelijkbare koppelingen die ik bouwde, elk met een interactieve demo om zelf te proberen.
DatasynchronisatieKlant-, voorraad- en orderdata verspreid over webshop, spreadsheets en losse tools, samengebracht tot één bron van waarheid. Pipelines die de data verse en synchroon houden, in plaats van maandagochtend exporteren en samenvoegen.
Bekijk case
API's & MCPJe eigen data en dienst veilig ontsluiten voor partners én AI-assistenten. Een nette API-laag met versioning, auth en rate-limits, plus een MCP-server zodat Claude en ChatGPT je product echt kunnen gebruiken in plaats van er alleen over te praten.
Bekijk caseMijn gidsen en artikelen die dieper ingaan op Nedap Ons.
Gids1 jul 23:50
Hoe je in de thuiszorg cliëntroosters afstemt op beschikbaarheid en reistijd, werkbriefjes digitaal vastlegt bij de cliënt en overdrachten structureert, met de AVG voor gezondheidsgegevens op orde. Met de tools, de stappen en de valkuilen.
Gids23 okt 09:00
Bouw een controleerbare AI-werkstroom die consultregistratie koppelt aan prestatie, bevoegdheid en regelversie, uitzonderingen naar een mens stuurt en pas na read-back een declaratie vrijgeeft.
Gids21 jun 17:00
Hoe je in een kleine zorgpraktijk spraak omzet in een gecontroleerd SOEP-verslag, AVG-veilig en met de juiste koppelingen. Met de tools, de stappen en de valkuilen op een rij.
Gids1 nov 09:00
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.
Gids30 jun 17:00
Inventariseer welke klantdata op Amerikaanse clouds staat, kies per systeem een EU-residency-optie en werk je verwerkersovereenkomsten bij, zonder in paniek je hele stack te verhuizen.
Gids3 aug 09:00
Een koppeling die stilvalt geeft geen foutmelding maar een leegte, en die kost per dag orders, facturen en voorraad. Zo richt je hartslag, herhaalpogingen, een dode brievenbus en een nachtelijke telling in.
Werk je met meer tools? Combineer Nedap Ons met je andere systemen en zie hoe er één workflow van ontstaat.
Antwoorden op wat het vaakst gevraagd wordt over Nedap Ons koppelen.
Vertel me welke systemen je gebruikt en wat er nu misgaat. Ik denk mee en zeg eerlijk wat er kan, vrijblijvend.
Liever eerst zelf kijken waar de winst zit? Doe de gratis automatiseringsscan