--- id: therlink-dienst type: Platform type_label: Platform of dienst title: TherLink-, TherExclusion- en Link-diensten van het eHealth-platform aliases: - Therapeutic Link WS - TherExclusion - Therapeutic Exclusion WS - WS Link - Link WS names: nl: Diensten therapeutische relatie en uitsluiting (TherLink, TherExclusion, Link) fr: Services lien thérapeutique et exclusion (TherLink, TherExclusion, Link) en: Therapeutic link and exclusion services (TherLink, TherExclusion, Link) jurisdiction: - belgie themes: - toestemming-en-relatie - identiteit-en-toegang - architectuur-en-infrastructuur lifecycle: productie lifecycle_note: 'In productie: Therapeutic Link WS in SOAP en REST, Therapeutic Exclusion (REST) en WS Link (REST, enkel voor instellingen). Een volledige technische herschrijving van de TherLink-diensten was gepland voor 2 december 2025 (release R20252.1); een bevestiging van die ingebruikname is niet gevonden. Einddatum voor TherLink SOAP niet gevonden.' version: 'API-catalogus: TherLink SOAP v1.4 en REST v2.3, TherExclusion REST v2.3, Link REST v1.3; cookbooks: Therapeutic Link WS v2.0 (20/08/2025), Therapeutic Exclusion REST v1.2 en Link REST v1.9 (23/03/2026)' summary: 'Het eHealth-platform biedt drie verwante diensten voor de toegangsvoorwaarden ''therapeutische relatie'' en ''uitsluiting'': eHealthTherlink (SOAP en REST) om een therapeutische relatie te registreren, Therapeutic Exclusion om uitsluitingen te registreren, te raadplegen en te annuleren, en WS Link voor zorgrelaties (carelinks), die enkel instellingen mogen gebruiken. Ze draaien als Metahub-diensten op dezelfde infrastructuur als Consent. De TherLink-diensten werden eind 2025 technisch herschreven (gepland 2 december 2025). De regels zelf (bewijsmiddelen, geldigheidsduur, break-the-glass) staan op de pagina over de therapeutische relatie.' last_verified: '2026-09-29' relations: - type: operatedBy direction: uit target: ehealth-platform target_url: https://ehealth-atlas.be/ehealth-platform/ status: established - type: partOf direction: uit target: hubs-metahub target_url: https://ehealth-atlas.be/hubs-metahub/ status: established - type: dependsOn direction: uit target: i-am-connect target_url: https://ehealth-atlas.be/i-am-connect/ status: hypothesis - type: legalBasis direction: uit target: therapeutische-relatie target_url: https://ehealth-atlas.be/therapeutische-relatie/ status: established - type: seeAlso direction: uit target: mijngezondheid target_url: https://ehealth-atlas.be/mijngezondheid/ status: established - type: dependsOn direction: in target: eagreement target_url: https://ehealth-atlas.be/eagreement/ status: established release: 2026.10.05-1 url: https://ehealth-atlas.be/therlink-dienst/ license: CC BY 4.0 --- # TherLink-, TherExclusion- en Link-diensten van het eHealth-platform Het eHealth-platform biedt drie verwante diensten voor de toegangsvoorwaarden 'therapeutische relatie' en 'uitsluiting': eHealthTherlink (SOAP en REST) om een therapeutische relatie te registreren, Therapeutic Exclusion om uitsluitingen te registreren, te raadplegen en te annuleren, en WS Link voor zorgrelaties (carelinks), die enkel instellingen mogen gebruiken. Ze draaien als Metahub-diensten op dezelfde infrastructuur als Consent. De TherLink-diensten werden eind 2025 technisch herschreven (gepland 2 december 2025). De regels zelf (bewijsmiddelen, geldigheidsduur, break-the-glass) staan op de pagina over de therapeutische relatie. ## Wat is het? Deze pagina bundelt drie technische diensten van het [eHealth-platform](https://ehealth-atlas.be/ehealth-platform/) rond de toegangsvoorwaarden therapeutische relatie en uitsluiting; de regels zelf staan op [Therapeutische relatie](https://ehealth-atlas.be/therapeutische-relatie/) (en voor uitsluitingen ook op [Geïnformeerde toestemming voor gegevensdeling](https://ehealth-atlas.be/geinformeerde-toestemming/)). - **eHealthTherlink (Therapeutic Link WS)**, in SOAP en REST, waarmee gemachtigde zorgverleners vanuit hun software een therapeutische relatie met hun patiënt kunnen registreren[^1]. Is de zorgverlener GMD-houder, dan kan hij ook een relatie leggen tussen de patiënt en een andere KB78-zorgverlener[^1]. - **Therapeutic Exclusion (TherExclusion)**, voor registratie, raadpleging en annulatie van therapeutische uitsluitingen[^2]. - **WS Link**, voor zorgrelaties (carelinks), die enkel door instellingen of hun personeel in naam van de instelling gebruikt mag worden[^3]. **Afbakening.** WS Link staat op deze pagina en niet bij de toegangsmatrix, omdat de dienst relaties tussen zorgverlener of instelling en patiënt beheert[^3]; dat is een redactionele keuze. ## Welk probleem lost het op? Raadpleging van een gezondheidsgegeven via de uitwisselingssystemen vereist de voorafgaande verificatie van een therapeutische relatie[^4], en een door de patiënt geregistreerde uitsluiting blokkeert elke toegang, ook bij een bestaande therapeutische relatie[^5]. De metahub slaat zelf geen therapeutische relaties op, maar ontsluit wel relaties uit authentieke bronnen zoals het GMD[^4]. Deze diensten leveren het elektronische bewijs en de uitsluitingen waarop die controles steunen (interpretatie). ## Wie beheert het en waar wordt het toegepast? Status: **productie**, beheerd door het eHealth-platform[^1]. De Metahub-diensten Consent, Therlink en Exclusions beheren de toegang tot medische gegevens en zijn naargelang het geval ook voor patiënten toegankelijk[^5]. Wie de diensten aanroept: - **Softwareproducenten van zorgverleners**: het is de bedoeling dat zij eHealthTherlink in hun toepassing implementeren[^1]. [CareConnect GP](https://ehealth-atlas.be/careconnect-gp/)[^6], [CGM Daktari](https://ehealth-atlas.be/cgm-daktari/)[^7] en [HealthOne Nova](https://ehealth-atlas.be/healthone-nova/)[^8] hebben een certificering 'Minilab Therlink' met als organisator 'TherLink SOAP'. - **Instellingen**: WS Link is voorbehouden aan instellingen of hun personeel in naam van de instelling[^3]. - **Hubs**: een hub biedt zijn klanten intrahub de mogelijkheid een therapeutische relatie te melden, te controleren of te herroepen[^4]. - **Patiënten**: de webtoepassing van het eHealth-platform voor toestemming, therapeutische relaties en uitsluitingen is bereikbaar via [MijnGezondheid](https://ehealth-atlas.be/mijngezondheid/)[^5]. - **Afnemende diensten**: de [MyCareNet](https://ehealth-atlas.be/mycarenet/)-dienst CHIV Consultation Pharmacists (release R20261, 28 april 2026) vereist een therlink-controle[^9]; in een integratievoorbeeld van Smals verifieert [UHMEP](https://ehealth-atlas.be/uhmep/) de therapeutische relatie via de eHealth Attribute Authority[^10]. ## Gegevens en koppelvlakken | Dienst | Interface | Functie | Onderbouwing | |---|---|---|---| | Therapeutic Link WS (eHealthTherlink) | SOAP en REST | Therapeutische relatie registreren vanuit software |[^1][^11] | | Therapeutic Exclusion | REST (cookbook v1.2, 23/03/2026) | Uitsluitingen registreren, raadplegen en annuleren |[^2] | | WS Link | REST | Zorgrelaties (carelinks); enkel instellingen |[^3] | De diensten voor toestemming, therapeutische relaties/zorgrelaties en uitsluitingen zijn ook als REST-diensten beschikbaar voor integratie in mobiele of webapplicaties van derden[^5][^12]. Metahub en de diensten Consent, Therlink en Exclusions draaien op een high-availability-infrastructuur met twee zones[^13]. ## Versie, status en roadmap - **Refactoring 2025**: in het kader van release R20252.1 werden de Therapeutic Link-diensten, zowel SOAP als REST, technisch volledig herschreven[^11]; de herschrijving omvatte ook het beheer via Metahub en I.AM AA[^11]. - **Planning**: volgens een bericht van 8 oktober 2025 volgde na een acceptatietest van 5 tot 25 november 2025 de inproductiestelling op 2 december 2025[^11]; een bevestiging achteraf is niet gevonden (gap). - **SOAP**: een einddatum voor TherLink SOAP is niet gevonden (gap). ## Relaties met andere concepten Automatisch gegenereerd uit de frontmatter. De regel staat op [Therapeutische relatie](https://ehealth-atlas.be/therapeutische-relatie/); de zusterdiensten op [Consent-dienst van het eHealth-platform (eHealthConsent)](https://ehealth-atlas.be/consent-dienst/) en [Toegangsmatrixdienst van het eHealth-platform (WS Matrix, PADAC)](https://ehealth-atlas.be/toegangsmatrix-dienst/). ## Praktische betekenis voor ziekenhuizen - **Reglementair**: voor ziekenhuizen is de inschrijving van de patiënt het bewijs van een therapeutische relatie met de behandelende zorgverleners[^14]; de dienstpagina van eHealthTherlink richt zich op gemachtigde zorgverleners en hun softwareproducenten[^1]. Of ziekenhuis-EPD's eHealthTherlink rechtstreeks aanroepen, zegt geen gevonden bron (gap). - **Technisch**: WS Link is uitdrukkelijk voor instellingen bedoeld[^3]. - **Aanbeveling**: laat de EPD-leverancier bevestigen welke van deze diensten (TherLink, TherExclusion, Link) het EPD of de hub aanroept, en of de refactoring van december 2025 aanpassingen vroeg. ## Implementatievoorwaarden en beperkingen Een hub kan toelaten dat een zorgverlener op vraag van de patiënt een uitsluiting registreert, mits een bewezen voorafgaande therapeutische relatie[^4]. Bij break-the-glass in een therapeutische noodsituatie wordt geen rekening gehouden met geregistreerde uitsluitingen[^4]. Geldigheidsduren en bewijsmiddelen staan op [Therapeutische relatie](https://ehealth-atlas.be/therapeutische-relatie/). ## Onzekerheden en tegenstrijdige informatie - **Releasenummer van de refactoring.** De Nederlandse versie van het eHealth-bericht noemt R20252.1 en bij de productiedatum R2023.1.2, terwijl de Franse versie twee keer R20252.1 noemt[^11]; waarschijnlijk een tikfout (interpretatie). - **Ingebruikname.** Het bericht beschrijft een plan[^11]; of de herschreven dienst op 2 december 2025 effectief in productie ging, is niet gevonden. - **REST-documentatie TherLink.** Voor TherLink REST is in de verzamelde bronnen geen apart REST-cookbook gevonden, enkel een swagger-bestand (gap). ## Relaties - wordt uitgebaat door: [eHealth-platform](https://ehealth-atlas.be/ehealth-platform/) (vastgesteld)[^1][^11] - maakt deel uit van: [Hubs-metahubsysteem](https://ehealth-atlas.be/hubs-metahub/) (vastgesteld)[^5][^13]. De bronnen noemen Therlink en Exclusions Metahub-diensten; de metahub slaat zelf geen therapeutische relaties op. - hangt technisch af van: [I.AM en I.AM Connect (Identity & Access Management)](https://ehealth-atlas.be/i-am-connect/) (hypothese)[^11]. De refactoring van eind 2025 omvatte ook het beheer via I.AM AA; een expliciete afhankelijkheid van de API's van I.AM Connect is niet gedocumenteerd. - heeft als rechtsgrond: [Therapeutische relatie](https://ehealth-atlas.be/therapeutische-relatie/) (vastgesteld)[^15][^4][^1]. Het reglement over de elektronische bewijsmiddelen van een therapeutische relatie en een zorgrelatie regelt wat de diensten registreren. - zie ook: [Mijngezondheid (Masanté)](https://ehealth-atlas.be/mijngezondheid/) (vastgesteld)[^5]. Patiënten beheren hun therapeutische relaties en uitsluitingen via de webtoepassing van het eHealth-platform, bereikbaar via MijnGezondheid. - hangt technisch af van (inkomend): [eAgreement en Hoofdstuk IV](https://ehealth-atlas.be/eagreement/) (vastgesteld)[^9] ## Open vragen - Is de herschreven TherLink-dienst effectief op 2 december 2025 in productie gegaan, en veranderde er iets aan het koppelvlak voor aanroepende software? - Bestaat er een REST-cookbook voor TherLink REST v2.3, of enkel een swagger-bestand? - Hoe verhoudt WS Link (therlinks en carelinks, enkel instellingen) zich tot Therapeutic Link WS, en welke instellingen gebruiken WS Link? - Krijgt TherLink SOAP een einddatum? ## Bronnen [^1]: [eHealth Therapeutic Links](https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealth-therapeutic-links). eHealth-platform. Opgehaald 2026-09-25, sha256 c8207e3e30180eab… (SRC-69287b0ddc) [^2]: [Beheer van de therapeutische uitsluitingen van zorgverleners | eHealth-platform](https://www.ehealth.fgov.be/ehealthplatform/nl/service-beheer-van-de-therapeutische-uitsluitingen-van-zorgverleners). eHealth-platform. Opgehaald 2026-09-28, sha256 3d7a378c4edc9940… (SRC-b4eee2aca2) [^3]: [eHealth Care Links | eHealth-platform](https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealth-care-links). eHealth-platform. Opgehaald 2026-09-28, sha256 3aa5de7b3210e753… (SRC-b482662b72) [^4]: [Reglement betreffende de uitwisseling van gezondheidsgegevens tussen gezondheidssystemen verbonden via het verwijzingsrepertorium van het eHealth-platform](https://www.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/224752516d4aeb87b0800b448cd4b0645f74c2a9/reglement-hub-metahub.pdf). eHealth-platform / Informatieveiligheidscomité. Opgehaald 2026-09-25, sha256 f5e242162df00247… (SRC-f4d7f1af3a) [^5]: [Verwijzingsrepertorium (Metahub)](https://www.ehealth.fgov.be/ehealthplatform/nl/service-verwijzingsrepertorium-metahub). eHealth-platform. Opgehaald 2026-09-25, sha256 9bca4ecae94c3991… (SRC-008bee8c2b) [^6]: [Software Register API – certificeringen CareConnect General Practitioner (JSON)](https://api.ehealth.fgov.be/softwareRegister/v1/softwares/ILJ62R2VEFZP/versions/v._/certifications?pageSize=100). eHealth-platform. Opgehaald 2026-09-26, sha256 b4183bc818432377… (SRC-5d419bb730) [^7]: [Software Register API – certificeringen CGM Daktari (JSON)](https://api.ehealth.fgov.be/softwareRegister/v1/softwares/IL26G8CX96ND/versions/v._/certifications?pageSize=100). eHealth-platform. Opgehaald 2026-09-26, sha256 f991edf4d62dd275… (SRC-32a75b4ab2) [^8]: [Software Register API – certificeringen HealthOne Nova (JSON)](https://api.ehealth.fgov.be/softwareRegister/v1/softwares/IL7WR4B98FF1/versions/v._/certifications?pageSize=100). eHealth-platform. Opgehaald 2026-09-26, sha256 e93edb0403ecdaab… (SRC-0ce3aea79f) [^9]: [Release Notes eHealth platform Major Release R20261](https://www.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/5bf87d00492ab6e920faabf7c8977de95296951d/release-notes-r2026-v-1-0.pdf). eHealth-platform. Opgehaald 2026-09-28, sha256 7ddca509975c840f… (SRC-cc6c17d7ad) [^10]: [GitHub - smals-belgium/shared-pseudo-helper-java: Library that helps eHealth Pseudonymisation integration in Java applications · GitHub](https://github.com/smals-belgium/shared-pseudo-helper-java). Smals. Opgehaald 2026-09-26, sha256 00186947ff0cb7bb… (SRC-62e7d58b4b) [^11]: [Bericht aan de gebruikers van de diensten Metahub en eHealth Therapeutic Links](https://www.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/dbbaeb2626d0108a68c23f0b95e72bab92fd7cac/metahub-comm-09102025.pdf). eHealth-platform (service management), 2025-10-08. Opgehaald 2026-09-25, sha256 ab26d48e5e63318f… (SRC-7fad05ed3d) [^12]: [Welcome Pack (eHealth-platform)](https://www.ehealth.fgov.be/ehealthplatform/nl/ehealth-welcome-pack.pdf). eHealth-platform. Opgehaald 2026-09-25, sha256 9870190cbce8511b… (SRC-6fdf93f016) [^13]: [Verwijzingsrepertorium (Hubs & Metahub) - noodprocedure](https://www.status.ehealth.fgov.be/nl/procedure/apothekers/verwijzingsrepertorium-hubs-metahub). eHealth-platform (status website). Opgehaald 2026-09-25, sha256 58f77ad61c98508c… (SRC-86589dea76) [^14]: [Nota betreffende de elektronische bewijsmiddelen van een therapeutische relatie en een zorgrelatie](https://www.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/6d9b55a02646d370596e2c4163faac1d87b130be/therapeutische-relatie-en-zorgrelatie-nota.pdf). eHealth-platform. Opgehaald 2026-09-25, sha256 b154232409892dcc… (SRC-da135e3d72) [^15]: [Belangrijkste reglementen](https://www.ehealth.fgov.be/ehealthplatform/nl/reglementen). eHealth-platform. Opgehaald 2026-09-25, sha256 1fbfdf486d00d91f… (SRC-c22eb99f7f)