triqura-ecd/docs/datamodel/deelmodellen/model-aanmelding.md

Datamodelvoorstel — Aanmelding & instroombasis

Status: gesynchroniseerd 19 juli 2026 — AANMELDING/VERWIJZING/VERWIJSDOCUMENT/TOEWIJZING/ZORGEPISODE (§2.10–§2.13, §2.15) zijn vervangen door model-instroom.md; PERSOON/CLIENT/CLIENTRELATIE/VERWIJZER/PRAKTIJK_INSTELLING/CLIENT_HUISARTS/VERZEKERING/TOESTEMMING/CLIENTPORTAAL_ACCOUNT (§2.1–§2.9, §2.14, §2.16) blijven ongewijzigd geldig en worden door model-instroom.md hergebruikt, niet gedupliceerd
Datum: 18 juli 2026, gesynchroniseerd 19 juli 2026 Deelgebied (na sync): PERSOON, CLIENT, CLIENTRELATIE, VERWIJZER, PRAKTIJK_INSTELLING, CLIENT_HUISARTS, VERZEKERING, TOESTEMMING, CLIENTPORTAAL_ACCOUNT Bronnen: datamodel-discovery.md, onderzoek-proces, onderzoek-leveranciers, onderzoek-standaarden, onderzoek-rapportage (details in §8)

Let op: dit document behandelde oorspronkelijk ook de instroomflow (AANMELDING, VERWIJZING, ZORGEPISODE). Die deelgebieden zijn na de FCO-IM-feitenronde van 19 juli 2026 volledig herzien en staan nu in model-instroom.md (feitzinnen: ../feitenmodellen/feitenmodel-instroom.md; besluiten: B21–B30 in ../besluiten/besluitenlog-datamodel-2026-07-18.md). De secties hieronder die nog AANMELDING/VERWIJZING/ZORGEPISODE beschrijven zijn behouden als historisch werkdocument, niet als actuele bron — gebruik ze niet als basis voor SQL.

Conventies (gelden voor alle entiteiten, niet per entiteit herhaald):

