Spring naar inhoud
Help center

Zorgdomein-koppeling (FHIR R4)

Epdee ondersteunt directe verzending van verwijzingen via Zorgdomein — het dominante NL-platform (~85% van huisartsen en specialisten gebruikt het). Onze implementatie volgt de Zorgdomein Integrator FHIR Edition (FHIR R4) specificatie.

## Status van de koppeling

De technische scaffolding is live: - FHIR R4 ReferralRequest-bundle generatie (zie src/lib/fhir/mappers.ts) - Per-tenant ZorgdomeinConnection model voor credentials - Send-endpoint op /api/verwijzingen/[id]/zorgdomein-send - Webhook-receiver op /api/zorgdomein/webhook met HMAC-SHA256 signature - Settings-UI op /dashboard/instellingen/zorgdomein - Mock-mode voor testen vóór u credentials heeft

Wat nog ontbreekt (vereist Zorgdomein-partnerschap): - PKIoverheid Private G1-certificaat voor mTLS - OAuth client-credentials voor TIO sandbox - Production-credentials na succesvolle pilot

## Het traject — 5 fasen, 6-12 maanden

Zorgdomein hanteert een formeel partnership-programma voor EPD-leveranciers (geen self-service developer-signup):

1. Engage & Explore (intake) - Contact via [integrator.zorgdomein.com](https://integrator.zorgdomein.com/) (contactformulier) - Vermeld: "EPD-leverancier, koppelingsverzoek FHIR Edition" - Intake-gesprek met dedicated consultant - Bespreking: ISO/NEN-status, marktsegment, klantoverlap, planning

2. Build (3-4 maanden) - TIO sandbox-credentials worden geleverd - FHIR R4-endpoints implementeren conform Simplifier-profielen - mTLS + OAuth 2.0 + JWT Bearer-tokens configureren - Quick test guide: [integrator.zorgdomein.com/development-tools/quick-test-guide-referral](https://integrator.zorgdomein.com/development-tools/quick-test-guide-referral/)

3. Validate (1-2 maanden) - Samenwerkingsovereenkomst tekenen (hosting, beschikbaarheid, aansprakelijkheid) - Functionele en security-validatie

4. Pilot (2-3 maanden) - Production-endpoints + certificaten configureren - 1-2 pilotklanten gebruiken de koppeling live

5. Live - Volledige release - Marketing-aankondiging

## Vereiste documenten / certificeringen

  • NEN 7510 + ISO 27001 — minimum: gedocumenteerd ISMS met actief certificeringstraject. Volledig certificaat versterkt de positie sterk.
  • PKIoverheid Private G1-servercertificaat — voor mTLS. Aanvragen via Logius-erkende TSP (KPN, QuoVadis, Digidentity). Doorlooptijd 2-4 weken.
  • KVK-inschrijving + samenwerkingsovereenkomst (verwerkersovereenkomst onder AVG)
  • UZI-pas is niet vereist op leveranciersniveau — Zorgdomein gebruikt PKIoverheid Private G1, niet UZI-server

## Technische specificaties

  • FHIR R4 (niet STU3) — gebruik [simplifier.net/zorgdomein](https://simplifier.net/zorgdomein) voor profielen
  • mTLS met PKIoverheid Private G1 (TLS 1.2/1.3, specifieke cipher suites)
  • OAuth 2.0 voor authorization, SMART on FHIR / OpenID Connect voor SSO
  • JWT Bearer-tokens (RS256-signed) in Authorization-header
  • Endpoints: Task, Patient, Coverage, DocumentReference, Binary, Organization, Practitioner

Documentatie: - Portal: [integrator.zorgdomein.com](https://integrator.zorgdomein.com/) - Security spec: [integrator.zorgdomein.com/fhir-specs/security](https://integrator.zorgdomein.com/fhir-specs/security/) - Referral use case: [integrator.zorgdomein.com/use-cases/referral](https://integrator.zorgdomein.com/use-cases/referral/)

## Concrete eerste stappen (deze week)

  1. Bereid een 1-pager voor: bedrijfsprofiel, doelgroep, verwachte klanten jaar 1-2, technische stack, NEN 7510-status
  2. Submit aanvraag via contactformulier op [integrator.zorgdomein.com](https://integrator.zorgdomein.com/) met onderwerp "Partnerschap-aanvraag EPD-leverancier — FHIR Edition koppeling"
  3. Bel parallel 020 471 52 82 (support) voor warme intro naar partnership-team
  4. Start NEN 7510-traject als dat nog niet loopt (adviesbureaus: BMGRIP, CertificeringsAdvies Nederland)
  5. Vraag PKIoverheid G1-certificaat aan via TSP

## Kosten

Niet publiek gepubliceerd. Reken op eenmalige onboarding-fee + jaarlijkse partnership-fee (vermoedelijk meerduizenden euro's per jaar). Exact bedrag op aanvraag in fase 1.

## Snellere alternatieven

Als Zorgdomein te lang of te duur is voor uw situatie, deze opties hebben een lagere drempel:

ZorgMail (Enovation)veruit de breedste route: 250+ informatiesystemen al gekoppeld. Lagere drempel, weken i.p.v. maanden. Contact: zorgmailproductteam@enovationgroup.com, [zorgmail.nl/gekoppelde-informatiesystemen](https://zorgmail.nl/gekoppelde-informatiesystemen/). Aanbevolen als eerste stap.

VIPLive (Calculus) — sterk in eerstelijn/huisartsen. Voor verwijzingen huisarts ↔ specialist. [calculus.nl](https://www.calculus.nl/).

Nuts — open-source, gratis, gebruikt door innovatieve EPD's. Regio-overstijgende uitwisseling. [nuts.nl](https://nuts.nl).

ZIVVER / NTA 7516 SMTP — geen API-integratie nodig, lage drempel, beperkte automatisering (maar wel veilig).

## Aanbeveling van Epdee

Parallel werken: - (a) Zorgdomein-aanvraag starten (lange termijn, hoogste marktdekking) - (b) ZorgMail-integratie nu opzetten (korte termijn klantwaarde)

Sandbox-modus van Epdee laat u nu al de complete UI-flow testen met mock-referenceIds — handig voor klant-demos voor u Zorgdomein live heeft.