Template

Show index

Template Building Block Organizer NL 2017‑06‑02

Id2.16.840.1.113883.2.4.3.11.60.3.10.0
ref
zib2017bbr-
Effective Date2017‑06‑02
Statuspending Under pre-publication reviewVersion Label
NameBuildingBlockOrganizerDisplay NameBuilding Block Organizer NL
Description
nl-NL Template voor een organizer element dat dient als lijstelement voor een of meer bouwstenen van 1 type. Uit efficiëntie zijn bepaalde elementen beschikbaar gemaakt op lijstniveau in plaats van op iedere bouwsteen afzonderlijk. Dit betreft de patiënt (verplicht) en verder de optioneel een auteur, een informant, de beheerder (custodian), verantwoordelijke en overige partijen (participant)
en-US Template for an organizer element that servers as a list element for one or more building blocks of 1 type. Certain contained elements have been made available as list level for efficiency reasons, instead of repeating them in every building block. This concerns the patient (required), an optional author, informant, custodian, reponsible party and other parties (through participant)
ContextPathname //
ClassificationCDA Entry Level Template
Open/ClosedOpen (other than defined elements are allowed)
Used by / Uses
Used by 0 transactions and 0 templates, Uses 4 templates
Uses as NameVersion
2.16.840.1.113883.2.4.3.11.60.3.10.1Includeactive CDA recordTarget SDTC NL2018‑06‑11
2.16.840.1.113883.2.4.3.11.60.3.10.10Containmentdraft CDA Participant (Body) SDTC2017‑06‑02
2.16.840.1.113883.2.4.3.11.60.3.10.11Containmentdraft CDA Author (Body) SDTC2017‑06‑02
2.16.840.1.113883.2.4.3.11.60.3.10.12Containmentdraft CDA Informant (Body) SDTC2017‑06‑02
ItemDTCardConfDescriptionLabel
hl7:organizer
nl-NL De organizer is een generiek lijstelement met daarin nul of meer bouwstenen van 1 type
en-US The organizer is a generic list element containing zero to many building blocks of one type
Buildotsizer
@classCode
cs1 … 1FCLUSTER
@moodCode
cs1 … 1FEVN
hl7:templateId
II1 … *Mnl-NL Template ID voor de template die de organizer voor een bepaalde bouwsteen beschrijft
en-US Template ID for the template describing the organizer for a particular building block
Buildotsizer
@root
uid1 … 1R
hl7:code
CD1 … 1Mnl-NL Lijst type. Gebruik een LOINC code indien mogelijk.
en-US Type of list. Use a LOINC code if possible.
Buildotsizer
hl7:statusCode
CS1 … 1MBuildotsizer
@code
CONF1 … 1Fcompleted
Included1 … 1M from 2.16.840.1.113883.2.4.3.11.60.3.10.1 CDA recordTarget SDTC NL (2018‑06‑11)
nl-NL Patiëntgegevens waarop de bouwstenen betrekking hebben
en-US Patient data for the patient that these building block pertain to
hl7:recordTarget
1 … 1MCDArdotsC‑NL
hl7:patientRole
1 … 1RCDArdotsC‑NL
hl7:id
II1 … *Rnl-NL Patiëntidentificatie. In de meeste gevallen zal dit een Burgerservicenummer zijn (@root = 2.16.840.1.113883.2.4.6.3). Burgerservicenummers mogen alleen worden doorgegeven als deze zijn geverifieerd of verkregen uit een betrouwbare bron - Zie de Wet Bsn-z voor details. In sommige scenario's kunnen ook andere identificaties worden gebruikt, of kan een identificatie ontbreken (acute zorg als identificatie niet geverifieerd kan worden, volksgezondheid als identificatie gemaskeerd moet worden, etc.). In die gevallen is een zo relevant mogelijke reden voor ontbreken via @nullFlavor verplicht
en-US Patient Identification. In most cases this will be a Dutch national patient identifier or Burgerservicenummer (@root = 2.16.840.1.113883.2.4.6.3). Burgerservicenummers may only be communicated if they have been verified or acquired through a trusted third party - See the Wet Bsn-z for details. In some scenarios other identifications may be applicable, or identification may be missing (acute care when identification is unobtainable/unverifiable, public health if identification must be masked, etc.). An as relevant as possible reason for missing identification through @nullFlavor is required in such scenarios
CDArdotsC‑NL
@root
uid0 … 1 nl-NL Identificatie van het systeem waaruit de waarde @extension komt. Voor burgerservicenummers is dat '2.16.840.1.113883.2.4.6.3'.
en-US Identification of the system for the value in @extension. For burgerservicenummers this is '2.16.840.1.113883.2.4.6.3'.
@extension
st0 … 1 nl-NL Identificatienummer of -string, bijvoorbeeld het burgerservicenummer
en-US Identification number or string, e.g. the burgerservicenummer
@nullFlavor
cs0 … 1 nl-NL De meest algemene reden voor afwezigheid is "NI" (No Information). Meer voor de hand liggen echter "UNK" (onbekend wat het is, maar bekend dat het er is) en "MSK" (gemaskeerd)
en-US The most generic reason for absence is "NI" (No Information). More common are "UNK" (unknown what it is, but known to have it) and "MSK" (masked)
 Example
Burgerservicenummer
<id extension="100197243" root="2.16.840.1.113883.2.4.6.3"/>
 Example
Identificatie (nog) niet bekend
<id nullFlavor="UNK"/>
 Example
Identificatie gemaskeerd
<id nullFlavor="MSK"/>
hl7:addr
AD.NL0 … *RCDArdotsC‑NL
Included from 2.16.840.1.113883.2.4.3.11.60.3.10.1.101 address NL - generic (2018‑06‑11)
@use
set_cs0 … 1 
 CONF
The value of @use shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.20.5.3 (2017‑12‑31)
hl7:streetName
ST0 … 1Rnl-NL Straatnaam. Als het adres een postbusnummer is dan dient hier het woord “Postbus” te staan. Als het adres een antwoordnummer is, dan dient hier het woord “Antwoordnummer” te staan.
en-US Street name. If the address is a P.O. Box then the Dutch word "Postbus" shall be communicated. If the address is an answer number (mailing address where the receiver pays postage) then the Dutch word "Antwoordnummer" shall be communicated.
AD.NL
 Example<streetName>Heereweg</streetName>