• Elke entiteit heeft id (UUID, stabiel — spelregel 3.1 #5), created_at, updated_at, deleted_at (soft delete — spelregel 3.1 #4) en auditvelden conform spelregel 3.1 #3.
• Elke waardelijst is een referentietabel (spelregel 3.1 #1) met per rij: code, omschrijving, optioneel externe_code + codesysteem (FHIR/NZa-koppelbaarheid), geldig_van, geldig_tot, actief. De geldigheidsperiode per waarde is een les uit de NZa-codelijsten bij Nedap (onderzoek-leveranciers §2.2, §7.1).
• "Wie mag zetten" is overal rollenronde (discovery §5.1 besluit 6), tenzij anders vermeld.

---

1. Feitzinnen (nieuw en gewijzigd t.o.v. discovery §5.1)

Persoon, contactgegevens en adres

1. (gewijzigd t.o.v. §5.1 feitzin 1) Persoon Jan de Vries heeft naamdelen: achternaam "Vries", voorvoegsel "de", voornamen "Jan Willem", initialen "J.W.", roepnaam "Jan". (gestructureerde naam i.p.v. één naamveld — zib Patient)
2. Persoon Jan de Vries heeft geslacht "man" (uit waardelijst).
3. Persoon Jan de Vries heeft genderidentiteit "man" (optioneel, uit waardelijst — GGZ-relevant, zib Patient v4.3).
4. Persoon Jan de Vries heeft BSN 123456782. (optioneel op PERSOON — discovery §5.1 besluit 1; versleuteld — spelregel 3.1 #6)
5. Persoon Jan de Vries is overleden op 3 maart 2071. (optioneel expliciet feit — zib Patient)
6. Persoon Jan de Vries heeft een adres van type "woonadres": Dorpsstraat 1, 1234 AB Ons Dorp, geldig sinds 1 januari 2020.
7. Persoon Jan de Vries heeft contactgegeven van type "telefoon", soort "mobiel privé", waarde "06-12345678", met voorkeursmarkering.
8. Persoon Jan de Vries heeft contactgegeven van type "e-mail", waarde "jan@example.nl".

Contactpersonen en wettelijk vertegenwoordiger (relatie via PERSOON)

9. Persoon Maria de Vries staat tot cliënt Jan de Vries in relatie "partner" en vervult daarbij de rol "eerste contactpersoon", sinds 14 juli 2026.
10. Persoon K. Bos vervult voor cliënt Jan de Vries de rol "wettelijk vertegenwoordiger" met vertegenwoordigingsgrond "mentor", sinds 1 februari 2026.
11. De relatie van Maria de Vries tot cliënt Jan de Vries is op 1 mei 2027 beëindigd.

Vaste huisarts

12. Cliënt Jan de Vries heeft huisarts-situatie "huisarts bekend" (alternatieven: "geen huisarts", "cliënt staat correspondentie met huisarts niet toe" — ZPM-verwijstype 04/05, onderzoek-proces §2.8).
13. Cliënt Jan de Vries heeft als vaste huisarts P. Pietersen, verbonden aan Huisartsenpraktijk De Vries & Pietersen, sinds 14 juli 2026. (vaste huisarts ≠ incidentele verwijzer; kan dezelfde persoon zijn)

Verzekering en financiering per wettelijk kader

14. Cliënt Jan de Vries is verzekerd bij zorgverzekeraar met UZOVI-code 3311 onder polisnummer 987654, geldig vanaf 1 januari 2026.
15. De verzekering van Jan de Vries is op 14 juli 2026 geverifieerd via een COV-controle.
16. Bij de aanmelding van 14 juli 2026 onder wettelijk kader "Jeugdwet" hoort gemeentelijke toewijzing 301-20260714-001 van gemeente Utrecht (gemeentecode 0344), met periode 1 augustus 2026 t/m 31 januari 2027. (alleen bij kader Jeugdwet/Wmo — iJw/iWmo, onderzoek-standaarden §7)

Verwijzing (verrijking van de aanmelding) — vervallen, zie model-instroom.md

(Feitzinnen 17–25 hieronder zijn vervangen door ../feitenmodellen/feitenmodel-instroom.md en de entiteiten in model-instroom.md — Professional Referral, Municipal Care Assignment, Referral Case. Behouden als historisch werkdocument.)

17. (verfijnt §5.1 feitzin 8) Bij de aanmelding van 14 juli 2026 hoort een verwijzing, afgegeven op 1 juli 2026 door verwijzer P. Pietersen. (verwijsdatum ≠ aanmelddatum; 275-dagentoets en per 2026 verplicht op de declaratie — onderzoek-proces §2.3/§2.10)
18. De verwijzing vermeldt echelon "gespecialiseerde ggz".
19. De verwijzing vermeldt een vermoeden van een DSM-benoemde psychische stoornis: "depressieve klachten".
20. De verwijzing betreft een heraanmelding: nee.
21. De aanmelding van 14 juli 2026 heeft ZPM-verwijstype "01 — verwijzing aanwezig". (afleidbaar, maar overschrijfbaar registreerbaar — onderzoek-standaarden §6.3)
22. De aanmelding van 14 juli 2026 volgt doorverwijsroute "doorverwijzing tussen ggz-aanbieders". (optioneel; alleen bij één van de vijf erkende routes — onderzoek-proces §2.7)
23. Voor de aanmelding van 15 juli 2026 zonder verwijzing (crisis) is de huisarts op 20 juli 2026 geïnformeerd. (60-dagentermijn — onderzoek-proces §2.6)

Aanmelding (aanvullingen) — vervallen, zie model-instroom.md

24. De aanmelding van 14 juli 2026 is ontvangen via aanmeldkanaal "ZorgDomein".
25. (verfijnt §5.1 besluit 5) De aanmelding van 14 juli 2026 heeft uitkomst "intake", vastgesteld op 17 juli 2026. (uitkomst + uitkomstdatum als aparte feiten naast de status)

Toestemmingen (WGBO/AVG)

26. Cliënt Jan de Vries heeft op 14 juli 2026 toestemming van type "correspondentie met huisarts/verwijzer" verleend, vastgelegd door K. Jansen, wijze "mondeling".
27. Cliënt Jan de Vries heeft op 1 september 2026 de toestemming van type "vermelding DSM-hoofdgroep op factuur" geweigerd.
28. Cliënt Jan de Vries heeft de toestemming van type "correspondentie met huisarts/verwijzer" op 1 december 2026 ingetrokken.

Zorgepisode — vervallen, zie model-instroom.md

(Feitzinnen 29–30 zijn achterhaald: de episode ontstaat sinds B22/B23 bij het acceptatiebesluit zelf, niet bij uitkomst "intake" — zie model-instroom.md §2.18 clinical_care_episode.)

29. Voor cliënt Jan de Vries is op 17 juli 2026 een zorgepisode gestart, voortkomend uit de aanmelding van 14 juli 2026. (ontstaat bij uitkomst "intake" — zie §5 en besluitpunt 1)
30. De zorgepisode van Jan de Vries is op 15 maart 2027 afgesloten met reden "behandeling afgerond".

---

2. Entiteiten

2.1 PERSOON

Doel: draagt de identiteit van een natuurlijk persoon, onafhankelijk van rollen (cliënt, contactpersoon, vertegenwoordiger, later medewerker). Discovery §5.1 besluit 1.

Attribuut	Type	Verplicht
achternaam	tekst	ja
voorvoegsels	tekst	nee
voornamen	tekst	nee
initialen	tekst	nee
roepnaam	tekst	nee
geboortedatum	datum	ja
geslacht	waardelijst geslacht	ja
genderidentiteit	waardelijst genderidentiteit	nee
bsn	tekst, versleuteld (pgcrypto), inzage gelogd	nee (rolgebonden eis via nudge — §5.1 besluit 1)
overleden	ja/nee	ja (default nee)
overlijdensdatum	datum	nee

Uniciteit: BSN uniek indien gevuld (op hash-index over de versleutelde waarde). Geen andere harde uniciteitsregel — naam+geboortedatum-duplicaten worden een nudge ("mogelijke dubbele persoon"), geen constraint.

2.2 ADRES

Doel: 0..n adressen per persoon (zib Patient: meerdere adressen mogelijk).

Attribuut	Type	Verplicht
persoon_id	ref PERSOON	ja
adrestype	waardelijst adrestype	ja
straat	tekst	ja
huisnummer	tekst	ja
huisnummertoevoeging	tekst	nee
postcode	tekst	ja
plaats	tekst	ja
land	tekst (default NL)	ja
geldig_van	datum	nee
geldig_tot	datum	nee

Uniciteit: max één actueel (geldig_tot leeg) adres per persoon per adrestype.

2.3 CONTACTGEGEVEN

Doel: telefoonnummers en e-mailadressen per persoon.

Attribuut	Type	Verplicht
persoon_id	ref PERSOON	ja
contacttype	waardelijst contactgegeven_type (telefoon/e-mail)	ja
soort	waardelijst contactgegeven_soort (mobiel privé/vast privé/werk/…)	nee
waarde	tekst	ja
voorkeur	ja/nee	ja (default nee)

Uniciteit: max één voorkeursgegeven per persoon per contacttype.

2.4 CLIENT

Doel: rol op PERSOON: dit persoon is cliënt bij de instelling. Discovery §5.0 besluit 2 + §5.1 besluit 1.

Attribuut	Type	Verplicht
persoon_id	ref PERSOON	ja
clientnummer	geheel getal (reeks per instelling)	ja
client_sinds	datum	ja
huisarts_situatie	waardelijst huisarts_situatie	ja (default "onbekend")

Uniciteit: max één CLIENT-rol per PERSOON; clientnummer uniek. Nudge (geen constraint): "cliënt zonder BSN" (Wabvpz — §5.1 besluit 1).

2.5 CLIENTRELATIE

Doel: contactpersonen en (wettelijk) vertegenwoordigers als relatie tussen een CLIENT en een PERSOON — twee gescheiden assen relatie en rol, conform zib Contactpersoon (onderzoek-standaarden §2.2). Dekt ook gezaghebbende ouders (jeugd) en mentoren/curatoren (Wvggz/WGBO — onderzoek-proces §8).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
persoon_id	ref PERSOON	ja
relatie	waardelijst relatie (partner, ouder, kind, …)	nee
rol	waardelijst relatierol (eerste contactpersoon, wettelijk vertegenwoordiger, …)	ja
vertegenwoordigingsgrond	waardelijst vertegenwoordigingsgrond	nee (alleen bij rol wettelijk vertegenwoordiger)
geldig_van	datum	ja
geldig_tot	datum	nee
toelichting	tekst	nee

Uniciteit: max één actuele rij per (client, persoon, rol). Meerdere rollen per persoon mogelijk (moeder = ouder + gezaghebbend + eerste contactpersoon = drie assen, twee rijen: rol "gezaghebbende ouder" en rol "eerste contactpersoon", beide relatie "ouder"). Zelfrelatie (persoon = cliënt-persoon) niet toegestaan. Leeftijdsafhankelijke rechten (12/16-grenzen WGBO) zijn autorisatie, geen schema — rollenronde.

2.6 VERWIJZER

Doel: persoon of functionaris die verwijst. Eigen begrip (discovery §5.0 besluit 3), los van PRAKTIJK_INSTELLING (§5.1 besluit 2). Wordt óók gebruikt als referent voor de vaste huisarts (zie CLIENT_HUISARTS en besluitpunt 3).

Attribuut	Type	Verplicht
naam	tekst	ja
verwijzertype	waardelijst verwijzertype	ja
agb_code	tekst (vrije invoer — §5.1 besluit 4)	nee (nudge indien agb_verplicht op het type — §5.1 besluit 3)
praktijk_instelling_id	ref PRAKTIJK_INSTELLING	nee
telefoon	tekst	nee
e-mail	tekst	nee

Uniciteit: agb_code uniek indien gevuld. Verwijzer kan zonder praktijk bestaan (gemeente-ambtenaar).

2.7 PRAKTIJK_INSTELLING

Doel: organisatie waaraan verwijzers/huisartsen verbonden zijn. Discovery §5.1 besluit 2.

Attribuut	Type	Verplicht
naam	tekst	ja
soort	waardelijst praktijk_soort (huisartsenpraktijk, ziekenhuis, ggz-instelling, gemeente, arbodienst, overig)	nee
agb_code	tekst	nee
adres/plaats	tekst	nee
telefoon	tekst	nee

Uniciteit: agb_code uniek indien gevuld.

2.8 CLIENT_HUISARTS

Doel: de vaste huisarts van de cliënt, los van de incidentele verwijzer. Nodig omdat de huisarts ook informatie-ontvanger is wanneer hij níet de verwijzer is (intakebrief, beloopsbrief, 60-dagenmelding — onderzoek-proces §2.9, §10.2).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
verwijzer_id	ref VERWIJZER (type huisarts)	nee
praktijk_instelling_id	ref PRAKTIJK_INSTELLING	nee
geldig_van	datum	ja
geldig_tot	datum	nee

Uniciteit: max één actuele registratie per cliënt. Minstens één van verwijzer_id/praktijk_instelling_id gevuld (soms is alleen de praktijk bekend). De situatie "geen huisarts"/"geen toestemming" staat op CLIENT.huisarts_situatie, niet hier.

2.9 VERZEKERING

Doel: Zvw-verzekeringsgegevens van de cliënt (financieringskant bij kader Zvw). Historisch, want verzekeraars wisselen per jaar.

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
uzovi_code	tekst	ja
verzekeraar_naam	tekst	nee
polisnummer	tekst	nee
geldig_van	datum	ja
geldig_tot	datum	nee
cov_gecontroleerd_op	datum	nee

Uniciteit: max één actuele verzekering per cliënt. Nudge: "Zvw-aanmelding zonder actuele COV-controle". Wlz-indicatie en forensische titel: declaratie-ronde (besluitpunt 7).

2.10 AANMELDING — vervallen, zie model-instroom.md

(Vervangen door referral_request en referral_case in model-instroom.md §2.1, §2.6 — inclusief de daar herstelde velden zpm_verwijstype, huisarts_geinformeerd_op en wettelijk_kader. Behouden als historisch werkdocument; de waardelijsten aanmeldkanaal, echelon, zpm_verwijstype en wettelijk_kader in §4 hieronder blijven wel in gebruik.)

Doel: de binnenkomst-gebeurtenis (discovery §5.1 besluit 9). Draagt aanmelddatum (wettelijk controleerbaar gegeven — onderzoek-proces §2.3), kanaal, kader, hulpvraag, status en uitkomst. Screening en aanmeldwachttijd hangen hieraan (§5.2, §5.3).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
aanmelddatum	datum	ja
aanmeldkanaal	waardelijst aanmeldkanaal	nee
wettelijk_kader	waardelijst wettelijk_kader	ja (§5.0 besluit 4)
hulpvraag	tekst	ja
status	waardelijst aanmelding_status	ja (default "nieuw")
uitkomst	waardelijst aanmelding_uitkomst	nee (verplicht bij status "besloten")
uitkomst_datum	datum	nee (verplicht bij uitkomst)
zpm_verwijstype	waardelijst zpm_verwijstype	nee (afleidbaar uit verwijzing/toestemmingen, overschrijfbaar; verplicht richting declaratie bij Zvw)
doorverwijsroute	waardelijst doorverwijsroute	nee
huisarts_geinformeerd_op	datum	nee (instroom zonder verwijzing; nudge harde termijn 60 dagen)
toelichting	tekst	nee

Uniciteit: geen harde beperking op parallelle aanmeldingen; "max één actieve aanmelding per cliënt" is een aan/uit-zetbare bedrijfsregel (§5.0 besluit 5) — in TIP/Nudge, niet in schema.

2.11 VERWIJZING (nieuw — besluitpunt 2) — vervallen, zie model-instroom.md

(Vervangen door professional_referral in model-instroom.md §2.14, inclusief het herstelde heraanmelding-veld en de vervangt-relatie voor correctie/aanvulling — zie B23.)

Doel: de verwijzing als eigen registratie-object bij de aanmelding. Verfijnt §5.1 feitzin 8: "ontvangen via verwijzer X" blijft waar, maar de verwijzing draagt eigen wettelijk relevante feiten die niet op de aanmelding of de verwijzer thuishoren: verwijsdatum (275-dagentoets; per 1-1-2026 verplicht op elke declaratie), echelon, DSM-vermoeden, heraanmelding-vlag (onderzoek-proces §2, onderzoek-standaarden §8). Een zelfaanmelding heeft géén verwijzing.

Attribuut	Type	Verplicht
aanmelding_id	ref AANMELDING	ja
verwijzer_id	ref VERWIJZER	ja
verwijsdatum	datum	ja
echelon	waardelijst echelon	nee (ontbreekt op verwijzing → aanbieder kiest zelf, onderzoek-proces §2.5)
vermoeden_dsm_stoornis	tekst	nee
heraanmelding	ja/nee	ja (default nee)
toelichting	tekst	nee

Uniciteit: max één verwijzing per aanmelding. Geldigheidstoets (aanmelddatum − verwijsdatum ≤ 275 dagen) is een nudge, geen constraint (onvolledige/late verwijzing mag — inspanningsverplichting, onderzoek-proces §2.5).

2.12 VERWIJSDOCUMENT — vervallen, zie model-instroom.md

(Vervangen door submission_document in model-instroom.md §2.3 — nu gekoppeld aan de submission die het document aanleverde, niet aan de aanmelding.)

Doel: ontvangen documenten bij de aanmelding, getypeerd (verwijsbrief, beschikking, …) — discovery §5.1 besluit 7.

Attribuut	Type	Verplicht
aanmelding_id	ref AANMELDING	ja
documenttype	waardelijst verwijsdocument_type	ja
document_referentie	ref documentopslag (UUID)	ja
ontvangen_op	datum	ja

Uniciteit: geen (meerdere documenten per aanmelding toegestaan).

2.13 TOEWIJZING (nieuw — gemeentelijk kader) — vervallen, zie model-instroom.md

(Vervangen door municipal_care_assignment in model-instroom.md §2.15 — zelfde minimale opzet, nu expliciet náást in plaats van in plaats van professional_referral gemodelleerd, met een vervangt-relatie voor herziene 301-berichten. Juridisch nog niet door een jurist bevestigd, zie B27.)

Doel: bij kader Jeugdwet/Wmo is de "verwijzing" feitelijk een gemeentelijke beschikking/toewijzing met eigen sleutelgegevens (iWmo/iJw 301-bericht) — meer structuur dan een document alleen (onderzoek-standaarden §7). Minimale variant nu; productcodes/volume volgen in de declaratie-ronde (besluitpunt 6).

Attribuut	Type	Verplicht
aanmelding_id	ref AANMELDING	ja
gemeentecode	tekst (CBS-code)	ja
gemeente_naam	tekst	nee
toewijzingsnummer	tekst	ja
ingangsdatum	datum	ja
einddatum	datum	nee

Uniciteit: toewijzingsnummer uniek per gemeentecode.

2.14 TOESTEMMING (nieuw — besluitpunt 4)

Doel: één generieke toestemmingsentiteit (WGBO/AVG). Toestemmingen duiken in de instroom al op drie plekken op: correspondentie huisarts/verwijzer (verwijstype 04!), DSM-hoofdgroep op factuur (opt-in sinds 2025), privacyverklaring zorgvraagtypering (onderzoek-standaarden §9.5; onderzoek-proces §2.8/§7). Cliëntakkoord op het behandelplan blijft een apart feit bij het behandelplan (deelgebied §5.5), geen TOESTEMMING-rij.

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
toestemmingstype	waardelijst toestemming_type	ja
status	waardelijst toestemming_status	ja
datum	datum	ja
wijze	waardelijst toestemming_wijze	nee
vastgelegd_door	ref medewerker (rollenronde)	ja
geldig_tot	datum	nee
ingetrokken_op	datum	nee
scope_aanmelding_id / scope_episode_id	ref (optioneel)	nee (default: cliëntbreed)
toelichting	tekst	nee

Uniciteit: max één actuele (niet-ingetrokken) rij per (client, toestemmingstype, scope). Intrekken = nieuw statusfeit, historie blijft (append-only audit).

2.15 ZORGEPISODE — vervallen, zie model-instroom.md

(Vervangen door clinical_care_episode in model-instroom.md §2.18 — belangrijkste wijziging: ontstaat bij het acceptatiebesluit zelf (of een Wvggz-mandaat), niet meer bij uitkomst "intake". Alleen ontstaan/einde zijn daar uitgewerkt; het volledige episodemodel — programma-/organisatiebetrokkenheid, zorgteam — blijft een apart deelgebied.)

Doel: de periode van zorg (discovery §5.1 besluit 9). Draagt intakes, diagnoses, behandelplannen, behandelwachttijd, zorgvraagtypering (latere ronde). Klinisch object, niet het ZPM-zorgtraject — verwant, gekoppeld, geen 1-op-1 (onderzoek-standaarden §6.1; onderzoek-leveranciers §2.3).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja
aanmelding_id	ref AANMELDING (herkomst)	ja
startdatum	datum	ja
status	waardelijst episode_status	ja (default "lopend")
echelon_actueel	waardelijst echelon	nee (kan wijzigen door op-/afschalen — besluitpunt 5)
einddatum	datum	nee
einde_reden	waardelijst episode_einde_reden	nee (verplicht bij afsluiten; startlijst te bevestigen, sluit t.z.t. aan op iStd-redenen)
zorgtrajectnummer	tekst	nee (gereserveerd; invulling declaratie-ronde)

Uniciteit: max één episode per aanmelding (een aanmelding met uitkomst "intake" leidt tot precies één episode; afgewezen/doorverwezen aanmeldingen hebben er nooit één — §5.1 besluit 9). Meerdere episodes per cliënt door de tijd. Ontstaansmoment: bij uitkomst "intake", niet bij "wachtlijst" — zie §5 en besluitpunt 1.

2.16 CLIENTPORTAAL_ACCOUNT

Doel: relatie-placeholder (discovery §5.1 besluit 8). Wettelijke basis: elektronische inzage Wabvpz (onderzoek-proces §8).

Attribuut	Type	Verplicht
client_id	ref CLIENT	ja

Uniciteit: max één account per CLIENT (1-op-0..1). Authenticatiedetails en statussen: auth/ADM-ronde. Portaaltoegang voor vertegenwoordigers (ouders, 12–16-regels) raakt CLIENTRELATIE — ook auth-ronde.

---

3. Relaties met cardinaliteit

Geldig (PERSOON/CLIENT-laag):

Van	Naar	Cardinaliteit	Toelichting
PERSOON	ADRES	1 — 0..n	max 1 actueel per adrestype
PERSOON	CONTACTGEGEVEN	1 — 0..n
PERSOON	CLIENT	1 — 0..1	rol; één cliëntrol per persoon
CLIENT	CLIENTRELATIE	1 — 0..n	contactpersonen/vertegenwoordigers
PERSOON	CLIENTRELATIE	1 — 0..n	de relatie-persoon
VERWIJZER	PRAKTIJK_INSTELLING	0..n — 0..1	verwijzer kan zonder praktijk
CLIENT	CLIENT_HUISARTS	1 — 0..n	max 1 actueel
CLIENT_HUISARTS	VERWIJZER / PRAKTIJK_INSTELLING	— 0..1 / 0..1	minstens één gevuld
CLIENT	VERZEKERING	1 — 0..n	max 1 actueel
CLIENT	TOESTEMMING	1 — 0..n
CLIENT	CLIENTPORTAAL_ACCOUNT	1 — 0..1

Vervallen (AANMELDING/VERWIJZING/VERWIJSDOCUMENT/TOEWIJZING/ZORGEPISODE) — zie model-instroom.md §3 voor de actuele cardinaliteitentabel van referral_request/referral_submission/referral_case/ professional_referral/municipal_care_assignment/clinical_care_episode:

Van	Naar	Cardinaliteit	Toelichting
CLIENT	AANMELDING	1 — 0..n	episodisch (§5.0 besluit 2)
AANMELDING	VERWIJZING	1 — 0..1	zelfaanmelding: geen
VERWIJZING	VERWIJZER	0..n — 1
AANMELDING	VERWIJSDOCUMENT	1 — 0..n
AANMELDING	TOEWIJZING	1 — 0..n	alleen kader Jeugdwet/Wmo
AANMELDING	ZORGEPISODE	1 — 0..1	alleen bij uitkomst "intake"
CLIENT	ZORGEPISODE	1 — 0..n

Naar andere deelgebieden (AANMELDING/ZORGEPISODE hieronder zijn de oude ankers; lees deze als referral_case/clinical_care_episode totdat screening/wachtlijst/intake/diagnose/behandelplan zelf zijn gesynchroniseerd):

Van	Naar (deelgebied)	Cardinaliteit
AANMELDING	SCREENING (§5.2)	1 — 0..1
AANMELDING	WACHTLIJSTPLAATSING soort "aanmeld" (§5.3)	1 — 0..n
ZORGEPISODE	INTAKE (§5.2)	1 — 0..n (regulier + intern)
ZORGEPISODE	WACHTLIJSTPLAATSING soort "behandel" (§5.3)	1 — 0..n
ZORGEPISODE	DIAGNOSE (§5.4)	1 — 0..n
ZORGEPISODE	BEHANDELPLAN (§5.5)	1 — 0..n (versies)
ZORGEPISODE	ZORGVRAAGTYPERING (latere ronde)	1 — 0..n
ZORGEPISODE	regiebehandelaar-toewijzing (rollenronde)	1 — 0..n
TOESTEMMING	correspondentie-verplichtingen (latere ronde: intakebrief, beloopsbrief)	grondslag per verstrekking

---

4. Waardelijsten

Alle lijsten volgen het conventie-patroon (code, omschrijving, externe code, geldigheid). Startwaarden:

(Nummering ongewijzigd gelaten — model-instroom.md §4 verwijst naar 12, 17 en 18 hieronder. Items 13–16, 19, 23 zijn vervallen ten gunste van waardelijsten in model-instroom.md; zie annotaties per item.)

1. geslacht — man, vrouw, anders, onbekend (externe code: HL7 AdministrativeGender)
2. genderidentiteit — man, vrouw, non-binair, anders, zegt_het_niet (zib Patient v4.3)
3. adrestype — woonadres, postadres, tijdelijk_verblijf
4. contactgegeven_type — telefoon, email
5. contactgegeven_soort — mobiel_prive, vast_prive, werk, overig
6. relatie — partner, ouder, kind, broer_zus, familielid_overig, vriend_kennis, professional, overig
7. relatierol — eerste_contactpersoon, wettelijk_vertegenwoordiger, gezaghebbende_ouder, mantelzorger, naaste (twee assen relatie × rol — zib Contactpersoon)
8. vertegenwoordigingsgrond — curator, mentor, schriftelijk_gemachtigde, ouder_voogd, partner_familie (WGBO-volgorde, onderzoek-proces §8)
9. huisarts_situatie — bekend, geen_huisarts, geen_toestemming_correspondentie, onbekend (voedt ZPM-verwijstype 04/05)
10. verwijzertype — met attribuut agb_verplicht (ja/nee), §5.1 besluit 3. Startwaarden (discovery §5.0 besluit 3 + Verwijsafspraken GGZ, onderzoek-proces §2.2):

code	agb_verplicht
huisarts	ja
medisch_specialist	ja
straatdokter	ja
bedrijfsarts	ja
regiebehandelaar	ja
ggz_instelling	ja
gemeente	nee
zelfaanmelding	nee
crisis	nee

11. praktijk_soort — huisartsenpraktijk, ziekenhuis, ggz_instelling, gemeente, arbodienst, overig
12. wettelijk_kader — met attribuut verwijsnudge_severity (§5.1 besluit 7): zvw (blokkade), jeugdwet (signaal), wmo (signaal), wlz (waarschuwing), forensisch (waarschuwing) (severity-startwaarden te bevestigen in de nudge-ronde; NB bij Zvw zonder spoed/Wvggz is ontbrekende verwijzing feitelijk declaratie-blokkerend — onderzoek-proces §10.3)
13. aanmeldkanaal — zorgdomein, brief_post, e_mail, telefonisch, clientportaal, crisis, intern, overig (vervallen — komt terug als submission_channel in model-instroom.md §4, met vergelijkbare waarden)
14. aanmelding_status — nieuw, in_screening, besloten (vervallen — referral_case heeft geen statusveld meer, zie B25 en model-instroom.md §5)
15. aanmelding_uitkomst — intake, afgewezen, doorverwezen, wachtlijst (vervallen — vervangen door de gesplitste decision_outcome/follow_up_route in model-instroom.md §4, zie B22)
16. verwijsdocument_type — verwijsbrief, beschikking, wlz_indicatiebesluit, huisartsmelding_60dagen, medische_verklaring_wvggz, overig (vervallen — komt terug als document_type in model-instroom.md §4; de Wvggz-waarde hoort inmiddels bij legal_mandate.medical_statement_reference)
17. echelon — gb_ggz, g_ggz, onbekend (blijft in gebruik — hergebruikt door professional_referral in model-instroom.md)
18. zpm_verwijstype — 01 t/m 07 conform ZPM-veldafspraken (externe code = Vektis/ZPM-code; onderzoek-standaarden §6.3): 01 verwijzing_aanwezig, 02 doorverwijzing_regiebehandelaar, 03 geen_verwijzing_verlate_correspondentie, 04 geen_verwijzing_correspondentie_niet_toegestaan, 05 geen_verwijzing_niet_declarabel, 06 geen_verwijzing_andere_grond_fz, 07 verwijzing_zonder_agb (blijft in gebruik — hergebruikt door referral_case.zpm_verwijstype in model-instroom.md)
19. doorverwijsroute — justitieel_traject, einde_wlz_indicatie, overgang_jeugdwet, vervolg_acute_ggz, ggz_naar_ggz (de vijf erkende routes; moet uit het dossier blijken — onderzoek-proces §2.7) — nog niet geïntegreerd in model-instroom.md. Dit is reële, niet-gedekte inhoud: model-instroom.md heeft alleen de grovere follow_up_route-waarde doorverwijzen, niet welke van de vijf erkende routes. Op te pakken bij de volgende instroom-ronde, niet stilzwijgend laten vervallen.
20. toestemming_type — met attribuut grondslag (tekst): correspondentie_huisarts_verwijzer (WGBO/verwijsafspraken), dsm_hoofdgroep_op_factuur (Stcrt. 2025-11955, opt-in), privacyverklaring_zorgvraagtypering (NZa), gegevensdeling_derden (AVG), inzage_naasten (WGBO)
21. toestemming_status — verleend, geweigerd, ingetrokken
22. toestemming_wijze — mondeling, schriftelijk, portaal
23. episode_status — lopend, afgesloten (vervallen — clinical_care_episode heeft geen statusveld, status volgt uit ended_at/end_reason, zie model-instroom.md §2.18)
24. episode_einde_reden — behandeling_afgerond, doorverwezen, client_beeindigt, geen_contact, overleden, overig (startlijst; mapping op iStandaarden-redenen in de declaratie-ronde) (komt terug als episode_end_reason in model-instroom.md §4, aangevuld met ingetrokken_door_client/acceptatiebesluit_herzien, zie B24)

---

5. Statusmachine

AANMELDING — vervallen, zie model-instroom.md

(referral_case heeft bewust geen statusveld meer — de actuele stand wordt afgeleid uit een gebeurtenistijdlijn, zie B25 en model-instroom.md §1/§5. Behouden als historisch werkdocument.)

Statussen: nieuw → in_screening → besloten. Flexibel, geen eenrichtingsflow (§5.1 besluit 5).

Van	Naar	Voorwaarde
nieuw	in_screening	—
nieuw	besloten	direct besluit toegestaan (bijv. evidente doorverwijzing)
in_screening	besloten	uitkomst + uitkomst_datum verplicht
besloten	in_screening	heropening; uitkomst en uitkomst_datum worden gearchiveerd in de audit, velden leeg

Regels in het model (spelregel 3.1 #7/#9): check-constraint "status = besloten ⇒ uitkomst en uitkomst_datum gevuld"; overgangen in een referentietabel statusovergang (entiteit, van, naar), niet in schermcode. Bij uitkomst intake: ZORGEPISODE wordt aangemaakt (zie hieronder). Bij uitkomst wachtlijst: WACHTLIJSTPLAATSING soort "aanmeld" aan de AANMELDING — geen episode.

Wie mag zetten: rollenronde (§5.1 besluit 6). Kandidaat-inperking om daar te toetsen: besloten alleen door een rol met indicatiebevoegdheid (LKS: indicerende rol regiebehandelaar).

ZORGEPISODE — vervallen, zie model-instroom.md

(clinical_care_episode ontstaat bij het acceptatiebesluit zelf — ook tijdens de intakewachtlijst — niet meer bij uitkomst "intake"; zie B22 en model-instroom.md §2.18. Behouden als historisch werkdocument.)

Statussen: lopend → afgesloten.

Van	Naar	Voorwaarde
lopend	afgesloten	einddatum + einde_reden verplicht
afgesloten	lopend	heropening bij administratieve fout; terugval krijgt een nieuwe episode (besluitpunt 8)

Ontstaansregel (beantwoording open detail §5.1 besluit 9): de episode ontstaat op het moment dat de aanmelding uitkomst "intake" krijgt; startdatum = uitkomst_datum. Bij uitkomst "wachtlijst" ontstaat géén episode. Onderbouwing: de NZa-behandelwachttijd loopt vanaf de intake en de verantwoordelijkheidsoverdracht van verwijzer naar aanbieder ligt ná de intake bij de regiebehandelaar (LKS 4.0; onderzoek-proces §1, §4.2, §10.3 — "episode pas bij intake, aanmeldwachttijd op de aanmelding"). De aanmeldwachtlijst hangt aan de AANMELDING (§5.3-besluit), dus er gaat niets verloren. Komt de cliënt van de aanmeldwachtlijst alsnog naar intake, dan wordt de uitkomst bijgewerkt naar "intake" (heropening → besloten) en ontstaat de episode alsnog. Wie mag zetten: rollenronde.

Overige entiteiten

PERSOON, CLIENT, VERWIJZER, PRAKTIJK_INSTELLING, CLIENT_HUISARTS, VERZEKERING: geen statusmachine — levenscyclus via geldigheidsperioden en soft delete. TOESTEMMING: verleend/geweigerd → ingetrokken (eenrichting; nieuwe toestemming = nieuwe rij). CLIENTPORTAAL_ACCOUNT: statusmachine in de auth/ADM-ronde.

---

6. ECD/TIP-eigenaarschap en events richting TIP

Vervallen voor het instroomdeel, nog niet opnieuw uitgewerkt. De events hieronder (aanmelding_*, verwijzing_*, toewijzing_*, zorgepisode_*) verwijzen naar entiteiten die niet meer bestaan. model-instroom.md bevat nog geen TIP-event-ontwerp — dat vereist een eigen ontwerpstap (welke gebeurtenis uit de nieuwe tijdlijn-aanpak een TIP-event triggert), niet alleen een naamsvervanging. Behouden als historisch werkdocument en als checklist van wat opnieuw moet worden doordacht. De rijen voor CLIENT/CLIENTRELATIE/CLIENT_HUISARTS/TOESTEMMING blijven wel geldig.

Eigenaarschap: alle entiteiten in dit deelgebied zijn leidend in het ECD (klinische/administratieve feiten — discovery §3.3). TIP houdt de proces-state: screeningstaken, termijnbewaking, wachtlijst-nudges, "max één actieve aanmelding"-bedrijfsregel.

Events naar TIP (mutatie-events, zelfde mechanisme als her-embedding — §3.3 koppelafspraak; payload bevat UUID + content-hash, nooit BSN — spelregel 3.1 #6):

Event	Trigger	Waarvoor TIP het nodig heeft
client_geregistreerd	nieuwe CLIENT	workspace/dossiercontext aanmaken
aanmelding_geregistreerd	nieuwe AANMELDING	screeningstaak starten; Treeknorm-klok aanmeldwachttijd (4 wkn); 275-dagentoets als verwijzing volgt
aanmelding_status_gewijzigd	statusovergang	procesbewaking, heropening detecteren
aanmelding_besloten	status besloten (incl. uitkomst)	vervolgacties: intake plannen / wachtlijst / terugverwijsbrief
verwijzing_geregistreerd	nieuwe/gewijzigde VERWIJZING	275-dagen-geldigheidsnudge; "verwijzing onvolledig"-inspanningsnudge
verwijzing_ontbreekt	aanmelding zonder VERWIJZING onder Zvw	nudge met severity per wettelijk kader (§5.1 besluit 7); 60-dagen-huisartsmelding-termijn
toewijzing_geregistreerd	nieuwe TOEWIJZING	iWmo/iJw-startberichten (305) t.z.t.
zorgepisode_gestart	nieuwe ZORGEPISODE	Treeknorm-klok behandelwachttijd (10 wkn); regiebehandelaar-toewijzing agenderen
zorgepisode_afgesloten	status afgesloten	afrondingsbrief-taak; terugval-venster 1 jaar (ZPM) bewaken
toestemming_gewijzigd	TOESTEMMING-mutatie	correspondentie-taken blokkeren/vrijgeven (intakebrief vereist toestemming)
clientrelatie_gewijzigd	CLIENTRELATIE-mutatie	vertegenwoordiger-afhankelijke rechten/portaal
huisarts_gewijzigd	CLIENT_HUISARTS / huisarts_situatie	correspondentie-adressering; verwijstype-afleiding

TIP-snapshots van deze data zijn doelgebonden auditkopieën met herkomst (afstemming Joshua, discovery §3.3) — het ECD blijft bron.

---

7. Open besluitpunten voor Colin

Status per punt na de instroom-sync (19 juli 2026):

1. Ontstaansmoment ZORGEPISODE. Herzien, niet bekrachtigd zoals hier geadviseerd. De uiteindelijke beslissing (B22) is dat de episode ontstaat bij het acceptatiebesluit zelf, óók bij vervolgroute intakewachtlijst — niet pas bij uitkomst "intake" zoals hier geadviseerd. Zie model-instroom.md §2.18.
2. VERWIJZING als eigen entiteit. Bevestigd zoals geadviseerd, nu professional_referral (model-instroom.md §2.14), met als aanvulling een vervangt-relatie voor correctie/aanvulling (B23) die hier nog niet was voorzien.
3. Vaste huisarts via hergebruik van VERWIJZER/PRAKTIJK_INSTELLING. Al verwerkt — CLIENT_HUISARTS (§2.8) gebruikt deze opzet al, geen open vraag meer. Blijft ongewijzigd bij de sync.
4. TOESTEMMING nu al als generieke entiteit. Al verwerkt — TOESTEMMING (§2.14) bestaat al met deze opzet, geen open vraag meer. Blijft ongewijzigd bij de sync; model-instroom.md hergebruikt deze entiteit voor correspondentietoestemming.
5. Echelon op twee plekken. Deels opgelost. Bron-echelon staat op professional_referral.echelon. Een "actueel echelon" op de episode zelf (voor op-/afschalen na de instroom) is niet meegenomen — clinical_care_episode in model-instroom.md is bewust beperkt tot ontstaan/einde; dit hoort bij het bredere, nog te ontwerpen episodemodel.
6. TOEWIJZING minimaal nu. Verder uitgewerkt dan hier geadviseerd. municipal_care_assignment (model-instroom.md §2.15) bevat, op basis van juridisch onderzoek naar het WMO301/iJw301-bericht, al productcategorie/-code/volume/eenheid — verder dan de hier voorgestelde minimale variant.
7. Financieringsdetail Wlz/forensisch. Nog steeds open — niet opgepakt in de instroom-ronde. wettelijk_kader kent de waarden wlz/forensisch al (waardelijst 12), maar een indicatiebesluit- of titel-registratie ontbreekt nog.
8. Terugval binnen 1 jaar. Bevestigd (nieuwe episode), met een aanvulling. possible_continuation_of_episode_id (model-instroom.md §2.18) legt optioneel een zorginhoudelijke continuïteitsrelatie tussen de oude en nieuwe episode, expliciet geen autoritatieve trajectnummer-toets — die blijft, zoals hier al voorzien, bij de declaratie-ronde.
9. Huisarts-informeren als attribuut. Bevestigd zoals geadviseerd, nu op referral_case.huisarts_geinformeerd_op (model-instroom.md §2.6) in plaats van op AANMELDING.
10. Startwaarden verwijsnudge_severity per wettelijk kader (waardelijst 12): bij Zvw is ontbrekende verwijzing zonder spoed/Wvggz-grond feitelijk declaratie-blokkerend — is blokkade daar de juiste severity, en welke voor Wlz/forensisch? Nog steeds open — niet opgepakt in de instroom-ronde; advies blijft: vaststellen in de nudge-/declaratie-ronde, waardelijst-attribuut staat er klaar voor.

---

8. Bronverwijzingen

Onderdeel	Bron
PERSOON/CLIENT-splitsing, BSN optioneel	discovery §5.1 besluit 1; spelregel 3.1 #6
Gestructureerde naam, meerdere adressen, geslacht/genderidentiteit, overlijden	onderzoek-standaarden §2.2 (zib Patient v4.3), §8
CLIENTRELATIE met twee assen relatie × rol	onderzoek-standaarden §2.2 (zib Contactpersoon v5.0); onderzoek-leveranciers §2.2 (Nedap ClientContactRelation + Type)
Vertegenwoordiging, leeftijdsgrenzen 12/16	onderzoek-proces §8 (WGBO/KNMG)
Vaste huisarts als informatie-ontvanger, huisarts onbekend/geen toestemming	onderzoek-proces §2.8–§2.9
VERWIJZING: verwijsdatum, 275 dagen, echelon, heraanmelding, DSM-vermoeden	onderzoek-proces §2.3–§2.5, §2.10 (Verwijsafspraken GGZ, NHG-richtlijn, NR/REG-2616a); onderzoek-standaarden §2.2, §8
ZPM-verwijstypen 01–07, zorglabels	onderzoek-standaarden §6.3 (ZPM-veldafspraken jan 2022)
Doorverwijsroutes (5 erkende)	onderzoek-proces §2.7
60-dagen-huisartsmelding	onderzoek-proces §2.6
Referral-decompositie marktconform	onderzoek-leveranciers §2.2 (Nedap Referral)
TOEWIJZING (iWmo/iJw 301, woonplaatsbeginsel)	onderzoek-standaarden §7
VERZEKERING/COV	onderzoek-proces §10.1 stap 2; iStandaarden/Vecozo-praktijk
TOESTEMMING generiek (drie vindplaatsen)	onderzoek-standaarden §9.5; onderzoek-proces §2.8, §7 (opt-in DSM, privacyverklaring)
Episode-ontstaan bij intake	onderzoek-proces §1 (LKS-verantwoordelijkheidsoverdracht), §4.1–§4.2 (Treeknorm/NZa-definities), §10.3
Episode ≠ ZPM-zorgtraject, trajectnummer-hergebruik	onderzoek-standaarden §6.1; onderzoek-leveranciers §2.3
Statusmachine expliciet, regels in model	spelregels 3.1 #7/#9; discovery §5.1 besluiten 5–6
Waardelijsten met geldigheidsperioden en externe codes	onderzoek-leveranciers §2.2/§7.1; onderzoek-standaarden §8
TIP-grensvlak, events, snapshots	discovery §3.3 (afstemming Joshua 17-7-2026)
Wachtlijst aan aanmelding/episode	discovery §5.3-besluit; onderzoek-proces §4