Inclusie |
0 … * |
|
van 2.16.840.1.113883.2.4.3.11.60.101.10.1 Naam persoon (2014‑11‑06)
|
hl7:name
|
PN |
0 … * |
|
|
(Per…nNL) |
@use
|
set_cs |
0 … 1 |
|
In principe kan van elke Person Name worden aangegeven in welke situatie deze gebruikt
kan worden. Voor Nederland is besloten dat de volgende naamgebruikstypen voor kunnen
komen
|
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
|
|
Gekoppeld aan concepten:
|
Keuze |
0 … * |
|
Merk op dat de volgorde van de elementen, die elk meerdere malen mogen voorkomen,
de volgorde voor weergave bepaalt.
Elementen om uit te kiezen:
- hl7:given
- hl7:prefix
- hl7:family
- hl7:suffix
- hl7:delimiter
|
|
Constraint |
Het is niet toegestaan om lege naamdelen mee te geven. Om aan te geven dat een naamdeel
leeg is dient het simpelweg niet te worden gebruikt.
|
hl7:given
|
ENXP |
|
|
Bevat voorletter(s), roepnamen of voorna(a)m(en) van de persoon. Het attribuut qualifier
bepaalt wat het is.
|
(Per…nNL) |
@qualifier
|
set_cs |
0 … 1 |
|
|
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
hl7:prefix
|
ENXP |
|
|
Bevat het voorvoegsel van de geslachtsnaam of geslachtsnaam partner met de qualifier
'VV' (voorvoegsel), en/of de adellijke titel met qualifier 'NB'. Merk op dat de volgorde
van de XML tags in het bericht van belang is: de voorvoegsels dienen altijd vóór de
bijbehorende family name gecommuniceerd te worden. Merk op dat een voorvoegsel eindigt
met een spatie indien het type voorvoegsel dit vereist (wel bij "de " en "van ", maar
niet bij "l‘".) Eventuele adellijke titels/predikaten worden, voorzien van de qualifier
NB, voor de geslachtsnaam opgenomen.
|
(Per…nNL) |
@qualifier
|
set_cs |
0 … 1 |
|
|
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
hl7:family
|
ENXP |
|
|
Bevat de geslachtsnaam of geslachtsnaam partner. Het attribuut qualifier bepaalt wat
het is.
|
(Per…nNL) |
@qualifier
|
set_cs |
0 … 1 |
|
|
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
hl7:suffix
|
ENXP |
|
|
Een suffix heeft betrekking op een deel van de naam dat hoort bij één of meer andere
naamdelen en daar achter wordt geschreven. In Nederland zijn als achtervoegsel alleen
academische titels toegestaan. Enkele regels voor person name parts van type suffix:
- Een suffix moet altijd direct achter de naamdelen worden geplaatst waar het betrekking
op heeft (d.w.z. waar het normaal gesproken wordt geschreven).
- Er is geen impliciete spatie als tussenruimte met het eraan voorafgaande name part,
d.w.z. een spatie voor het achtervoegsel moet expliciet worden vermeld!
- De aard van het achtervoegsel kan verder worden aangeduid door het optionele attribuut
qualifier te gebruiken.
Een person name part van type suffix dat zonder qualifier wordt gebruikt, moet worden
beschouwd als een niet nader bepaald achtervoegsel. Ook het gebruik van (vaak Amerikaanse)
termen als ' Jr.', ' Sr.' of ' III' valt in deze categorie.
Er is geen regel voor het aantal achtervoegsels dat wordt gecombineerd in één element.
D.w.z. dat " MSc" en " MD" apart kunnen worden doorgegeven, maar ook gecombineerd
als " MSc MD".
|
(Per…nNL) |
@qualifier
|
set_cs |
0 … 1 |
|
|
|
CONF |
|
hl7:delimiter
|
ENXP |
|
|
Een delimiter heeft geen speciale betekenis als onderdeel van een Person Name, anders
dan het doorgeven van een (stukje) letterlijke tekst dat in de geschreven naam voorkomt.
Een delimiter moet altijd op de plaats in de Person Name staan waar de tekst ook geschreven
zou worden. Er zijn geen impliciete spaties, dus als er normaal gesproken een spatie
voor of achter geschreven wordt, dan moet deze expliciet worden meegegeven.
Voorbeelden van delimiters zijn:
- Het streepje '-' tussen de eigen achternaam en de partnernaam (of andersom).
- De komma plus spatie ', ' die tussen de naam en bepaalde achtervoegsels komt.
- De tekst ', geb. ' of ', e.v. ' die soms gebruikt wordt bij eigen- respectievelijk
partnernaam.
Merk op: de spatie tussen een voorvoegsel en de achternaam is geen delimiter, het
behoort bij het voorvoegsel. Dit geldt tevens voor andere scheidingstekens behorende
bij een voorvoegsel zoals in de naam "D'Artagnan".
|
(Per…nNL) |
hl7:validTime
|
IVL_TS |
0 … 1 |
|
Dit is een optioneel XML-element binnen de Person Name en duidt de periode aan waarin
deze naam 'in gebruik'/geldig was voor de betreffende persoon. De opties zijn:
- Er is geen validTime element: de betreffende naam is in principe onbeperkt geldig.
- Er is een onder- en een bovengrens: de naam was geldig in de aangeduide periode.
- Er is alleen een ondergrens: de naam is geldig sinds de aangeduide datum.
- Er is alleen een bovengrens: de naam was geldig t/m de aangeduide datum.
Dit element van Person Name kan worden gebruikt om aan te geven dat een persoon gedurende
diens leven één of meer keer van naam veranderd is. Dit gebeurt o.a. bij:
- Adoptie van een baby, waarbij het de achternaam van de adoptieouders verkrijgt.
- Huwelijk, waarbij de partnernaam kan worden toegevoegd aan de eigen naam.
- Scheiding, waarbij een eerder aangenomen partnernaam juist weer vervalt.
- Personen die om andere redenen hun voor- of achternaam veranderen.
Merk op dat veel patiëntregistratiesystemen niet echt een historie (met ingangsdatum)
bijhouden van de patiëntnaam. Wel wordt vaak een 'audit trail' (wijzigingshistorie)
van de patiëntgegevens in het algemeen bijgehouden. Indien gewenst zou daaruit een
historie van de persoonsnaam kunnen worden afgeleid, hoewel het natuurlijk ook mogelijk
is om alleen de actuele naam door te geven (en dus geen validTime te gebruiken).
|
(Per…nNL) |
|
Constraint |
In elke situatie waar één of meer persoonsnamen worden doorgegeven, moet minimaal
de naam worden aangeduid die op het moment van verzenden geldig/actueel is. Vervallen
namen kunnen dus alleen worden doorgegeven als het betreffende berichtelement herhalend
is (dus met cardinaliteit > 1). In tegenstelling tot de situatie bij organisatienamen
is het bij persoonsnamen niet toegestaan dat de ondergrens of de bovengrens van een
validTime in de toekomst ligt. Er kan dus geen 'geplande' nieuwe naam of het 'gepland
vervallen' van de huidige naam worden doorgegeven voor persoonsnamen.
|
hl7:administrativeGenderCode
|
CV |
0 … 1 |
R |
Geslacht |
(Per…nNL) |
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
hl7:birthTime
|
TS |
0 … 1 |
R |
Geboortedatum |
(Per…nNL) |
@nullFlavor
|
|
0 … 1 |
F |
UNK |
|
|
Gekoppeld aan concepten:
|
hl7:deceasedInd
|
BL |
0 … 1 |
C |
Indicatie of persoon is overleden. |
(Per…nNL) |
hl7:deceasedTime
|
TS |
0 … 1 |
|
Datum en eventueel tijd van overlijden. Als dit gegeven bekend is, moet element deceasedInd
"true" zijn.
|
(Per…nNL) |
hl7:multipleBirthInd
|
BL |
0 … 1 |
|
Indicatie of persoon deel is van een meerling. |
(Per…nNL) |
hl7:multipleBirthOrderNumber
|
INT |
0 … 1 |
|
Volgnummer van uitkomst. 1 is de eerste, 2 de volgende enzovoorts. Als dit gegeven
bekend is, moet element multipleBirthInd "true" zijn.
|
(Per…nNL) |
hl7:maritalStatusCode
|
CV |
0 … 1 |
|
Burgerlijke staat |
(Per…nNL) |
|
CONF |
|
hl7:educationLevelCode
|
CV |
0 … 1 |
|
Opleiding ouder/verzorger. |
(Per…nNL) |
@codeSystem
|
CONF |
1 … 1 |
F |
2.16.840.1.113883.2.4.4.30.20 (NHG Tabel 20 Code opleiding) |
|
Voorbeeld |
<educationLevelCode code="06" codeSystem="2.16.840.1.113883.2.4.4.30.20" displayName="MBO"/> |
hl7:asEmployee
|
|
0 … 1 |
R |
Beroep van de persoon |
(Per…nNL) |
hl7:code
|
CV |
0 … 1 |
|
Inhoud beroep/type beroep. Het attribuut @nullFlavor moet de waarde 'OTH' bevatten
en het element originalText bevat de beroepsomschrijving
|
(Per…nNL) |
|
CONF |
|
|
Voorbeeld |
<code nullFlavor="OTH"> <originalText>Inhoud beroep</originalText></code> |
hl7:birthPlace
|
|
0 … 1 |
R |
Geboorteplaats en/of land |
(Per…nNL) |
|
Voorbeeld |
<birthPlace> <addr> <county code="0518" codeSystem="2.16.840.1.113883.2.4.6.14">'s-Gravenhage</county> <country code="6030" codeSystem="2.16.840.1.113883.2.4.4.16.34">Nederland</country> </addr></birthPlace> |
hl7:addr
|
AD |
1 … 1 |
M |
Geboorteland/plaats |
(Per…nNL) |
hl7:county
|
SC |
1 … 1 |
M |
Gemeente. Indien deze wordt gecodeerd, dan moet worden gecodeerd volgens GBA tabel
33 (2.16.840.1.113883.2.4.6.14). Merk op dat de gemeente veelal niet gelijk is aan
de woonplaats. Voorbeeld: Voorburg, gem. ‘s-Gravenhage.De text() node is in datatype
SC altijd verplicht.
|
(Per…nNL) |
|
Schematron assert |
role |
error
|
|
|
test |
not(@codeSystem) or @codeSystem='2.16.840.1.113883.2.4.6.14' |
|
|
Melding |
<name path=".."/>/<name/> MOET, indien deze gecodeerd wordt, worden gecodeerd volgens GBA-tabel 33 |
|
hl7:country
|
SC |
0 … 1 |
R |
Land. Indien deze wordt gecodeerd, dan moet worden gecodeerd volgens GBA tabel 34
(2.16.840.1.113883.2.4.4.16.34). De text() node is in datatype SC altijd verplicht.
|
(Per…nNL) |
|
Schematron assert |
role |
error
|
|
|
test |
not(@codeSystem) or @codeSystem='2.16.840.1.113883.2.4.4.16.34' |
|
|
Melding |
<name path=".."/>/<name/> MOET, indien deze gecodeerd wordt, worden gecodeerd GBA tabel 34 Landen |
|
hl7:playedPatientOfOtherProvider
|
|
0 … 1 |
|
Relatie met de huisarts |
(Per…nNL) |
@classCode
|
|
0 … 1 |
F |
PAT |
hl7:subjectOf
|
|
1 … 1 |
M |
De patiënt is het onderwerp van de zorgrelatie met de zorg-verlener. |
(Per…nNL) |
@classCode
|
|
0 … 1 |
F |
SBJ |
hl7:patientCareProvision
|
|
1 … 1 |
M |
Een zorgrelatie tussen een patiënt en een zorgverlener (ook wel een ‘verantwoordelijkheidsperiode’). |
(Per…nNL) |
@classCode
|
|
0 … 1 |
F |
PCPR |
@moodCode
|
|
0 … 1 |
F |
EVN |
hl7:code
|
CE |
1 … 1 |
R |
Typering van de aard van de zorgrelatie tussen patiënt en zorgverlener. |
(Per…nNL) |
@code
|
|
1 … 1 |
F |
GENRL |
|
General care performed by a general practitioner or family doctor as a responsible
provider for a patient. (NL: Huisarts)
|
@codeSystem
|
|
1 … 1 |
F |
2.16.840.1.113883.5.4 |
hl7:responsibleParty
|
|
1 … 1 |
M |
De zorgverlener is de verantwoordelijke voor de zorgrelatie met de patiënt. |
(Per…nNL) |
@typeCode
|
|
0 … 1 |
F |
RESP |
hl7:healthCareProvider
|
|
1 … 1 |
M |
Zorgverlener (persoon of organisatie die gemachtigd is om zorg te verlenen). |
(Per…nNL) |
@classCode
|
|
0 … 1 |
F |
PROV |
hl7:id
|
II |
1 … 1 |
M |
Identificatie van de zorgverlener |
(Per…nNL) |
hl7:healthCareChoice
|
|
0 … 1 |
|
|
(Per…nNL) |
hl7:healthCareProviderPerson
|
|
1 … 1 |
M |
|
(Per…nNL) |
@classCode
|
|
0 … 1 |
F |
PSN |
|
De zorgverlener is een persoon. |
@determinerCode
|
|
0 … 1 |
F |
INSTANCE |
|
Het betreft een specifieke zorgverlener (individu). |
Inclusie |
1 … * |
R |
van 2.16.840.1.113883.2.4.3.11.60.101.10.1 Naam persoon (2014‑11‑06)
|
hl7:name
|
PN |
1 … * |
R |
|
(Per…nNL) |
@use
|
set_cs |
0 … 1 |
|
In principe kan van elke Person Name worden aangegeven in welke situatie deze gebruikt
kan worden. Voor Nederland is besloten dat de volgende naamgebruikstypen voor kunnen
komen
|
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
|
|
Gekoppeld aan concepten:
|
Keuze |
0 … * |
|
Merk op dat de volgorde van de elementen, die elk meerdere malen mogen voorkomen,
de volgorde voor weergave bepaalt.
Elementen om uit te kiezen:
- hl7:given
- hl7:prefix
- hl7:family
- hl7:suffix
- hl7:delimiter
|
|
Constraint |
Het is niet toegestaan om lege naamdelen mee te geven. Om aan te geven dat een naamdeel
leeg is dient het simpelweg niet te worden gebruikt.
|
hl7:given
|
ENXP |
|
|
Bevat voorletter(s), roepnamen of voorna(a)m(en) van de persoon. Het attribuut qualifier
bepaalt wat het is.
|
(Per…nNL) |
@qualifier
|
set_cs |
0 … 1 |
|
|
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
hl7:prefix
|
ENXP |
|
|
Bevat het voorvoegsel van de geslachtsnaam of geslachtsnaam partner met de qualifier
'VV' (voorvoegsel), en/of de adellijke titel met qualifier 'NB'. Merk op dat de volgorde
van de XML tags in het bericht van belang is: de voorvoegsels dienen altijd vóór de
bijbehorende family name gecommuniceerd te worden. Merk op dat een voorvoegsel eindigt
met een spatie indien het type voorvoegsel dit vereist (wel bij "de " en "van ", maar
niet bij "l‘".) Eventuele adellijke titels/predikaten worden, voorzien van de qualifier
NB, voor de geslachtsnaam opgenomen.
|
(Per…nNL) |
@qualifier
|
set_cs |
0 … 1 |
|
|
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
hl7:family
|
ENXP |
|
|
Bevat de geslachtsnaam of geslachtsnaam partner. Het attribuut qualifier bepaalt wat
het is.
|
(Per…nNL) |
@qualifier
|
set_cs |
0 … 1 |
|
|
|
CONF |
|
|
|
Gekoppeld aan concepten:
|
hl7:suffix
|
ENXP |
|
|
Een suffix heeft betrekking op een deel van de naam dat hoort bij één of meer andere
naamdelen en daar achter wordt geschreven. In Nederland zijn als achtervoegsel alleen
academische titels toegestaan. Enkele regels voor person name parts van type suffix:
- Een suffix moet altijd direct achter de naamdelen worden geplaatst waar het betrekking
op heeft (d.w.z. waar het normaal gesproken wordt geschreven).
- Er is geen impliciete spatie als tussenruimte met het eraan voorafgaande name part,
d.w.z. een spatie voor het achtervoegsel moet expliciet worden vermeld!
- De aard van het achtervoegsel kan verder worden aangeduid door het optionele attribuut
qualifier te gebruiken.
Een person name part van type suffix dat zonder qualifier wordt gebruikt, moet worden
beschouwd als een niet nader bepaald achtervoegsel. Ook het gebruik van (vaak Amerikaanse)
termen als ' Jr.', ' Sr.' of ' III' valt in deze categorie.
Er is geen regel voor het aantal achtervoegsels dat wordt gecombineerd in één element.
D.w.z. dat " MSc" en " MD" apart kunnen worden doorgegeven, maar ook gecombineerd
als " MSc MD".
|
(Per…nNL) |
@qualifier
|
set_cs |
0 … 1 |
|
|
|
CONF |
|
hl7:delimiter
|
ENXP |
|
|
Een delimiter heeft geen speciale betekenis als onderdeel van een Person Name, anders
dan het doorgeven van een (stukje) letterlijke tekst dat in de geschreven naam voorkomt.
Een delimiter moet altijd op de plaats in de Person Name staan waar de tekst ook geschreven
zou worden. Er zijn geen impliciete spaties, dus als er normaal gesproken een spatie
voor of achter geschreven wordt, dan moet deze expliciet worden meegegeven.
Voorbeelden van delimiters zijn:
- Het streepje '-' tussen de eigen achternaam en de partnernaam (of andersom).
- De komma plus spatie ', ' die tussen de naam en bepaalde achtervoegsels komt.
- De tekst ', geb. ' of ', e.v. ' die soms gebruikt wordt bij eigen- respectievelijk
partnernaam.
Merk op: de spatie tussen een voorvoegsel en de achternaam is geen delimiter, het
behoort bij het voorvoegsel. Dit geldt tevens voor andere scheidingstekens behorende
bij een voorvoegsel zoals in de naam "D'Artagnan".
|
(Per…nNL) |
hl7:validTime
|
IVL_TS |
0 … 1 |
|
Dit is een optioneel XML-element binnen de Person Name en duidt de periode aan waarin
deze naam 'in gebruik'/geldig was voor de betreffende persoon. De opties zijn:
- Er is geen validTime element: de betreffende naam is in principe onbeperkt geldig.
- Er is een onder- en een bovengrens: de naam was geldig in de aangeduide periode.
- Er is alleen een ondergrens: de naam is geldig sinds de aangeduide datum.
- Er is alleen een bovengrens: de naam was geldig t/m de aangeduide datum.
Dit element van Person Name kan worden gebruikt om aan te geven dat een persoon gedurende
diens leven één of meer keer van naam veranderd is. Dit gebeurt o.a. bij:
- Adoptie van een baby, waarbij het de achternaam van de adoptieouders verkrijgt.
- Huwelijk, waarbij de partnernaam kan worden toegevoegd aan de eigen naam.
- Scheiding, waarbij een eerder aangenomen partnernaam juist weer vervalt.
- Personen die om andere redenen hun voor- of achternaam veranderen.
Merk op dat veel patiëntregistratiesystemen niet echt een historie (met ingangsdatum)
bijhouden van de patiëntnaam. Wel wordt vaak een 'audit trail' (wijzigingshistorie)
van de patiëntgegevens in het algemeen bijgehouden. Indien gewenst zou daaruit een
historie van de persoonsnaam kunnen worden afgeleid, hoewel het natuurlijk ook mogelijk
is om alleen de actuele naam door te geven (en dus geen validTime te gebruiken).
|
(Per…nNL) |
|
Constraint |
In elke situatie waar één of meer persoonsnamen worden doorgegeven, moet minimaal
de naam worden aangeduid die op het moment van verzenden geldig/actueel is. Vervallen
namen kunnen dus alleen worden doorgegeven als het betreffende berichtelement herhalend
is (dus met cardinaliteit > 1). In tegenstelling tot de situatie bij organisatienamen
is het bij persoonsnamen niet toegestaan dat de ondergrens of de bovengrens van een
validTime in de toekomst ligt. Er kan dus geen 'geplande' nieuwe naam of het 'gepland
vervallen' van de huidige naam worden doorgegeven voor persoonsnamen.
|