hl7:houseNumber
ST0 … 1Rnl-NL Het element houseNumber moet het huisnummer bevatten. Het huisnummer kan niet-numerieke gedeelten bevatten die het adres mede identificeren, bijv. "23a", maar alleen als de bron deze niet gescheiden kan aanbieden. Huisletter dient indien mogelijk in het element buildingNumberSuffix te worden doorgegeven. Gegevens zoals "to" (woonboten) of "3 hoog achter" maken geen deel uit van dit attribuut. Dit type gegevens is elders in het AD datatype opgenomen.
en-US The element houseNumber shall contain the house number. The house number may contains non-numeric parts that further determine the address, e.g. "23a", but only if the source system cannot discretely communicate those. House letter shall, if possible, be communicated through the element buildingNumberSuffix. Information such as "to" (house boats that do not have their own house number, but are across (tegenover) a house with a house number or "3 hoog achter" are not part of this attribute. This type of information is conveyed elsewhere in the AD datatype.
AD.NL
 Example<houseNumber>13</houseNumber>
hl7:buildingNumberSuffix
ST0 … 1Rnl-NL Het element buildingNumberSuffix bevat, indien aanwezig, huisletter en/of huisnummertoevoeging. Het element houseNumber kan dan alleen het numerieke huisnummer bevatten.

Export

  • Als er zowel een huisletter als een huisnummertoevoeging bekend is, dan komt de huisletter eerst, dan een spatie en tenslotte de huisnummertoevoeging.
  • Als er alleen een huisletter bekend is, wordt deze in de buildingNumberSuffix doorgegeven. Er hoeft geen spatie achter.
  • Als er alleen een huisnummertoevoeging bekend is, wordt deze in de buildingNumberSuffix doorgegeven met een spatie ervoor ter indicatie van een lege huisletter

Import

  • Als buildingNumberSuffix geen spatie bevat, dan geldt de gehele waarde als huisletter.
  • Als buildingNumberSuffix wel een spatie bevat, dan wordt het gedeelte voor de eerste spatie als huisletter geïmporteerd, en het gedeelte na de eerste spatie (de rest) als huisnummertoevoeging.

en-US The element buildingNumberSuffix contains, if relevant, house letter and/or house number suffix. The element houseNumber shall in that case only contain the house number.

Export

  • If a house letter as well as a house number addition is known: house letter first, followed by a space and finally the house letter suffix.
  • If only a house letter is known send just that. No trailing space is required.
  • If only a house letter suffix is known, communicate that with a leading space.

Import

  • If the value of buildingNumberSuffix contains no space, then the whole value is considered to be the house letter
  • If the value of buildingNumberSuffix contains a space, then everything before the first space is considered to be the house letter, and the everything trailing the first space is considered to be the house number suffix
AD.NL
 Example
Huisletter B
<buildingNumberSuffix>B</buildingNumberSuffix>
 Example
Huisnummertoevoeging rood
<buildingNumberSuffix> rood</buildingNumberSuffix>
 Example
Huisletter B, Huisnummertoevoeging rood
<buildingNumberSuffix>B rood</buildingNumberSuffix>
hl7:additionalLocator
ST0 … 1Rnl-NL Aanvullende locatieaanduidingen aanvullend op het postadres. Kan de waarden 'to' (tegenover) of 'by' (bij) zijn.
en-US Additional location indicator for the (postal) address. May contains values 'to' (opposite) or 'by' (near).
AD.NL
 CONF
element content shall be "to"
-or-
element content shall be "by"
hl7:postalCode
ADXP0 … 1Rnl-NL Postcode van het adres. Indien dit een Nederlandse postcode is, dan is het formaat 'nnnn AA' (met spatie). Het is mogelijk om Nederlandse postcodes te coderen volgens NEN5825 (OID 2.16.840.1.113883.2.4.4.15). Let op dat in dit codestelsel Nederlandse postcodes zonder spaties worden gehanteerd.
en-US Zip or postal code of the address. If this is a Dutch postal code, then it shall have the format 'nnnn AA' (including the space). It is possible to code Dutch postal codes using the norm NEN5825 (OID 2.16.840.1.113883.2.4.4.15). Please mind that postal codes in that system do NOT have any spaces.
AD.NL
@code
0 … 1 nl-NL Gecodeerde postcode. Formaat Nederlandse postcodes volgens NEN5825 is 'nnnnAA'
en-US Coded postal code. Format of Dutch postal codes compliant with NEN5825 is 'nnnnAA'
@codeSystem
0 … 1 nl-NL Codesysteem voor gecodeerde postcodes. Voor Nederlandse postcodes is dit NEN5825 OID: 2.16.840.1.113883.2.4.4.15
en-US Code system for coded postal codes. For Dutch postal codes compliant with NEN5825 OID: 2.16.840.1.113883.2.4.4.15
hl7:county
ADXP0 … 1Rnl-NL Relevant voor personen. In Nederland wordt dit element gebruikt om de gemeente van inschrijving door te geven (in andere landen kan een ander type administratieve eenheid binnen een staat/provincie gebruikt worden). De gemeente kan, maar hoeft niet, overeen te komen met de stad. Sommige gemeenten, bijvoorbeeld "Waterland", hebben een naam die geheel afwijkt van de steden die erin gelegen zijn. In het HL7-berichtenverkeer wordt de gemeente in Nederland alleen gebruikt in het kader van wettelijke identificatie van personen. Het datatype van county is coded string (SC). Als de gemeente gecodeerd wordt, dan dient Basisregistratie Personen (BRP)/ Gemeentelijke basisadministratie (GBA) tabel 33 (OID 2.16.840.1.113883.2.4.6.14) gebruikt te worden. Code 0000 zoals aanwezig in de GBA Tabel 33 mag onder geen enkele omstandigheid voorkomen in een HL7 versie 3 bericht. Het equivalent van 0000 (onbekende gemeente) in HL7 versie 3 is het niet-opnemen van een code.
en-US Relevant for persons. This element is in use in The Nederlands to communicate municipality/county where the person is registered (in other countries this might be in use for a different type of administrative unit within a state/province). The county may, but does not have to, be different from the city. Some counties like "Waterland", span multiple cities. In HL7 messaging we only use county in the Netherlands for legal identification of persons. The datatype of county is coded string (SC). If a county is coded, it shall be based on Basisregistratie Personen (BRP)/ Gemeentelijke basisadministratie (GBA) tabel 33 (OID 2.16.840.1.113883.2.4.6.14). Code 0000 as present in this table shall not be used. The equivalent of 0000 (unknown county) in HL7 V3 is to not add a code.
AD.NL
hl7:city
ST0 … 1Rnl-NL Plaats
en-US City
AD.NL
hl7:country
ADXP0 … 1Rnl-NL Land volgens Basisregistratie Personen (BRP)/ Gemeentelijke basisadministratie (GBA) tabel 34 Landen (2.16.840.1.113883.2.4.4.16.34) of ISO 3166‐2 alpha (1.0.3166.1.2.2). De landnaam in de text() node is verplicht als het element country wordt gebruikt, maar coderen van het land is niet verplicht.
en-US Country coded using Basisregistratie Personen (BRP)/ Gemeentelijke basisadministratie (GBA) tabel 34 Landen (2.16.840.1.113883.2.4.4.16.34) or ISO 3166‐2 alpha (1.0.3166.1.2.2). The country name goes into the text() node and is required if element country is being used, but it is not required to code this element.
AD.NL
@code
0 … 1 nl-NL Gecodeerd land.
en-US Coded country.
@codeSystem
0 … 1 nl-NL Codesysteem voor gecodeerd land.
en-US Code system for a coded country.
 Example
BRP/GBA Tabel 34 Landen
<country code="6030" codeSystem="2.16.840.1.113883.2.4.4.16.34">Nederland</country>
 Example
ISO 3166-2 alpha
<country code="NL" codeSystem="1.0.3166.1.2.2">Nederland</country>
hl7:unitID
ST0 … 1nl-NL Een geheel of gedeeltelijke beschrijving van de ligging van een object indien dit niet kan worden aangegeven met de andere adresaanduidingen. NB: het Nederlandse datatype AD versie 1 heeft ook een element <desc/> wat in aanmerking zou kunen komen voor dit type informatie, maar gebruik daarvan wordt niet geadviseerd omdat dit gebruik met CDA zou schaden. In CDA zou het wel als extensie kunnen worden gebruikt. Het internationale datatype AD voorziet niet in een element dat direct geschikt is voor Locatieomschrijving zoals hier bedoeld en dit element moet dan ook als een vorm van misbruik van een niet-gebruikt veld worden gezien.
en-US A full or partial description of the location of an object if there's no way to convey that using other address parts. NOTE: The Dutch Datatypes Release 1 includes an element <desc/> that could be used for this type of information, but use of that is ill advised as this would conflict with base CDA usage. In CDA we could add that as an extension. The international datatype AD does not support an element that is intended for conveying Location description as is meant here, and use of the element unitID therefor be a form of misuse of an otherwise unused address component.
AD.NL
hl7:useablePeriod
IVL_TS0 … 1nl-NL Het element useablePeriod duidt de periode aan waarin dit adres 'in gebruik'/geldig is/was. De opties zijn:
  • Er is geen useablePeriod element: het betreffende adres is in principe onbeperkt geldig.
  • Er is een onder- en een bovengrens: het adres was geldig in de aangeduide periode.
  • Er is alleen een ondergrens: het adres is geldig sinds de aangeduide datum.
  • Er is alleen een bovengrens: het adres was geldig t/m de aangeduide datum.

en-US The element useablePeriod contains the period for which this address is/was 'in use'/valid. The options are:
  • There is no useablePeriod element: the address is considered valid until specified otherwise.
  • There is a lower and upper boundary: the address was valid in the given period.
  • There's only a lower boundary: the address has been valid since the given date.
  • There's only an upper boundary: the address was valid until the given date.
AD.NL
 Constraintnl-NL In elke situatie waar één of meer adressen worden doorgegeven, moet minimaal het adres worden aangeduid dat op het moment van verzenden geldig/actueel is. Vervallen adressen kunnen dus alleen worden doorgegeven als het betreffende berichtelement herhalend is (dus met cardinaliteit > 1). Adressen mogen ook in de toekomst geldig worden of vervallen als bijvoorbeeld verhuizing reeds bekend is.
hl7:telecom
TEL.NL.EXTENDED0 … *CDArdotsC‑NL
where [starts-with(@value,'tel:')]
Included from 2.16.840.1.113883.2.4.3.11.60.3.10.1.103 phone number - generic (2018‑06‑11)
@use
set_cs0 … 1 nl-NL Dit attribuut is een spatie gescheiden lijst van kenmerken. Het kan twee van de kenmerken uit het zib element TelecomType bevatten (MC or PG) en een of meer van de kenmerken uit het element NummerSoort.
en-US This attribute is a space separated list of properties. It may cover two of the properties from the hcim element TelecomType bevatten (MC or PG) and one or more of the properties from the element NumberType.
 CONF
The value of @use shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.20.6.2 (2017‑12‑31)
or
@use shall be "MC"
or
@use shall be "PG"
@value
url1 … 1Rnl-NL Telefoonnummers bestaan uit een uri beginnend met tel:. Faxnummers bestaan uit een uri beginnend fax:. Let op: een uri bevat bijvoorbeeld geen spaties.
en-US Phone numbers consist of a uri starting with tel:. Fax numbers consist of a uri starting with fax:. Note: a uri does not contain whitespace among other things.
hl7:telecom
TEL.NL.EXTENDED0 … *CDArdotsC‑NL
where [starts-with(@value,'mailto:')]
Included from 2.16.840.1.113883.2.4.3.11.60.3.10.1.104 email address - generic (2018‑06‑11)
@use
set_cs0 … 1 
 CONF
The value of @use shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.20.6.3 (2017‑12‑31)
@value
url1 … 1Rnl-NL E-mailadressen bestaan uit een uri beginnend met mailto:. Let op: een uri bevat bijvoorbeeld geen spaties.
en-US Email addresses consist of a uri starting with mailto:. Note: a uri does not contain whitespace among other things.
hl7:patient
0 … 1CDArdotsC‑NL
hl7:name
PN.NL1 … *RCDArdotsC‑NL
Included from 2.16.840.1.113883.2.4.3.11.60.3.10.1.100 name person NL - generic (2018‑06‑11)
@use
set_cs0 … 1 nl-NL 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:
  • L - Reguliere naam. De naam zoals die door de persoon (entiteit) gevoerd wordt. De afkorting 'L' stond oorspronkelijk voor Legal (wettelijk), maar feit is dat hier ook componenten in voor mogen komen (zoals een roepnaam), die niet wettelijk zijn vastgelegd. Dit naamgebruikstype is het standaardtype als geen type wordt doorgegeven.
  • A - Pseudoniem. Een artiestennaam, 'schuilnaam' of tijdelijke naam voor een persoon (entiteit). Deze wijkt dus af van de regulier gevoerde naam en wordt bijvoorbeeld gebruikt om iemands identiteit te verbergen (in verband met privacy) of als tijdelijke naam wanneer de echte niet bekend is ('John Doe').
  • OR - Wettelijk geregistreerde naam. De naam met de exacte componenten zoals deze voorkomen in het bevolkingsregister van het betreffende land. Voor Nederland is dit het Gemeentelijke Basisadministratie (GBA) of Basisregistratie Personen (BRP) of Register niet-ingezetenen (RNI). Dit is de naam zoals die wordt geretourneerd indien een BSN met succes wordt geverifieerd.

en-US In principal it is possible to communicate use of every Person name. In The Netherlands we constrained the full set to the following options:
  • L - Regular name. Name the person (entity) habitually goes by. Originally the use code 'L' stood for Legal (officially registered), but this name could also be used to convey components like callme name that are not covered in any officially registered name. The name use code 'L' is to be assumed is no use code is communicated.
  • A - Pseudonym. A stage name, 'undercover name' or temporarily assigned name for a person (entity). This name would be different from the regular name and is used to hide someone identity (for privacy reasons) or as a temptorary measure when the real name is unknown ('John Doe').
  • OR - Legally registered name. The name with the exact components as registered in the national person registry of the relevant country for that person. In The Netherlands this is the Gemeentelijke Basisadministratie (GBA) or Basisregistratie Personen (BRP) or Register niet-ingezetenen (RNI). This name is the name as returned by that registry, e.g. when his Burgerserivcenummer (BSN) is successfully verified.
 CONF
@use shall be "L"
or
@use shall be "A"
or
@use shall be "OR"
Choice0 … *
nl-NL Minimaal één van de elementen voornaam, roepnaam of initialen en minimaal een geslachtsnaam of geslachtsnaam partner, eventueel met voorvoegsels moet aanwezig zijn.
en-US At mininum one of the components given name, callme name or initials and at minimum the own surname or partner surname, possibly with prefixes/voorvoegsels, shall be present.
Elements to choose from:
  • hl7:prefix[@qualifier='NB']
  • hl7:given[@qualifier='BR']
  • hl7:given[@qualifier='CL']
  • hl7:given[@qualifier='IN']
  • hl7:given[not(@qualifier)]
  • hl7:prefix[.[not(@qualifier)] | .[tokenize(@qualifier,'\s')='VV'][not(tokenize(@qualifier,'\s')=('BR', 'SP'))][following-sibling::hl7:family[1][not(tokenize(@qualifier,'\s')=('BR', 'SP'))]]]
  • hl7:family[not(tokenize(@qualifier,'\s')=('BR', 'SP'))]
  • hl7:prefix[tokenize(@qualifier,'\s')='VV'][following-sibling::hl7:family[1][@qualifier='BR']]
  • hl7:family[@qualifier='BR']
  • hl7:delimiter
  • hl7:prefix[tokenize(@qualifier,'\s')='VV'][following-sibling::hl7:family[1][@qualifier='SP']]
  • hl7:family[@qualifier='SP']
  • hl7:suffix
hl7:prefix
ENXP0 … 1nl-NL Adellijke titel. Een titel (meestal voluit geschreven) die is ontleend aan iemands aristocratische status. Voorbeelden zijn "Jonkheer ", "Graaf ", etc. Noot 1: zie ook GBA Tabel 38 Adellijke titel/predicaat. Noot 2: Adellijke titels spelen normaal geen rol van betekenis in de zorg en ondersteuning hiervoor kan variëren van systeem tot systeem. De zorginformatiebouwstenen tot in elk geval release 2020 bieden geen handvat voor adellijke titels.
en-US Nobility title. A title (usually written in full) derived from someone's artistocratic status. Examples include "Jonkheer ", "Graaf ", etc. Noot 1: see also GBA Table 38 Adellijke titel/predicaat. Note 2: Nobility titles are not regularly a part of healthcare and support may vary from system to system. The Dutch clinical information models or zibs at least until version 2020 do not support nobility titles.
PN.NL
where [@qualifier='NB']
@qualifier
set_cs1 … 1FNB
@nullFlavor
cs0NPNP/not present
 Example<prefix qualifier="NB">Jonkheer </prefix>
hl7:given
ENXP0 … 1Rnl-NL Bevat de voornamen van een persoon. De qualifier 'BR' duidt een officiële voornaam aan
en-US Contains given names of a person. The qualifier 'BR' indicates an officially registered given name
PN.NL
where [@qualifier='BR']
@qualifier
set_cs1 … 1FBR
@nullFlavor
cs0NPNP/not present
 Example<given qualifier="BR">Maria</given>
hl7:given
ENXP0 … 1Rnl-NL Bevat de roepnaam van een persoon. De qualifier 'CL' duidt een roepnaam aan
en-US Contains callme name of a person. The qualifier 'CL' indicates a callme name
PN.NL
where [@qualifier='CL']
@qualifier
set_cs1 … 1FCL
@nullFlavor
cs0NPNP/not present
 Example<given qualifier="CL">Ria</given>
hl7:given
ENXP0 … 1Rnl-NL Bevat de voorletters van een persoon. Een afsluitende punt moet expliciet worden vermeld. De qualifier heeft de waarde "IN" voor de initialen
en-US Contains the initials of a person. A closing dot shall be used for every initial. The qualifier "IN" indicates initials
PN.NL
where [@qualifier='IN']
@qualifier
set_cs1 … 1FIN
@nullFlavor
cs0NPNP/not present
 Example<given qualifier="IN">M.</given>
hl7:given
ENXP0 … 1nl-NL Voornaamdeel van ongedefinieerd type. Bij voorkeur alleen met type gebruiken.
en-US Given name component of an undefined type. Preferably only use qualified given names.
PN.NL
where [not(@qualifier)]
hl7:prefix
ENXP0 … 1Rnl-NL Prefixdeel van ongedefinieerd type, of van alleen type voorvoegsel (VV) gevolgd door een achternaam zonder type BR (geboortenaam) of SP (partnernaam). Als van een achternaamdeel het type BR of SP te duiden is, dan zou dat bij het voorvoegsel ook moeten kunnen. Element prefix bij voorkeur alleen met volledig type gebruiken.
en-US Prefix component of an undefined type, or just of type voorvoegsel (VV) followed by a surname without a qualifier BR (birth name) or SP (partner name). If the last name part type qualifier BR or SP is known then this should also be possible on the prefix of type voorvoegsel. Element prefix is preferably only used with fully specified qualifier.
PN.NL
where [. [not(@qualifier)] or
[tokenize(@qualifier,'\s')='VV'] [not(tokenize(@qualifier,'\s')=('BR', 'SP'))] [following-sibling::hl7:family [1] [not(tokenize(@qualifier,'\s')=('BR', 'SP'))]]]
hl7:family
ENXP0 … 1Rnl-NL Achternaamdeel van ongedefinieerd type dus zonder BR of SP. Bij voorkeur alleen met type gebruiken.
en-US Surname component of an undefined type hence without BR or SP. Preferably only use qualified family names.
PN.NL
where [not(tokenize(@qualifier,'\s')=('BR', 'SP'))]
hl7:prefix
ENXP0 … 1Rnl-NL Bevat voorvoegsels van de geslachtsnaam en moet direct voorafgaand aan de geslachtsnaam in family staan
en-US Contains prefixes/voorvoegsels of the own surname and shall be precede the own surname in the family element
PN.NL
where [tokenize(@qualifier,'\s')='VV'] [following-sibling::hl7:family [1] [@qualifier='BR']]
@qualifier
set_cs1 … 1Rnl-NL Waarde "VV", "VV BR" of "BR VV".
en-US Value "VV", "VV BR" or "BR VV".
@nullFlavor
cs0NPNP/not present
 Example<prefix qualifier="VV">van der </prefix>
hl7:family
ENXP0 … 1Rnl-NL Bevat de geslachtsnaam van een persoon. Het qualifier 'BR' duidt een geslachtsnaam aan
en-US Contains own surname of a person. The qualifier 'BR' indicates the own surname
PN.NL
where [@qualifier='BR']
@qualifier
cs1 … 1FBR
@nullFlavor
cs0NPNP/not present
 Example<family qualifier="BR">Lelie</family>
hl7:delimiter
ENXP0 … 1nl-NL 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".

en-US A delimiter has no special meaning as part of a Person Name, other than communicating a piece of literal text that is part of a written name. A delimiter shall occur in the place it would be written down in a Person Name. There are no implicit spaces, so if a preceding or trailing space is relevant it shall be communicated explicit. Examples of delimiters are:
  • The hyphen '-' between own surname and partner surname (or vice versa).
  • The comma plus space ', ' between name and certain suffixes.
  • The text ', geb. ' or ', e.v. ' that is occasionally used for oiwn surname and/or partner surname.
Note: the space between a prefix/voorvoegsel and the surname is not a delimiter, it is part of the prefix/voorvoegsel. This also goes for other delimiters that are part of the prefix/voorvoegsel like the apostrophe in the name "D'Artagnan".
PN.NL
@nullFlavor
cs0NPNP/not present
hl7:prefix
ENXP0 … 1Rnl-NL Bevat voorvoegsels van de geslachtsnaam van partner en moet direct voorafgaand aan de geslachtsnaam partner in family staan
en-US Contains prefixes/voorvoegsels of the partnername surname and shall be precede the partner surname in the family element
PN.NL
where [tokenize(@qualifier,'\s')='VV'] [following-sibling::hl7:family [1] [@qualifier='SP']]
@qualifier
set_cs1 … 1Rnl-NL Waarde "VV", "VV SP" of "SP VV".
en-US Value "VV", "VV SP" or "SP VV".
@nullFlavor
cs0NPNP/not present
 Example<prefix qualifier="VV">van </prefix>
hl7:family
ENXP0 … 1Rnl-NL Bevat de geslachtsnaam partner van een persoon. Het qualifier type 'SP' duidt een geslachtsnaam partner aan
en-US Contains partnername surname of a person. The qualifier 'SP' indicates the partner surname
PN.NL
where [@qualifier='SP']
@qualifier
cs1 … 1FSP
@nullFlavor
cs0NPNP/not present
 Example<family qualifier="SP">Putten</family>
hl7:suffix
ENXP0 … *nl-NL 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".


en-US A suffix always applies to a part of the name that belongs to one or more other name parts and should follow those. In The Netherlands only academic titles are allowed as suffix. Some rules for person name parts of type suffix:
  • A suffix shall always follow the name parts that it pertains to (i.e. where you would usually write it).
  • There's no implicit space to separate it from the preceding name part, so any required spaces shall be part of the suffix value!
  • The suffix type may be communicated using the qualifier attribute.

A person name part of type suffix without a qualifier, is a suffix not otherwise specified. The use of (usually American) terms as ' Jr.', ' Sr.' or ' III' are in this category.

There's no rule for the number of suffixes in one component. I.e. " MSc" and " MD" may be communicated separately, but may also be combined as " MSc MD".

PN.NL
@qualifier
cs0 … 1FAC
@nullFlavor
cs0NPNP/not present
hl7:validTime
IVL_TS0 … 1nl-NL 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).

en-US This is an optional part within Person Nameand signals the period of validity for the name. The options are:
  • There is no validTime element: the name is considered valid until specified otherwise.
  • There is a lower and upper boundary: the name was valid in the given period.
  • There's only a lower boundary: the name has been valid since the given date.
  • There's only an upper boundary: the name was valid until the given date.
This element of Person Name may be used to indicate the person has changed his name at least once in his life. This may occur in the following cases:
  • Adoption of a baby, where the baby assumes the adoption parents' last name.
  • Marriage, where a partner surname may be added a persons own surname or replace it.
  • Divorce, where a previously assumed partner surname may be replace by the own surname again.
  • Personen who change their given or last names for other reasons.
Note that many patient administrations do not really keep a history (with start date) of a patient name. In general an audit trail is kept of change in the patient data. This may or not may not be used to deduce the history of a person name, but it usually suffices to communicate just the current/relevant name (and thus not use the validTime element).
PN.NL
 Constraintnl-NL 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.
 Schematron assertrolered error 
 testnot(*) or (hl7:given and hl7:family) 
 MessageIn een gestructureerde naam moet minimaal één voornaam, initiaal of roepnaam en minimaal één geslachtsnaam of geslachtsnaam partner van een persoon aanwezig zijn, inclusief voorvoegsel(s) indien van toepassing 
hl7:administrativeGenderCode
CE1 … 1RCDArdotsC‑NL
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.0.1.1 (2017‑12‑31)
hl7:birthTime
TS1 … 1RCDArdotsC‑NL
sdtc:deceasedInd
BL0 … 1RCDArdotsC‑NL
sdtc:deceasedTime
TS0 … 1CDArdotsC‑NL
sdtc:multipleBirthInd
BL0 … 1CDArdotsC‑NL
hl7:maritalStatusCode
CE0 … 1CDArdotsC‑NL
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.7.9.1 (2017‑12‑31)
hl7:guardian
0 … *CDArdotsC‑NL
@classCode
cs0 … 1FGUARD
hl7:code
CE0 … 1CDArdotsC‑NL
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.3.1.2 (2017‑12‑31)
hl7:addr
AD.NL0 … *CDArdotsC‑NL
Included from 2.16.840.1.113883.2.4.3.11.60.3.10.1.101 address NL - generic (2018‑06‑11)
@use
set_cs0 … 1 
 CONF
The value of @use shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.20.5.3 (2017‑12‑31)
hl7:streetName
ST0 … 1Rnl-NL Straatnaam. Als het adres een postbusnummer is dan dient hier het woord “Postbus” te staan. Als het adres een antwoordnummer is, dan dient hier het woord “Antwoordnummer” te staan.
en-US Street name. If the address is a P.O. Box then the Dutch word "Postbus" shall be communicated. If the address is an answer number (mailing address where the receiver pays postage) then the Dutch word "Antwoordnummer" shall be communicated.
AD.NL
 Example<streetName>Heereweg</streetName>
hl7:houseNumber
ST0 … 1Rnl-NL Het element houseNumber moet het huisnummer bevatten. Het huisnummer kan niet-numerieke gedeelten bevatten die het adres mede identificeren, bijv. "23a", maar alleen als de bron deze niet gescheiden kan aanbieden. Huisletter dient indien mogelijk in het element buildingNumberSuffix te worden doorgegeven. Gegevens zoals "to" (woonboten) of "3 hoog achter" maken geen deel uit van dit attribuut. Dit type gegevens is elders in het AD datatype opgenomen.
en-US The element houseNumber shall contain the house number. The house number may contains non-numeric parts that further determine the address, e.g. "23a", but only if the source system cannot discretely communicate those. House letter shall, if possible, be communicated through the element buildingNumberSuffix. Information such as "to" (house boats that do not have their own house number, but are across (tegenover) a house with a house number or "3 hoog achter" are not part of this attribute. This type of information is conveyed elsewhere in the AD datatype.
AD.NL
 Example<houseNumber>13</houseNumber>
hl7:buildingNumberSuffix
ST0 … 1Rnl-NL Het element buildingNumberSuffix bevat, indien aanwezig, huisletter en/of huisnummertoevoeging. Het element houseNumber kan dan alleen het numerieke huisnummer bevatten.

Export

  • Als er zowel een huisletter als een huisnummertoevoeging bekend is, dan komt de huisletter eerst, dan een spatie en tenslotte de huisnummertoevoeging.
  • Als er alleen een huisletter bekend is, wordt deze in de buildingNumberSuffix doorgegeven. Er hoeft geen spatie achter.
  • Als er alleen een huisnummertoevoeging bekend is, wordt deze in de buildingNumberSuffix doorgegeven met een spatie ervoor ter indicatie van een lege huisletter

Import

  • Als buildingNumberSuffix geen spatie bevat, dan geldt de gehele waarde als huisletter.
  • Als buildingNumberSuffix wel een spatie bevat, dan wordt het gedeelte voor de eerste spatie als huisletter geïmporteerd, en het gedeelte na de eerste spatie (de rest) als huisnummertoevoeging.

en-US The element buildingNumberSuffix contains, if relevant, house letter and/or house number suffix. The element houseNumber shall in that case only contain the house number.

Export

  • If a house letter as well as a house number addition is known: house letter first, followed by a space and finally the house letter suffix.
  • If only a house letter is known send just that. No trailing space is required.
  • If only a house letter suffix is known, communicate that with a leading space.

Import

  • If the value of buildingNumberSuffix contains no space, then the whole value is considered to be the house letter
  • If the value of buildingNumberSuffix contains a space, then everything before the first space is considered to be the house letter, and the everything trailing the first space is considered to be the house number suffix
AD.NL
 Example
Huisletter B
<buildingNumberSuffix>B</buildingNumberSuffix>
 Example
Huisnummertoevoeging rood
<buildingNumberSuffix> rood</buildingNumberSuffix>
 Example
Huisletter B, Huisnummertoevoeging rood
<buildingNumberSuffix>B rood</buildingNumberSuffix>
hl7:additionalLocator
ST0 … 1Rnl-NL Aanvullende locatieaanduidingen aanvullend op het postadres. Kan de waarden 'to' (tegenover) of 'by' (bij) zijn.
en-US Additional location indicator for the (postal) address. May contains values 'to' (opposite) or 'by' (near).
AD.NL
 CONF
element content shall be "to"
-or-
element content shall be "by"
hl7:postalCode
ADXP0 … 1Rnl-NL Postcode van het adres. Indien dit een Nederlandse postcode is, dan is het formaat 'nnnn AA' (met spatie). Het is mogelijk om Nederlandse postcodes te coderen volgens NEN5825 (OID 2.16.840.1.113883.2.4.4.15). Let op dat in dit codestelsel Nederlandse postcodes zonder spaties worden gehanteerd.
en-US Zip or postal code of the address. If this is a Dutch postal code, then it shall have the format 'nnnn AA' (including the space). It is possible to code Dutch postal codes using the norm NEN5825 (OID 2.16.840.1.113883.2.4.4.15). Please mind that postal codes in that system do NOT have any spaces.
AD.NL
@code
0 … 1 nl-NL Gecodeerde postcode. Formaat Nederlandse postcodes volgens NEN5825 is 'nnnnAA'
en-US Coded postal code. Format of Dutch postal codes compliant with NEN5825 is 'nnnnAA'
@codeSystem
0 … 1 nl-NL Codesysteem voor gecodeerde postcodes. Voor Nederlandse postcodes is dit NEN5825 OID: 2.16.840.1.113883.2.4.4.15
en-US Code system for coded postal codes. For Dutch postal codes compliant with NEN5825 OID: 2.16.840.1.113883.2.4.4.15
hl7:county
ADXP0 … 1Rnl-NL Relevant voor personen. In Nederland wordt dit element gebruikt om de gemeente van inschrijving door te geven (in andere landen kan een ander type administratieve eenheid binnen een staat/provincie gebruikt worden). De gemeente kan, maar hoeft niet, overeen te komen met de stad. Sommige gemeenten, bijvoorbeeld "Waterland", hebben een naam die geheel afwijkt van de steden die erin gelegen zijn. In het HL7-berichtenverkeer wordt de gemeente in Nederland alleen gebruikt in het kader van wettelijke identificatie van personen. Het datatype van county is coded string (SC). Als de gemeente gecodeerd wordt, dan dient Basisregistratie Personen (BRP)/ Gemeentelijke basisadministratie (GBA) tabel 33 (OID 2.16.840.1.113883.2.4.6.14) gebruikt te worden. Code 0000 zoals aanwezig in de GBA Tabel 33 mag onder geen enkele omstandigheid voorkomen in een HL7 versie 3 bericht. Het equivalent van 0000 (onbekende gemeente) in HL7 versie 3 is het niet-opnemen van een code.
en-US Relevant for persons. This element is in use in The Nederlands to communicate municipality/county where the person is registered (in other countries this might be in use for a different type of administrative unit within a state/province). The county may, but does not have to, be different from the city. Some counties like "Waterland", span multiple cities. In HL7 messaging we only use county in the Netherlands for legal identification of persons. The datatype of county is coded string (SC). If a county is coded, it shall be based on Basisregistratie Personen (BRP)/ Gemeentelijke basisadministratie (GBA) tabel 33 (OID 2.16.840.1.113883.2.4.6.14). Code 0000 as present in this table shall not be used. The equivalent of 0000 (unknown county) in HL7 V3 is to not add a code.
AD.NL
hl7:city
ST0 … 1Rnl-NL Plaats
en-US City
AD.NL
hl7:country
ADXP0 … 1Rnl-NL Land volgens Basisregistratie Personen (BRP)/ Gemeentelijke basisadministratie (GBA) tabel 34 Landen (2.16.840.1.113883.2.4.4.16.34) of ISO 3166‐2 alpha (1.0.3166.1.2.2). De landnaam in de text() node is verplicht als het element country wordt gebruikt, maar coderen van het land is niet verplicht.
en-US Country coded using Basisregistratie Personen (BRP)/ Gemeentelijke basisadministratie (GBA) tabel 34 Landen (2.16.840.1.113883.2.4.4.16.34) or ISO 3166‐2 alpha (1.0.3166.1.2.2). The country name goes into the text() node and is required if element country is being used, but it is not required to code this element.
AD.NL
@code
0 … 1 nl-NL Gecodeerd land.
en-US Coded country.
@codeSystem
0 … 1 nl-NL Codesysteem voor gecodeerd land.
en-US Code system for a coded country.
 Example
BRP/GBA Tabel 34 Landen
<country code="6030" codeSystem="2.16.840.1.113883.2.4.4.16.34">Nederland</country>
 Example
ISO 3166-2 alpha
<country code="NL" codeSystem="1.0.3166.1.2.2">Nederland</country>
hl7:unitID
ST0 … 1nl-NL Een geheel of gedeeltelijke beschrijving van de ligging van een object indien dit niet kan worden aangegeven met de andere adresaanduidingen. NB: het Nederlandse datatype AD versie 1 heeft ook een element <desc/> wat in aanmerking zou kunen komen voor dit type informatie, maar gebruik daarvan wordt niet geadviseerd omdat dit gebruik met CDA zou schaden. In CDA zou het wel als extensie kunnen worden gebruikt. Het internationale datatype AD voorziet niet in een element dat direct geschikt is voor Locatieomschrijving zoals hier bedoeld en dit element moet dan ook als een vorm van misbruik van een niet-gebruikt veld worden gezien.
en-US A full or partial description of the location of an object if there's no way to convey that using other address parts. NOTE: The Dutch Datatypes Release 1 includes an element <desc/> that could be used for this type of information, but use of that is ill advised as this would conflict with base CDA usage. In CDA we could add that as an extension. The international datatype AD does not support an element that is intended for conveying Location description as is meant here, and use of the element unitID therefor be a form of misuse of an otherwise unused address component.
AD.NL
hl7:useablePeriod
IVL_TS0 … 1nl-NL Het element useablePeriod duidt de periode aan waarin dit adres 'in gebruik'/geldig is/was. De opties zijn:
  • Er is geen useablePeriod element: het betreffende adres is in principe onbeperkt geldig.
  • Er is een onder- en een bovengrens: het adres was geldig in de aangeduide periode.
  • Er is alleen een ondergrens: het adres is geldig sinds de aangeduide datum.
  • Er is alleen een bovengrens: het adres was geldig t/m de aangeduide datum.

en-US The element useablePeriod contains the period for which this address is/was 'in use'/valid. The options are:
  • There is no useablePeriod element: the address is considered valid until specified otherwise.
  • There is a lower and upper boundary: the address was valid in the given period.
  • There's only a lower boundary: the address has been valid since the given date.
  • There's only an upper boundary: the address was valid until the given date.
AD.NL
 Constraintnl-NL In elke situatie waar één of meer adressen worden doorgegeven, moet minimaal het adres worden aangeduid dat op het moment van verzenden geldig/actueel is. Vervallen adressen kunnen dus alleen worden doorgegeven als het betreffende berichtelement herhalend is (dus met cardinaliteit > 1). Adressen mogen ook in de toekomst geldig worden of vervallen als bijvoorbeeld verhuizing reeds bekend is.
hl7:telecom
TEL.NL.EXTENDED0 … *CDArdotsC‑NL
where [starts-with(@value,'tel:')]
Included from 2.16.840.1.113883.2.4.3.11.60.3.10.1.103 phone number - generic (2018‑06‑11)
@use
set_cs0 … 1 nl-NL Dit attribuut is een spatie gescheiden lijst van kenmerken. Het kan twee van de kenmerken uit het zib element TelecomType bevatten (MC or PG) en een of meer van de kenmerken uit het element NummerSoort.
en-US This attribute is a space separated list of properties. It may cover two of the properties from the hcim element TelecomType bevatten (MC or PG) and one or more of the properties from the element NumberType.
 CONF
The value of @use shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.20.6.2 (2017‑12‑31)
or
@use shall be "MC"
or
@use shall be "PG"
@value
url1 … 1Rnl-NL Telefoonnummers bestaan uit een uri beginnend met tel:. Faxnummers bestaan uit een uri beginnend fax:. Let op: een uri bevat bijvoorbeeld geen spaties.
en-US Phone numbers consist of a uri starting with tel:. Fax numbers consist of a uri starting with fax:. Note: a uri does not contain whitespace among other things.
hl7:telecom
TEL.NL.EXTENDED0 … *CDArdotsC‑NL
where [starts-with(@value,'mailto:')]
Included from 2.16.840.1.113883.2.4.3.11.60.3.10.1.104 email address - generic (2018‑06‑11)
@use
set_cs0 … 1 
 CONF
The value of @use shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.20.6.3 (2017‑12‑31)
@value
url1 … 1Rnl-NL E-mailadressen bestaan uit een uri beginnend met mailto:. Let op: een uri bevat bijvoorbeeld geen spaties.
en-US Email addresses consist of a uri starting with mailto:. Note: a uri does not contain whitespace among other things.
Choice1 … 1Elements to choose from:
  • hl7:guardianPerson
hl7:guardianPerson
0 … 1CDArdotsC‑NL
hl7:name
PN.NL0 … 1CDArdotsC‑NL
Included from 2.16.840.1.113883.2.4.3.11.60.3.10.1.100 name person NL - generic (2018‑06‑11)
@use
set_cs0 … 1 nl-NL 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:
  • L - Reguliere naam. De naam zoals die door de persoon (entiteit) gevoerd wordt. De afkorting 'L' stond oorspronkelijk voor Legal (wettelijk), maar feit is dat hier ook componenten in voor mogen komen (zoals een roepnaam), die niet wettelijk zijn vastgelegd. Dit naamgebruikstype is het standaardtype als geen type wordt doorgegeven.
  • A - Pseudoniem. Een artiestennaam, 'schuilnaam' of tijdelijke naam voor een persoon (entiteit). Deze wijkt dus af van de regulier gevoerde naam en wordt bijvoorbeeld gebruikt om iemands identiteit te verbergen (in verband met privacy) of als tijdelijke naam wanneer de echte niet bekend is ('John Doe').
  • OR - Wettelijk geregistreerde naam. De naam met de exacte componenten zoals deze voorkomen in het bevolkingsregister van het betreffende land. Voor Nederland is dit het Gemeentelijke Basisadministratie (GBA) of Basisregistratie Personen (BRP) of Register niet-ingezetenen (RNI). Dit is de naam zoals die wordt geretourneerd indien een BSN met succes wordt geverifieerd.

en-US In principal it is possible to communicate use of every Person name. In The Netherlands we constrained the full set to the following options:
  • L - Regular name. Name the person (entity) habitually goes by. Originally the use code 'L' stood for Legal (officially registered), but this name could also be used to convey components like callme name that are not covered in any officially registered name. The name use code 'L' is to be assumed is no use code is communicated.
  • A - Pseudonym. A stage name, 'undercover name' or temporarily assigned name for a person (entity). This name would be different from the regular name and is used to hide someone identity (for privacy reasons) or as a temptorary measure when the real name is unknown ('John Doe').
  • OR - Legally registered name. The name with the exact components as registered in the national person registry of the relevant country for that person. In The Netherlands this is the Gemeentelijke Basisadministratie (GBA) or Basisregistratie Personen (BRP) or Register niet-ingezetenen (RNI). This name is the name as returned by that registry, e.g. when his Burgerserivcenummer (BSN) is successfully verified.
 CONF
@use shall be "L"
or
@use shall be "A"
or
@use shall be "OR"
Choice0 … *
nl-NL Minimaal één van de elementen voornaam, roepnaam of initialen en minimaal een geslachtsnaam of geslachtsnaam partner, eventueel met voorvoegsels moet aanwezig zijn.
en-US At mininum one of the components given name, callme name or initials and at minimum the own surname or partner surname, possibly with prefixes/voorvoegsels, shall be present.
Elements to choose from:
  • hl7:prefix[@qualifier='NB']
  • hl7:given[@qualifier='BR']
  • hl7:given[@qualifier='CL']
  • hl7:given[@qualifier='IN']
  • hl7:given[not(@qualifier)]
  • hl7:prefix[.[not(@qualifier)] | .[tokenize(@qualifier,'\s')='VV'][not(tokenize(@qualifier,'\s')=('BR', 'SP'))][following-sibling::hl7:family[1][not(tokenize(@qualifier,'\s')=('BR', 'SP'))]]]
  • hl7:family[not(tokenize(@qualifier,'\s')=('BR', 'SP'))]
  • hl7:prefix[tokenize(@qualifier,'\s')='VV'][following-sibling::hl7:family[1][@qualifier='BR']]
  • hl7:family[@qualifier='BR']
  • hl7:delimiter
  • hl7:prefix[tokenize(@qualifier,'\s')='VV'][following-sibling::hl7:family[1][@qualifier='SP']]
  • hl7:family[@qualifier='SP']
  • hl7:suffix
hl7:prefix
ENXP0 … 1nl-NL Adellijke titel. Een titel (meestal voluit geschreven) die is ontleend aan iemands aristocratische status. Voorbeelden zijn "Jonkheer ", "Graaf ", etc. Noot 1: zie ook GBA Tabel 38 Adellijke titel/predicaat. Noot 2: Adellijke titels spelen normaal geen rol van betekenis in de zorg en ondersteuning hiervoor kan variëren van systeem tot systeem. De zorginformatiebouwstenen tot in elk geval release 2020 bieden geen handvat voor adellijke titels.
en-US Nobility title. A title (usually written in full) derived from someone's artistocratic status. Examples include "Jonkheer ", "Graaf ", etc. Noot 1: see also GBA Table 38 Adellijke titel/predicaat. Note 2: Nobility titles are not regularly a part of healthcare and support may vary from system to system. The Dutch clinical information models or zibs at least until version 2020 do not support nobility titles.
PN.NL
where [@qualifier='NB']
@qualifier
set_cs1 … 1FNB
@nullFlavor
cs0NPNP/not present
 Example<prefix qualifier="NB">Jonkheer </prefix>
hl7:given
ENXP0 … 1Rnl-NL Bevat de voornamen van een persoon. De qualifier 'BR' duidt een officiële voornaam aan
en-US Contains given names of a person. The qualifier 'BR' indicates an officially registered given name
PN.NL
where [@qualifier='BR']
@qualifier
set_cs1 … 1FBR
@nullFlavor
cs0NPNP/not present
 Example<given qualifier="BR">Maria</given>
hl7:given
ENXP0 … 1Rnl-NL Bevat de roepnaam van een persoon. De qualifier 'CL' duidt een roepnaam aan
en-US Contains callme name of a person. The qualifier 'CL' indicates a callme name
PN.NL
where [@qualifier='CL']
@qualifier
set_cs1 … 1FCL
@nullFlavor
cs0NPNP/not present
 Example<given qualifier="CL">Ria</given>
hl7:given
ENXP0 … 1Rnl-NL Bevat de voorletters van een persoon. Een afsluitende punt moet expliciet worden vermeld. De qualifier heeft de waarde "IN" voor de initialen
en-US Contains the initials of a person. A closing dot shall be used for every initial. The qualifier "IN" indicates initials
PN.NL
where [@qualifier='IN']
@qualifier
set_cs1 … 1FIN
@nullFlavor
cs0NPNP/not present
 Example<given qualifier="IN">M.</given>
hl7:given
ENXP0 … 1nl-NL Voornaamdeel van ongedefinieerd type. Bij voorkeur alleen met type gebruiken.
en-US Given name component of an undefined type. Preferably only use qualified given names.
PN.NL
where [not(@qualifier)]
hl7:prefix
ENXP0 … 1Rnl-NL Prefixdeel van ongedefinieerd type, of van alleen type voorvoegsel (VV) gevolgd door een achternaam zonder type BR (geboortenaam) of SP (partnernaam). Als van een achternaamdeel het type BR of SP te duiden is, dan zou dat bij het voorvoegsel ook moeten kunnen. Element prefix bij voorkeur alleen met volledig type gebruiken.
en-US Prefix component of an undefined type, or just of type voorvoegsel (VV) followed by a surname without a qualifier BR (birth name) or SP (partner name). If the last name part type qualifier BR or SP is known then this should also be possible on the prefix of type voorvoegsel. Element prefix is preferably only used with fully specified qualifier.
PN.NL
where [. [not(@qualifier)] or
[tokenize(@qualifier,'\s')='VV'] [not(tokenize(@qualifier,'\s')=('BR', 'SP'))] [following-sibling::hl7:family [1] [not(tokenize(@qualifier,'\s')=('BR', 'SP'))]]]
hl7:family
ENXP0 … 1Rnl-NL Achternaamdeel van ongedefinieerd type dus zonder BR of SP. Bij voorkeur alleen met type gebruiken.
en-US Surname component of an undefined type hence without BR or SP. Preferably only use qualified family names.
PN.NL
where [not(tokenize(@qualifier,'\s')=('BR', 'SP'))]
hl7:prefix
ENXP0 … 1Rnl-NL Bevat voorvoegsels van de geslachtsnaam en moet direct voorafgaand aan de geslachtsnaam in family staan
en-US Contains prefixes/voorvoegsels of the own surname and shall be precede the own surname in the family element
PN.NL
where [tokenize(@qualifier,'\s')='VV'] [following-sibling::hl7:family [1] [@qualifier='BR']]
@qualifier
set_cs1 … 1Rnl-NL Waarde "VV", "VV BR" of "BR VV".
en-US Value "VV", "VV BR" or "BR VV".
@nullFlavor
cs0NPNP/not present
 Example<prefix qualifier="VV">van der </prefix>
hl7:family
ENXP0 … 1Rnl-NL Bevat de geslachtsnaam van een persoon. Het qualifier 'BR' duidt een geslachtsnaam aan
en-US Contains own surname of a person. The qualifier 'BR' indicates the own surname
PN.NL
where [@qualifier='BR']
@qualifier
cs1 … 1FBR
@nullFlavor
cs0NPNP/not present
 Example<family qualifier="BR">Lelie</family>
hl7:delimiter
ENXP0 … 1nl-NL 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".

en-US A delimiter has no special meaning as part of a Person Name, other than communicating a piece of literal text that is part of a written name. A delimiter shall occur in the place it would be written down in a Person Name. There are no implicit spaces, so if a preceding or trailing space is relevant it shall be communicated explicit. Examples of delimiters are:
  • The hyphen '-' between own surname and partner surname (or vice versa).
  • The comma plus space ', ' between name and certain suffixes.
  • The text ', geb. ' or ', e.v. ' that is occasionally used for oiwn surname and/or partner surname.
Note: the space between a prefix/voorvoegsel and the surname is not a delimiter, it is part of the prefix/voorvoegsel. This also goes for other delimiters that are part of the prefix/voorvoegsel like the apostrophe in the name "D'Artagnan".
PN.NL
@nullFlavor
cs0NPNP/not present
hl7:prefix
ENXP0 … 1Rnl-NL Bevat voorvoegsels van de geslachtsnaam van partner en moet direct voorafgaand aan de geslachtsnaam partner in family staan
en-US Contains prefixes/voorvoegsels of the partnername surname and shall be precede the partner surname in the family element
PN.NL
where [tokenize(@qualifier,'\s')='VV'] [following-sibling::hl7:family [1] [@qualifier='SP']]
@qualifier
set_cs1 … 1Rnl-NL Waarde "VV", "VV SP" of "SP VV".
en-US Value "VV", "VV SP" or "SP VV".
@nullFlavor
cs0NPNP/not present
 Example<prefix qualifier="VV">van </prefix>
hl7:family
ENXP0 … 1Rnl-NL Bevat de geslachtsnaam partner van een persoon. Het qualifier type 'SP' duidt een geslachtsnaam partner aan
en-US Contains partnername surname of a person. The qualifier 'SP' indicates the partner surname
PN.NL
where [@qualifier='SP']
@qualifier
cs1 … 1FSP
@nullFlavor
cs0NPNP/not present
 Example<family qualifier="SP">Putten</family>
hl7:suffix
ENXP0 … *nl-NL 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".


en-US A suffix always applies to a part of the name that belongs to one or more other name parts and should follow those. In The Netherlands only academic titles are allowed as suffix. Some rules for person name parts of type suffix:
  • A suffix shall always follow the name parts that it pertains to (i.e. where you would usually write it).
  • There's no implicit space to separate it from the preceding name part, so any required spaces shall be part of the suffix value!
  • The suffix type may be communicated using the qualifier attribute.

A person name part of type suffix without a qualifier, is a suffix not otherwise specified. The use of (usually American) terms as ' Jr.', ' Sr.' or ' III' are in this category.

There's no rule for the number of suffixes in one component. I.e. " MSc" and " MD" may be communicated separately, but may also be combined as " MSc MD".

PN.NL
@qualifier
cs0 … 1FAC
@nullFlavor
cs0NPNP/not present
hl7:validTime
IVL_TS0 … 1nl-NL 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).

en-US This is an optional part within Person Nameand signals the period of validity for the name. The options are:
  • There is no validTime element: the name is considered valid until specified otherwise.
  • There is a lower and upper boundary: the name was valid in the given period.
  • There's only a lower boundary: the name has been valid since the given date.
  • There's only an upper boundary: the name was valid until the given date.
This element of Person Name may be used to indicate the person has changed his name at least once in his life. This may occur in the following cases:
  • Adoption of a baby, where the baby assumes the adoption parents' last name.
  • Marriage, where a partner surname may be added a persons own surname or replace it.
  • Divorce, where a previously assumed partner surname may be replace by the own surname again.
  • Personen who change their given or last names for other reasons.
Note that many patient administrations do not really keep a history (with start date) of a patient name. In general an audit trail is kept of change in the patient data. This may or not may not be used to deduce the history of a person name, but it usually suffices to communicate just the current/relevant name (and thus not use the validTime element).
PN.NL
 Constraintnl-NL 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.
 Schematron assertrolered error 
 testnot(*) or (hl7:given and hl7:family) 
 MessageIn een gestructureerde naam moet minimaal één voornaam, initiaal of roepnaam en minimaal één geslachtsnaam of geslachtsnaam partner van een persoon aanwezig zijn, inclusief voorvoegsel(s) indien van toepassing 
sdtc:asPatientRelationship
0 … 1CDArdotsC‑NL
@classCode
cs1 … 1FPRS
sdtc:code
CE1 … 1RCDArdotsC‑NL
 CONF
The value of @code shall be drawn from value set 2.16.840.1.113883.2.4.3.11.60.40.2.3.1.1 (2017‑12‑31)
hl7:author
0 … 1nl-NL Auteur
en-US Author
Contains 2.16.840.1.113883.2.4.3.11.60.3.10.11 CDA Author (Body) SDTC (2017‑06‑02)
Buildotsizer
hl7:informant
0 … 1nl-NL Informant
en-US Informant
Contains 2.16.840.1.113883.2.4.3.11.60.3.10.12 CDA Informant (Body) SDTC (2017‑06‑02)
Buildotsizer
hl7:participant
0 … 1nl-NL Inhoudsverantwoordelijke voor de bouwstenen in deze organizer
en-US Responsible party for the the building blocks in the organizer
Contains 2.16.840.1.113883.2.4.3.11.60.3.10.10 CDA Participant (Body) SDTC (2017‑06‑02)
Buildotsizer
where [@typeCode='RESP']
 Constraintnl-NL Aan te geven indien de inhoudsverantwoordelijke zorgverlener anders is dan de dossierverantwoordelijke zorgverlener
hl7:participant
0 … 1nl-NL Dossierhouder voor de bouwstenen in deze organizer
en-US Custodian for the building blocks in this organizer
Contains 2.16.840.1.113883.2.4.3.11.60.3.10.10 CDA Participant (Body) SDTC (2017‑06‑02)
Buildotsizer
where [@typeCode='CST']
hl7:participant
0 … *nl-NL Overige partijen zoals contactpersonen en verzekering
en-US Other relevant parties like contact persons and insurance
Contains 2.16.840.1.113883.2.4.3.11.60.3.10.10 CDA Participant (Body) SDTC (2017‑06‑02)
Buildotsizer
where [not(@typeCode=('CST','RESP'))]
hl7:component
0 … *Rnl-NL Koppelpunt voor een bouwsteen. Iedere bouwsteen is op deze manier een component van de 'lijst', de organizer.
en-US Association of a building block to the organizer. Each building block is a component of the 'list', the organizer.
Buildotsizer
@typeCode
cs0 … 1FCOMP
@contextControlCode
cs0 … 1FOP