Nictiz FHIR NL STU3 Zib2017
1.3.15 - CI Build

Nictiz FHIR NL STU3 Zib2017 - Local Development build (v1.3.15) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Data Type Profile: nl-core-address - Detailed Descriptions

Active as of 2025-09-22

Definitions for the nl-core-address data type profile.

Guidance on how to interpret the contents of this table can be foundhere

0. Address
Definition

This datatype defines a common basis for expressing all addresses around the world, but adds extensions to express Dutch addresses specifically, according to the HCIM AddressInformation (v1.0, 2017). A Dutch Address still is a proper FHIR Address, which means that systems that cannot interpret the extensions will still be able to render and work with this datatype.

To have true compatibility an implementer SHOULD use the core Address parts as intended. To have addresses work for Dutch context, the implementer SHOULD in addition use the extension elements.

Separate address parts

The first addition is that Dutch addresses make certain address parts separately communicable. These parts are required for use in true Dutch systems when dealing with Dutch addresses, but may not have value for international systems when information gets sent abroad.

Custom address types

The second addition is that the HCIM defines its own ValueSet for address types, which can only be partially expressed using the FHIR Address datatype and requires a mapping to multiple elements. The table below explains how the HCIM concepts are mapped to the various FHIR elements (see the ConceptMaps <http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse> and <http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType> as well). The HCIM code itself should also be included using the AddressType extension.

| HCIM |.ext:AddressType | .ext:official | .use | .type | |-----------------------------------|:------------------:|:---------------:|:------:|:----------:| | Postal Address/Postadres | PST | | | postal | | Primary Home/Officieel adres | HP | true | home | | | Visit Address/Woon-/verblijfadres | PHYS | | home | physical | | Temporary Address/Tijdelijk adres | TMP | | temp | | | Work Place/Werkadres | WP | | work | | | Vacation Home/Vakantie adres | HV | | temp | |

If Address.type is both then this is to be understood as a dual purpose address (postal and physical). Systems that support importing it like this are encouraged to do so, otherwise they may need to import this as two separate addresses.

NOTE: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the HCIM ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.

ShortAddress information
Alternate NamesAdresInformatie
ExampleExample of a Vacation Home address: { "extension" : [{ "url" : "http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType", "valueCodeableConcept" : { "coding" : [{ "system" : "http://hl7.org/fhir/v3/AddressUse", "code" : "HV", "display" : "Vakantie adres" }] } }], "use" : "temp", "line" : ["Binnenkant 12A Hoog"], "_line" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName", "valueString" : "Binnenkant" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber", "valueString" : "12" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix", "valueString" : "A" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitID", "valueString" : "Hoog" }] }], "city" : "Amsterdam", "state" : "NH", "postalCode" : "1000AA", "country" : "NLD" }
Example of a Primary Home address: { "extension" : [{ "url" : "http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType", "valueCodeableConcept" : { "coding" : [{ "system" : "http://hl7.org/fhir/v3/AddressUse", "code" : "HP", "display" : "Officieel adres" }] } }, { "url" : "http://fhir.nl/fhir/StructureDefinition/nl-core-address-official", "valueBoolean" : true }], "use" : "home", "line" : ["Binnenkant to 10"], "_line" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName", "valueString" : "Binnenkant" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator", "valueString" : "to" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber", "valueString" : "10" }] }], "city" : "Amsterdam", "state" : "NH", "postalCode" : "1001AA", "country" : "NLD" }
Invariantsnl-streetname-if-official-and-other-line-parts: Address.streetName in an official address SHALL have a value if one of houseNumber|buildingNumberSuffix|additionalLocator has a value ((extension.where(url = 'http://fhir.nl/fhir/StructureDefinition/nl-core-address-official').where(value = true)).empty() or (line.extension.where(url = 'http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName').empty().not() and (line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber').empty().not() or line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix').empty().not() or line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator').empty().not())))
2. Address.extension
Control0..?
SlicingThis element introduces a set of slices on Address.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ url
  • 4. Address.extension:AddressType
    Slice NameAddressType
    Control0..1
    TypeExtension(HCIM AddressInformation AddressType) (Extension Type: CodeableConcept)
    6. Address.extension:AddressType.valueCodeableConcept:valueCodeableConcept
    Slice NamevalueCodeableConcept
    Definition

    The type of address in question, such as a home address or mailing address.

    ShortAddressType
    Comments

    This extension can be used to include the HCIM AddressType code. See the documentation on the root level for mapping these codes to the various elements of this datatype.

    NOTE: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the HCIM ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.

    Alternate NamesAdresSoort
    8. Address.extension:official
    Slice Nameofficial
    Definition

    Mark an address as an 'officially registered' address. In Dutch context that means it is registered in the Basisregistratie persoonsgegevens (BRP)

    ShortMark an address as an 'officially registered' address.
    Control0..1
    TypeExtension(nl-core-address-official) (Extension Type: boolean)
    Alternate NamesMarkeer een adres als een 'officieel geregistreerd adres.
    10. Address.use
    Definition

    Purpose of this address

    12. Address.type
    14. Address.line
    16. Address.line.extension
    Control0..?
    SlicingThis element introduces a set of slices on Address.line.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ url
    • 18. Address.line.extension:streetName
      Slice NamestreetName
      Definition

      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.

      Control0..1
      TypeExtension(ADXP-streetName) (Extension Type: string)
      Requirements

      Basisregistratie Persoonsgegevens 11.10 Straatnaam

      20. Address.line.extension:streetName.valueString:valueString
      Slice NamevalueString
      22. Address.line.extension:houseNumber
      Slice NamehouseNumber
      Definition

      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 Address datatype.

      Control0..1
      TypeExtension(ADXP-houseNumber) (Extension Type: string)
      Requirements

      Basisregistratie Persoonsgegevens 11.20 Huisnummer

      24. Address.line.extension:houseNumber.valueString:valueString
      Slice NamevalueString
      26. Address.line.extension:buildingNumbersuffix
      Slice NamebuildingNumbersuffix
      Definition

      HouseNumberLetter - A letter following the house number as assigned by the municipal authorities.

      HouseNumberAddition - The letters or signs needed to locate the mailbox, in addition to the house number and letter.

      Comments

      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
      Control0..?
      TypeExtension(ADXP-buildingNumberSuffix) (Extension Type: string)
      Requirements

      Basisregistratie Persoonsgegevens 11.30 Huisletter 11.40 Huisnummertoevoeging 12.10 Locatieomschrijving

      28. Address.line.extension:buildingNumbersuffix.valueString:valueString
      Slice NamevalueString
      30. Address.line.extension:unitID
      Slice NameunitID
      Definition

      Extra information such as the building name, building number, entrance, route number.

      Control0..1
      TypeExtension(ADXP-unitID) (Extension Type: string)
      32. Address.line.extension:unitID.valueString:valueString
      Slice NamevalueString
      34. Address.line.extension:additionalLocator
      Slice NameadditionalLocator
      Definition

      HouseNumberIndication - The indication used for addresses that do not consist of the usual street name and house number.

      Control0..1
      TypeExtension(ADXP-additionalLocator) (Extension Type: string)
      Requirements

      Basisregistratie Persoonsgegevens 11.50 Aanduiding bij huisnummer

      36. Address.line.extension:additionalLocator.valueString:valueString
      Slice NamevalueString
      38. Address.city
      Requirements

      Basisregistratie Persoonsgegevens 11.70 Woonplaatsnaam

      Alternate NamesMunicipality, woonplaats
      ExampleExample city: Den Haag
      40. Address.district
      Comments

      District is sometimes known as county, but in some regions 'county' is used in place of city (municipality), so county name should be conveyed in city instead. In a Dutch address this element is used for the population of a "gemeente"

      Requirements

      Basisregistratie Persoonsgegevens 09.10 Gemeente van inschrijving

      Alternate NamesGemeente
      ExampleExample district: Wateringen
      42. Address.state
      Definition

      Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (i.e. US 2 letter state codes). For Dutch addresses this element should contain the "provincie" code

      ShortSub-unit of country (abbreviations ok).
      Requirements

      Some (Dutch) cities have the same name in multiple provinces. Dutch examples include Bergen (Noord-Holland / Limburg) and Geesteren (Gelderland / Overijssel).

      Alternate NamesProvincie
      ExampleExample province: ZH
      44. Address.postalCode
      Comments

      Dutch postal codes have pattern '\d{4}[A-Z]{2}' so they do not have spaces. Systems can easily render postal codes with a space if necessary.

      Alternate NamesPostcode
      ExampleExample postcode: 9132AG
      Invariantsnl-postal-code-pattern: Dutch postal code pattern 'nnnnAA' ((country in 'nl' | 'nld' | 'nederland').not() or matches('^\\d{4}[A-Z]{2}$'))
      46. Address.country
      Definition

      Country in which the address is located.

      ShortCountry
      Comments

      The FHIR datatype does not properly support coding the country using a CodeableConcept or Coding datatype. If the sender supports coded countries, it SHALL send the coded value using the code-specification extension under Address.country.

      Alternate NamesLand
      ExampleExample country: NLD
      48. Address.country.extension
      Control0..?
      SlicingThis element introduces a set of slices on Address.country.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
      • value @ url
      • 50. Address.country.extension:countryCode
        Slice NamecountryCode
        ShortCountryGBACode | CountryISOCode
        Control0..1
        TypeExtension(HCIM extension code-specification) (Extension Type: CodeableConcept)
        52. Address.country.extension:countryCode.valueCodeableConcept:valueCodeableConcept
        Slice NamevalueCodeableConcept
        ShortCountryGBACode | CountryISOCode
        Alternate NamesLandGBACodelijst, LandISOCodelijst
        54. Address.country.extension:countryCode.valueCodeableConcept:valueCodeableConcept.coding
        Control1..?
        SlicingThis element introduces a set of slices on Address.country.extension.valueCodeableConcept.coding. The slices areUnordered and Open, and can be differentiated using the following discriminators:
        • pattern @ $this
        • 56. Address.country.extension:countryCode.valueCodeableConcept:valueCodeableConcept.coding:countryGBACodelist
          Slice NamecountryGBACodelist
          BindingUnless not suitable, these codes SHALL be taken from LandGBACodelijst
          (extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.1--20171231000000)

          LandGBACodelijst

          Pattern Value{
            "system" : "urn:oid:2.16.840.1.113883.2.4.4.16.34"
          }
          58. Address.country.extension:countryCode.valueCodeableConcept:valueCodeableConcept.coding:countryISOCodelist
          Slice NamecountryISOCodelist
          BindingUnless not suitable, these codes SHALL be taken from LandISOCodelijst
          (extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.2--20171231000000)

          LandISOCodelijst

          Pattern Value{
            "system" : "urn:iso:std:iso:3166"
          }

          Guidance on how to interpret the contents of this table can be foundhere

          0. Address
          Definition

          This datatype defines a common basis for expressing all addresses around the world, but adds extensions to express Dutch addresses specifically, according to the HCIM AddressInformation (v1.0, 2017). A Dutch Address still is a proper FHIR Address, which means that systems that cannot interpret the extensions will still be able to render and work with this datatype.

          To have true compatibility an implementer SHOULD use the core Address parts as intended. To have addresses work for Dutch context, the implementer SHOULD in addition use the extension elements.

          Separate address parts

          The first addition is that Dutch addresses make certain address parts separately communicable. These parts are required for use in true Dutch systems when dealing with Dutch addresses, but may not have value for international systems when information gets sent abroad.

          Custom address types

          The second addition is that the HCIM defines its own ValueSet for address types, which can only be partially expressed using the FHIR Address datatype and requires a mapping to multiple elements. The table below explains how the HCIM concepts are mapped to the various FHIR elements (see the ConceptMaps <http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse> and <http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType> as well). The HCIM code itself should also be included using the AddressType extension.

          | HCIM |.ext:AddressType | .ext:official | .use | .type | |-----------------------------------|:------------------:|:---------------:|:------:|:----------:| | Postal Address/Postadres | PST | | | postal | | Primary Home/Officieel adres | HP | true | home | | | Visit Address/Woon-/verblijfadres | PHYS | | home | physical | | Temporary Address/Tijdelijk adres | TMP | | temp | | | Work Place/Werkadres | WP | | work | | | Vacation Home/Vakantie adres | HV | | temp | |

          If Address.type is both then this is to be understood as a dual purpose address (postal and physical). Systems that support importing it like this are encouraged to do so, otherwise they may need to import this as two separate addresses.

          NOTE: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the HCIM ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.


          An address expressed using postal conventions (as opposed to GPS or other location definition formats). This data type may be used to convey addresses for use in delivering mail as well as for visiting locations which might not be valid for mail delivery. There are a variety of postal address formats defined around the world.

          ShortAddress informationAn address expressed using postal conventions (as opposed to GPS or other location definition formats)
          Comments

          Note: address is for postal addresses, not physical locations.

          Control0..*
          This element is affected by the following invariants: ele-1, nl-streetname-if-official-and-other-line-parts
          Alternate NamesAdresInformatie
          ExampleExample of a Vacation Home address: { "extension" : [{ "url" : "http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType", "valueCodeableConcept" : { "coding" : [{ "system" : "http://hl7.org/fhir/v3/AddressUse", "code" : "HV", "display" : "Vakantie adres" }] } }], "use" : "temp", "line" : ["Binnenkant 12A Hoog"], "_line" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName", "valueString" : "Binnenkant" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber", "valueString" : "12" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix", "valueString" : "A" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitID", "valueString" : "Hoog" }] }], "city" : "Amsterdam", "state" : "NH", "postalCode" : "1000AA", "country" : "NLD" }
          Example of a Primary Home address: { "extension" : [{ "url" : "http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType", "valueCodeableConcept" : { "coding" : [{ "system" : "http://hl7.org/fhir/v3/AddressUse", "code" : "HP", "display" : "Officieel adres" }] } }, { "url" : "http://fhir.nl/fhir/StructureDefinition/nl-core-address-official", "valueBoolean" : true }], "use" : "home", "line" : ["Binnenkant to 10"], "_line" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName", "valueString" : "Binnenkant" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator", "valueString" : "to" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber", "valueString" : "10" }] }], "city" : "Amsterdam", "state" : "NH", "postalCode" : "1001AA", "country" : "NLD" }
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
          nl-streetname-if-official-and-other-line-parts: Address.streetName in an official address SHALL have a value if one of houseNumber|buildingNumberSuffix|additionalLocator has a value ((extension.where(url = 'http://fhir.nl/fhir/StructureDefinition/nl-core-address-official').where(value = true)).empty() or (line.extension.where(url = 'http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName').empty().not() and (line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber').empty().not() or line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix').empty().not() or line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator').empty().not())))
          ele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
          2. Address.extension
          Definition

          An Extension


          May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

          ShortExtensionAdditional Content defined by implementations
          Comments

          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

          Control0..*
          TypeExtension
          Alternate Namesextensions, user content
          SlicingThis element introduces a set of slices on Address.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
          • value @ url
          • 4. Address.extension:AddressType
            Slice NameAddressType
            Definition

            Optional Extension Element - found in all resources.

            ShortOptional Extensions Element
            Control0..1
            TypeExtension(HCIM AddressInformation AddressType) (Extension Type: CodeableConcept)
            6. Address.extension:AddressType.url
            Definition

            Source of the definition for the extension code - a logical name or a URL.

            Shortidentifies the meaning of the extension
            Comments

            The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

            Control1..1
            Typeuri
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            XML FormatIn the XML format, this property is represented as an attribute.
            Fixed Valuehttp://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType
            8. Address.extension:AddressType.value[x]
            Definition

            Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

            ShortValue of extension
            Control0..1
            TypeCodeableConcept, date, dateTime, Meta, code, string, Address, Attachment, integer, oid, Count, instant, ContactPoint, HumanName, Money, Identifier, Coding, markdown, SampledData, Ratio, id, positiveInt, Age, Distance, Reference, Period, Quantity, Duration, Range, uri, Annotation, boolean, base64Binary, Signature, unsignedInt, time, Timing, decimal
            [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
            SlicingThis element introduces a set of slices on Address.extension.value[x]. The slices areUnordered and Closed, and can be differentiated using the following discriminators:
            • type @ $this
            • 10. Address.extension:AddressType.value[x]:valueCodeableConcept
              Slice NamevalueCodeableConcept
              Definition

              The type of address in question, such as a home address or mailing address.


              Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

              ShortAddressTypeValue of extension
              Comments

              This extension can be used to include the HCIM AddressType code. See the documentation on the root level for mapping these codes to the various elements of this datatype.

              NOTE: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the HCIM ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.

              Control0..1
              BindingUnless not suitable, these codes SHALL be taken from For codes, see AdresSoortCodelijst
              (extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.3--20171231000000)

              AdresSoortCodelijst

              TypeCodeableConcept, date, dateTime, Meta, code, string, Address, Attachment, integer, oid, Count, instant, ContactPoint, HumanName, Money, Identifier, Coding, markdown, SampledData, Ratio, id, positiveInt, Age, Distance, Reference, Period, Quantity, Duration, Range, uri, Annotation, boolean, base64Binary, Signature, unsignedInt, time, Timing, decimal
              [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
              Alternate NamesAdresSoort
              12. Address.extension:official
              Slice Nameofficial
              Definition

              Mark an address as an 'officially registered' address. In Dutch context that means it is registered in the Basisregistratie persoonsgegevens (BRP)

              ShortMark an address as an 'officially registered' address.
              Control0..1
              TypeExtension(nl-core-address-official) (Extension Type: boolean)
              Alternate NamesMarkeer een adres als een 'officieel geregistreerd adres.
              14. Address.use
              Definition

              Purpose of this address


              The purpose of this address.

              Shorthome | work | temp | old - purpose of this address
              Comments

              This is labeled as "Is Modifier" because applications should not mistake a temporary or old address etc.for a current/permanent one. Applications can assume that an address is current unless it explicitly says that it is temporary or old.

              Control0..1
              BindingThe codes SHALL be taken from AddressUsehttp://hl7.org/fhir/ValueSet/address-use|3.0.2
              (required to http://hl7.org/fhir/ValueSet/address-use|3.0.2)
              Typecode
              Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              Allows an appropriate address to be chosen from a list of many.

              ExampleGeneral: home
              16. Address.type
              Definition

              Distinguishes between physical addresses (those you can visit) and mailing addresses (e.g. PO Boxes and care-of addresses). Most addresses are both.

              Shortpostal | physical | both
              Control0..1
              BindingThe codes SHALL be taken from AddressTypehttp://hl7.org/fhir/ValueSet/address-type|3.0.2
              (required to http://hl7.org/fhir/ValueSet/address-type|3.0.2)
              Typecode
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              ExampleGeneral: both
              18. Address.city
              Definition

              The name of the city, town, village or other community or delivery center.

              ShortName of city, town etc.
              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              Basisregistratie Persoonsgegevens 11.70 Woonplaatsnaam

              Alternate NamesMunicpality, Municipality, woonplaats
              ExampleGeneral: Erewhon
              Example city: Den Haag
              20. Address.district
              Definition

              The name of the administrative area (county).

              ShortDistrict name (aka county)
              Comments

              District is sometimes known as county, but in some regions 'county' is used in place of city (municipality), so county name should be conveyed in city instead. In a Dutch address this element is used for the population of a "gemeente"


              District is sometimes known as county, but in some regions 'county' is used in place of city (municipality), so county name should be conveyed in city instead.

              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              Basisregistratie Persoonsgegevens 09.10 Gemeente van inschrijving

              Alternate NamesCounty, Gemeente
              ExampleGeneral: Madison
              Example district: Wateringen
              22. Address.state
              Definition

              Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (i.e. US 2 letter state codes). For Dutch addresses this element should contain the "provincie" code


              Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (i.e. US 2 letter state codes).

              ShortSub-unit of country (abbreviations ok).
              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Requirements

              Some (Dutch) cities have the same name in multiple provinces. Dutch examples include Bergen (Noord-Holland / Limburg) and Geesteren (Gelderland / Overijssel).

              Alternate NamesProvince, Territory, Provincie
              ExampleExample province: ZH
              24. Address.postalCode
              Definition

              A postal code designating a region defined by the postal service.

              ShortPostal code for area
              Comments

              Dutch postal codes have pattern '\d{4}[A-Z]{2}' so they do not have spaces. Systems can easily render postal codes with a space if necessary.

              Control0..1
              This element is affected by the following invariants: nl-postal-code-pattern
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Alternate NamesZip, Postcode
              ExampleGeneral: 9132
              Example postcode: 9132AG
              Invariantsnl-postal-code-pattern: Dutch postal code pattern 'nnnnAA' ((country in 'nl' | 'nld' | 'nederland').not() or matches('^\\d{4}[A-Z]{2}$'))
              26. Address.country
              Definition

              Country in which the address is located.


              Country - a nation as commonly understood or generally accepted.

              ShortCountryCountry (e.g. can be ISO 3166 2 or 3 letter code)
              Comments

              The FHIR datatype does not properly support coding the country using a CodeableConcept or Coding datatype. If the sender supports coded countries, it SHALL send the coded value using the code-specification extension under Address.country.


              ISO 3166 3 letter codes can be used in place of a full country name.

              Control0..1
              Typestring
              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
              Summarytrue
              Alternate NamesLand
              ExampleExample country: NLD
              28. Address.country.extension
              Definition

              An Extension


              May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

              ShortExtensionAdditional Content defined by implementations
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Alternate Namesextensions, user content
              SlicingThis element introduces a set of slices on Address.country.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
              • value @ url
              • 30. Address.country.extension:countryCode
                Slice NamecountryCode
                Definition

                Defines a more specific coded value for a code or string. Especially useful for FHIR's required ValueSets. These extensions are primarily used on codes bound to a required value set, where you would like to use a more specific code than the codes in the bounded value set.

                ShortCountryGBACode | CountryISOCode
                Control0..1
                This element is affected by the following invariants: ele-1
                TypeExtension(HCIM extension code-specification) (Extension Type: CodeableConcept)
                Alternate NamesBevat de specifieke code conform de zib, bij een FHIR-element die een verplichte koppeling heeft met een bepaalde FHIR waardelijst of een FHIR element die niet gecodeerd is gedefinieerd, terwijl de zib dit wel doet.
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                32. Address.country.extension:countryCode.url
                Definition

                Source of the definition for the extension code - a logical name or a URL.

                Shortidentifies the meaning of the extension
                Comments

                The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                Control1..1
                Typeuri
                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                XML FormatIn the XML format, this property is represented as an attribute.
                Fixed Valuehttp://nictiz.nl/fhir/StructureDefinition/code-specification
                34. Address.country.extension:countryCode.value[x]
                Definition

                Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                ShortValue of extension
                Control10..1
                TypeCodeableConcept, date, dateTime, Meta, code, string, Address, Attachment, integer, oid, Count, instant, ContactPoint, HumanName, Money, Identifier, Coding, markdown, SampledData, Ratio, id, positiveInt, Age, Distance, Reference, Period, Quantity, Duration, Range, uri, Annotation, boolean, base64Binary, Signature, unsignedInt, time, Timing, decimal
                [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                SlicingThis element introduces a set of slices on Address.country.extension.value[x]. The slices areUnordered and Closed, and can be differentiated using the following discriminators:
                • type @ $this
                • 36. Address.country.extension:countryCode.value[x]:valueCodeableConcept
                  Slice NamevalueCodeableConcept
                  Definition

                  Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                  ShortCountryGBACode | CountryISOCodeValue of extension
                  Control10..1
                  TypeCodeableConcept, date, dateTime, Meta, code, string, Address, Attachment, integer, oid, Count, instant, ContactPoint, HumanName, Money, Identifier, Coding, markdown, SampledData, Ratio, id, positiveInt, Age, Distance, Reference, Period, Quantity, Duration, Range, uri, Annotation, boolean, base64Binary, Signature, unsignedInt, time, Timing, decimal
                  [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                  Alternate NamesLandGBACodelijst, LandISOCodelijst
                  38. Address.country.extension:countryCode.value[x]:valueCodeableConcept.coding
                  Definition

                  A reference to a code defined by a terminology system.

                  ShortCode defined by a terminology system
                  Comments

                  Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

                  Control10..*
                  TypeCoding
                  Summarytrue
                  Requirements

                  Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

                  SlicingThis element introduces a set of slices on Address.country.extension.value[x].coding. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                  • pattern @ $this
                  • 40. Address.country.extension:countryCode.value[x]:valueCodeableConcept.coding:countryGBACodelist
                    Slice NamecountryGBACodelist
                    Definition

                    A reference to a code defined by a terminology system.

                    ShortCode defined by a terminology system
                    Comments

                    Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

                    Control0..*
                    BindingUnless not suitable, these codes SHALL be taken from For codes, see LandGBACodelijst
                    (extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.1--20171231000000)

                    LandGBACodelijst

                    TypeCoding
                    Summarytrue
                    Requirements

                    Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

                    Pattern Value{
                      "system" : "urn:oid:2.16.840.1.113883.2.4.4.16.34"
                    }
                    42. Address.country.extension:countryCode.value[x]:valueCodeableConcept.coding:countryISOCodelist
                    Slice NamecountryISOCodelist
                    Definition

                    A reference to a code defined by a terminology system.

                    ShortCode defined by a terminology system
                    Comments

                    Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

                    Control0..*
                    BindingUnless not suitable, these codes SHALL be taken from For codes, see LandISOCodelijst
                    (extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.2--20171231000000)

                    LandISOCodelijst

                    TypeCoding
                    Summarytrue
                    Requirements

                    Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

                    Pattern Value{
                      "system" : "urn:iso:std:iso:3166"
                    }

                    Guidance on how to interpret the contents of this table can be foundhere

                    0. Address
                    Definition

                    This datatype defines a common basis for expressing all addresses around the world, but adds extensions to express Dutch addresses specifically, according to the HCIM AddressInformation (v1.0, 2017). A Dutch Address still is a proper FHIR Address, which means that systems that cannot interpret the extensions will still be able to render and work with this datatype.

                    To have true compatibility an implementer SHOULD use the core Address parts as intended. To have addresses work for Dutch context, the implementer SHOULD in addition use the extension elements.

                    Separate address parts

                    The first addition is that Dutch addresses make certain address parts separately communicable. These parts are required for use in true Dutch systems when dealing with Dutch addresses, but may not have value for international systems when information gets sent abroad.

                    Custom address types

                    The second addition is that the HCIM defines its own ValueSet for address types, which can only be partially expressed using the FHIR Address datatype and requires a mapping to multiple elements. The table below explains how the HCIM concepts are mapped to the various FHIR elements (see the ConceptMaps <http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse> and <http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType> as well). The HCIM code itself should also be included using the AddressType extension.

                    | HCIM |.ext:AddressType | .ext:official | .use | .type | |-----------------------------------|:------------------:|:---------------:|:------:|:----------:| | Postal Address/Postadres | PST | | | postal | | Primary Home/Officieel adres | HP | true | home | | | Visit Address/Woon-/verblijfadres | PHYS | | home | physical | | Temporary Address/Tijdelijk adres | TMP | | temp | | | Work Place/Werkadres | WP | | work | | | Vacation Home/Vakantie adres | HV | | temp | |

                    If Address.type is both then this is to be understood as a dual purpose address (postal and physical). Systems that support importing it like this are encouraged to do so, otherwise they may need to import this as two separate addresses.

                    NOTE: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the HCIM ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.

                    ShortAddress information
                    Comments

                    Note: address is for postal addresses, not physical locations.

                    Control0..*
                    This element is affected by the following invariants: ele-1, nl-streetname-if-official-and-other-line-parts
                    Alternate NamesAdresInformatie
                    ExampleExample of a Vacation Home address: { "extension" : [{ "url" : "http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType", "valueCodeableConcept" : { "coding" : [{ "system" : "http://hl7.org/fhir/v3/AddressUse", "code" : "HV", "display" : "Vakantie adres" }] } }], "use" : "temp", "line" : ["Binnenkant 12A Hoog"], "_line" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName", "valueString" : "Binnenkant" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber", "valueString" : "12" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix", "valueString" : "A" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitID", "valueString" : "Hoog" }] }], "city" : "Amsterdam", "state" : "NH", "postalCode" : "1000AA", "country" : "NLD" }
                    Example of a Primary Home address: { "extension" : [{ "url" : "http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType", "valueCodeableConcept" : { "coding" : [{ "system" : "http://hl7.org/fhir/v3/AddressUse", "code" : "HP", "display" : "Officieel adres" }] } }, { "url" : "http://fhir.nl/fhir/StructureDefinition/nl-core-address-official", "valueBoolean" : true }], "use" : "home", "line" : ["Binnenkant to 10"], "_line" : [{ "extension" : [{ "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName", "valueString" : "Binnenkant" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator", "valueString" : "to" }, { "url" : "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber", "valueString" : "10" }] }], "city" : "Amsterdam", "state" : "NH", "postalCode" : "1001AA", "country" : "NLD" }
                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                    nl-streetname-if-official-and-other-line-parts: Address.streetName in an official address SHALL have a value if one of houseNumber|buildingNumberSuffix|additionalLocator has a value ((extension.where(url = 'http://fhir.nl/fhir/StructureDefinition/nl-core-address-official').where(value = true)).empty() or (line.extension.where(url = 'http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName').empty().not() and (line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber').empty().not() or line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix').empty().not() or line.extension.where(url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator').empty().not())))
                    2. Address.id
                    Definition

                    unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                    Shortxml:id (or equivalent in JSON)
                    Control0..1
                    Typestring
                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                    XML FormatIn the XML format, this property is represented as an attribute.
                    4. Address.extension
                    Definition

                    An Extension

                    ShortExtension
                    Control0..*
                    TypeExtension
                    SlicingThis element introduces a set of slices on Address.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                    • value @ url
                    • 6. Address.extension:AddressType
                      Slice NameAddressType
                      Definition

                      Optional Extension Element - found in all resources.

                      ShortOptional Extensions Element
                      Control0..1
                      TypeExtension(HCIM AddressInformation AddressType) (Extension Type: CodeableConcept)
                      8. Address.extension:AddressType.id
                      Definition

                      unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                      Shortxml:id (or equivalent in JSON)
                      Control0..1
                      Typestring
                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                      XML FormatIn the XML format, this property is represented as an attribute.
                      10. Address.extension:AddressType.extension
                      Definition

                      May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                      ShortAdditional Content defined by implementations
                      Comments

                      There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                      Control0..*
                      TypeExtension
                      Alternate Namesextensions, user content
                      SlicingThis element introduces a set of slices on Address.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                      • value @ url
                      • 12. Address.extension:AddressType.url
                        Definition

                        Source of the definition for the extension code - a logical name or a URL.

                        Shortidentifies the meaning of the extension
                        Comments

                        The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                        Control1..1
                        Typeuri
                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                        XML FormatIn the XML format, this property is represented as an attribute.
                        Fixed Valuehttp://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType
                        14. Address.extension:AddressType.value[x]
                        Definition

                        Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                        ShortValue of extension
                        Control0..1
                        TypeCodeableConcept
                        [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                        SlicingThis element introduces a set of slices on Address.extension.value[x]. The slices areUnordered and Closed, and can be differentiated using the following discriminators:
                        • type @ $this
                        • 16. Address.extension:AddressType.value[x]:valueCodeableConcept
                          Slice NamevalueCodeableConcept
                          Definition

                          The type of address in question, such as a home address or mailing address.

                          ShortAddressType
                          Comments

                          This extension can be used to include the HCIM AddressType code. See the documentation on the root level for mapping these codes to the various elements of this datatype.

                          NOTE: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the HCIM ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.

                          Control0..1
                          BindingUnless not suitable, these codes SHALL be taken from AdresSoortCodelijst
                          (extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.3--20171231000000)

                          AdresSoortCodelijst

                          TypeCodeableConcept
                          [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                          Alternate NamesAdresSoort
                          18. Address.extension:official
                          Slice Nameofficial
                          Definition

                          Mark an address as an 'officially registered' address. In Dutch context that means it is registered in the Basisregistratie persoonsgegevens (BRP)

                          ShortMark an address as an 'officially registered' address.
                          Control0..1
                          TypeExtension(nl-core-address-official) (Extension Type: boolean)
                          Alternate NamesMarkeer een adres als een 'officieel geregistreerd adres.
                          20. Address.use
                          Definition

                          Purpose of this address

                          Shorthome | work | temp | old - purpose of this address
                          Comments

                          This is labeled as "Is Modifier" because applications should not mistake a temporary or old address etc.for a current/permanent one. Applications can assume that an address is current unless it explicitly says that it is temporary or old.

                          Control0..1
                          BindingThe codes SHALL be taken from AddressUse
                          (required to http://hl7.org/fhir/ValueSet/address-use|3.0.2)
                          Typecode
                          Is Modifiertrue because No Modifier Reason provideed in previous versions of FHIR
                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                          Summarytrue
                          Requirements

                          Allows an appropriate address to be chosen from a list of many.

                          ExampleGeneral: home
                          22. Address.type
                          Definition

                          Distinguishes between physical addresses (those you can visit) and mailing addresses (e.g. PO Boxes and care-of addresses). Most addresses are both.

                          Shortpostal | physical | both
                          Control0..1
                          BindingThe codes SHALL be taken from AddressType
                          (required to http://hl7.org/fhir/ValueSet/address-type|3.0.2)
                          Typecode
                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                          Summarytrue
                          ExampleGeneral: both
                          24. Address.text
                          Definition

                          A full text representation of the address.

                          ShortText representation of the address
                          Comments

                          Can provide both a text representation and parts.

                          Control0..1
                          Typestring
                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                          Summarytrue
                          Requirements

                          A renderable, unencoded form.

                          ExampleGeneral: 137 Nowhere Street, Erewhon 9132
                          26. Address.line
                          Definition

                          This component contains the house number, apartment number, street name, street direction, P.O. Box number, delivery hints, and similar address information.

                          ShortStreet name, number, direction & P.O. Box etc.
                          Control0..*
                          Typestring
                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                          Summarytrue
                          Requirements

                          home | work | temp | old - purpose of this address.

                          ExampleGeneral: 137 Nowhere Street
                          28. Address.line.id
                          Definition

                          unique id for the element within a resource (for internal references)

                          Shortxml:id (or equivalent in JSON)
                          Control0..1
                          Typestring
                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                          XML FormatIn the XML format, this property is represented as an attribute.
                          30. Address.line.extension
                          Definition

                          An Extension

                          ShortExtension
                          Control0..*
                          TypeExtension
                          SlicingThis element introduces a set of slices on Address.line.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                          • value @ url
                          • 32. Address.line.extension:streetName
                            Slice NamestreetName
                            Definition

                            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.

                            ShortstreetName
                            Control0..1
                            This element is affected by the following invariants: ele-1
                            TypeExtension(ADXP-streetName) (Extension Type: string)
                            Requirements

                            Basisregistratie Persoonsgegevens 11.10 Straatnaam

                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                            34. Address.line.extension:streetName.id
                            Definition

                            unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                            Shortxml:id (or equivalent in JSON)
                            Control0..1
                            Typestring
                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                            XML FormatIn the XML format, this property is represented as an attribute.
                            36. Address.line.extension:streetName.extension
                            Definition

                            May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                            ShortAdditional Content defined by implementations
                            Comments

                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                            Control0..*
                            TypeExtension
                            Alternate Namesextensions, user content
                            SlicingThis element introduces a set of slices on Address.line.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                            • value @ url
                            • 38. Address.line.extension:streetName.url
                              Definition

                              Source of the definition for the extension code - a logical name or a URL.

                              Shortidentifies the meaning of the extension
                              Comments

                              The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                              Control1..1
                              Typeuri
                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                              XML FormatIn the XML format, this property is represented as an attribute.
                              Fixed Valuehttp://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName
                              40. Address.line.extension:streetName.valueString:valueString
                              Slice NamevalueString
                              Definition

                              Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                              ShortValue of extension
                              Control0..1
                              Typestring
                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                              42. Address.line.extension:houseNumber
                              Slice NamehouseNumber
                              Definition

                              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 Address datatype.

                              ShorthouseNumber
                              Control0..1
                              This element is affected by the following invariants: ele-1
                              TypeExtension(ADXP-houseNumber) (Extension Type: string)
                              Requirements

                              Basisregistratie Persoonsgegevens 11.20 Huisnummer

                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                              44. Address.line.extension:houseNumber.id
                              Definition

                              unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                              Shortxml:id (or equivalent in JSON)
                              Control0..1
                              Typestring
                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                              XML FormatIn the XML format, this property is represented as an attribute.
                              46. Address.line.extension:houseNumber.extension
                              Definition

                              May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                              ShortAdditional Content defined by implementations
                              Comments

                              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                              Control0..*
                              TypeExtension
                              Alternate Namesextensions, user content
                              SlicingThis element introduces a set of slices on Address.line.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                              • value @ url
                              • 48. Address.line.extension:houseNumber.url
                                Definition

                                Source of the definition for the extension code - a logical name or a URL.

                                Shortidentifies the meaning of the extension
                                Comments

                                The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                                Control1..1
                                Typeuri
                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                XML FormatIn the XML format, this property is represented as an attribute.
                                Fixed Valuehttp://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber
                                50. Address.line.extension:houseNumber.valueString:valueString
                                Slice NamevalueString
                                Definition

                                Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                                ShortValue of extension
                                Control0..1
                                Typestring
                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                52. Address.line.extension:buildingNumbersuffix
                                Slice NamebuildingNumbersuffix
                                Definition

                                HouseNumberLetter - A letter following the house number as assigned by the municipal authorities.

                                HouseNumberAddition - The letters or signs needed to locate the mailbox, in addition to the house number and letter.

                                ShortbuildingNumberSuffix
                                Comments

                                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
                                Control0..*
                                This element is affected by the following invariants: ele-1
                                TypeExtension(ADXP-buildingNumberSuffix) (Extension Type: string)
                                Requirements

                                Basisregistratie Persoonsgegevens 11.30 Huisletter 11.40 Huisnummertoevoeging 12.10 Locatieomschrijving

                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                                ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                54. Address.line.extension:buildingNumbersuffix.id
                                Definition

                                unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                Shortxml:id (or equivalent in JSON)
                                Control0..1
                                Typestring
                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                XML FormatIn the XML format, this property is represented as an attribute.
                                56. Address.line.extension:buildingNumbersuffix.extension
                                Definition

                                May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                ShortAdditional Content defined by implementations
                                Comments

                                There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                Control0..*
                                TypeExtension
                                Alternate Namesextensions, user content
                                SlicingThis element introduces a set of slices on Address.line.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                • value @ url
                                • 58. Address.line.extension:buildingNumbersuffix.url
                                  Definition

                                  Source of the definition for the extension code - a logical name or a URL.

                                  Shortidentifies the meaning of the extension
                                  Comments

                                  The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                                  Control1..1
                                  Typeuri
                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                  XML FormatIn the XML format, this property is represented as an attribute.
                                  Fixed Valuehttp://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix
                                  60. Address.line.extension:buildingNumbersuffix.valueString:valueString
                                  Slice NamevalueString
                                  Definition

                                  Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                                  ShortValue of extension
                                  Control0..1
                                  Typestring
                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                  62. Address.line.extension:unitID
                                  Slice NameunitID
                                  Definition

                                  Extra information such as the building name, building number, entrance, route number.

                                  ShortunitID
                                  Control0..1
                                  This element is affected by the following invariants: ele-1
                                  TypeExtension(ADXP-unitID) (Extension Type: string)
                                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                                  ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                  64. Address.line.extension:unitID.id
                                  Definition

                                  unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                  Shortxml:id (or equivalent in JSON)
                                  Control0..1
                                  Typestring
                                  Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                  XML FormatIn the XML format, this property is represented as an attribute.
                                  66. Address.line.extension:unitID.extension
                                  Definition

                                  May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                  ShortAdditional Content defined by implementations
                                  Comments

                                  There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                  Control0..*
                                  TypeExtension
                                  Alternate Namesextensions, user content
                                  SlicingThis element introduces a set of slices on Address.line.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                  • value @ url
                                  • 68. Address.line.extension:unitID.url
                                    Definition

                                    Source of the definition for the extension code - a logical name or a URL.

                                    Shortidentifies the meaning of the extension
                                    Comments

                                    The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                                    Control1..1
                                    Typeuri
                                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                    XML FormatIn the XML format, this property is represented as an attribute.
                                    Fixed Valuehttp://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitID
                                    70. Address.line.extension:unitID.valueString:valueString
                                    Slice NamevalueString
                                    Definition

                                    Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                                    ShortValue of extension
                                    Control0..1
                                    Typestring
                                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                    72. Address.line.extension:additionalLocator
                                    Slice NameadditionalLocator
                                    Definition

                                    HouseNumberIndication - The indication used for addresses that do not consist of the usual street name and house number.

                                    ShortadditionalLocator
                                    Control0..1
                                    This element is affected by the following invariants: ele-1
                                    TypeExtension(ADXP-additionalLocator) (Extension Type: string)
                                    Requirements

                                    Basisregistratie Persoonsgegevens 11.50 Aanduiding bij huisnummer

                                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                                    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                    74. Address.line.extension:additionalLocator.id
                                    Definition

                                    unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                    Shortxml:id (or equivalent in JSON)
                                    Control0..1
                                    Typestring
                                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                    XML FormatIn the XML format, this property is represented as an attribute.
                                    76. Address.line.extension:additionalLocator.extension
                                    Definition

                                    May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                    ShortAdditional Content defined by implementations
                                    Comments

                                    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                    Control0..*
                                    TypeExtension
                                    Alternate Namesextensions, user content
                                    SlicingThis element introduces a set of slices on Address.line.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                    • value @ url
                                    • 78. Address.line.extension:additionalLocator.url
                                      Definition

                                      Source of the definition for the extension code - a logical name or a URL.

                                      Shortidentifies the meaning of the extension
                                      Comments

                                      The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                                      Control1..1
                                      Typeuri
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      XML FormatIn the XML format, this property is represented as an attribute.
                                      Fixed Valuehttp://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator
                                      80. Address.line.extension:additionalLocator.valueString:valueString
                                      Slice NamevalueString
                                      Definition

                                      Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                                      ShortValue of extension
                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      82. Address.line.value
                                      Definition

                                      The actual value

                                      ShortPrimitive value for string
                                      Control0..1
                                      Typestring
                                      XML FormatIn the XML format, this property is represented as an attribute.
                                      Max Length:1048576
                                      84. Address.city
                                      Definition

                                      The name of the city, town, village or other community or delivery center.

                                      ShortName of city, town etc.
                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      Requirements

                                      Basisregistratie Persoonsgegevens 11.70 Woonplaatsnaam

                                      Alternate NamesMunicpality, Municipality, woonplaats
                                      ExampleGeneral: Erewhon
                                      Example city: Den Haag
                                      86. Address.district
                                      Definition

                                      The name of the administrative area (county).

                                      ShortDistrict name (aka county)
                                      Comments

                                      District is sometimes known as county, but in some regions 'county' is used in place of city (municipality), so county name should be conveyed in city instead. In a Dutch address this element is used for the population of a "gemeente"

                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      Requirements

                                      Basisregistratie Persoonsgegevens 09.10 Gemeente van inschrijving

                                      Alternate NamesCounty, Gemeente
                                      ExampleGeneral: Madison
                                      Example district: Wateringen
                                      88. Address.state
                                      Definition

                                      Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (i.e. US 2 letter state codes). For Dutch addresses this element should contain the "provincie" code

                                      ShortSub-unit of country (abbreviations ok).
                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      Requirements

                                      Some (Dutch) cities have the same name in multiple provinces. Dutch examples include Bergen (Noord-Holland / Limburg) and Geesteren (Gelderland / Overijssel).

                                      Alternate NamesProvince, Territory, Provincie
                                      ExampleExample province: ZH
                                      90. Address.postalCode
                                      Definition

                                      A postal code designating a region defined by the postal service.

                                      ShortPostal code for area
                                      Comments

                                      Dutch postal codes have pattern '\d{4}[A-Z]{2}' so they do not have spaces. Systems can easily render postal codes with a space if necessary.

                                      Control0..1
                                      This element is affected by the following invariants: nl-postal-code-pattern
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      Alternate NamesZip, Postcode
                                      ExampleGeneral: 9132
                                      Example postcode: 9132AG
                                      Invariantsnl-postal-code-pattern: Dutch postal code pattern 'nnnnAA' ((country in 'nl' | 'nld' | 'nederland').not() or matches('^\\d{4}[A-Z]{2}$'))
                                      92. Address.country
                                      Definition

                                      Country in which the address is located.

                                      ShortCountry
                                      Comments

                                      The FHIR datatype does not properly support coding the country using a CodeableConcept or Coding datatype. If the sender supports coded countries, it SHALL send the coded value using the code-specification extension under Address.country.

                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      Summarytrue
                                      Alternate NamesLand
                                      ExampleExample country: NLD
                                      94. Address.country.id
                                      Definition

                                      unique id for the element within a resource (for internal references)

                                      Shortxml:id (or equivalent in JSON)
                                      Control0..1
                                      Typestring
                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                      XML FormatIn the XML format, this property is represented as an attribute.
                                      96. Address.country.extension
                                      Definition

                                      An Extension

                                      ShortExtension
                                      Control0..*
                                      TypeExtension
                                      SlicingThis element introduces a set of slices on Address.country.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                      • value @ url
                                      • 98. Address.country.extension:countryCode
                                        Slice NamecountryCode
                                        Definition

                                        Defines a more specific coded value for a code or string. Especially useful for FHIR's required ValueSets. These extensions are primarily used on codes bound to a required value set, where you would like to use a more specific code than the codes in the bounded value set.

                                        ShortCountryGBACode | CountryISOCode
                                        Control0..1
                                        This element is affected by the following invariants: ele-1
                                        TypeExtension(HCIM extension code-specification) (Extension Type: CodeableConcept)
                                        Alternate NamesBevat de specifieke code conform de zib, bij een FHIR-element die een verplichte koppeling heeft met een bepaalde FHIR waardelijst of een FHIR element die niet gecodeerd is gedefinieerd, terwijl de zib dit wel doet.
                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() | (children().count() > id.count()))
                                        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                        100. Address.country.extension:countryCode.id
                                        Definition

                                        unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                        Shortxml:id (or equivalent in JSON)
                                        Control0..1
                                        Typestring
                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                        XML FormatIn the XML format, this property is represented as an attribute.
                                        102. Address.country.extension:countryCode.extension
                                        Definition

                                        May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                        ShortAdditional Content defined by implementations
                                        Comments

                                        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                        Control0..*
                                        TypeExtension
                                        Alternate Namesextensions, user content
                                        SlicingThis element introduces a set of slices on Address.country.extension.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                        • value @ url
                                        • 104. Address.country.extension:countryCode.url
                                          Definition

                                          Source of the definition for the extension code - a logical name or a URL.

                                          Shortidentifies the meaning of the extension
                                          Comments

                                          The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

                                          Control1..1
                                          Typeuri
                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                          XML FormatIn the XML format, this property is represented as an attribute.
                                          Fixed Valuehttp://nictiz.nl/fhir/StructureDefinition/code-specification
                                          106. Address.country.extension:countryCode.value[x]
                                          Definition

                                          Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                                          ShortValue of extension
                                          Control1..1
                                          TypeCodeableConcept
                                          [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                                          SlicingThis element introduces a set of slices on Address.country.extension.value[x]. The slices areUnordered and Closed, and can be differentiated using the following discriminators:
                                          • type @ $this
                                          • 108. Address.country.extension:countryCode.value[x]:valueCodeableConcept
                                            Slice NamevalueCodeableConcept
                                            Definition

                                            Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).

                                            ShortCountryGBACode | CountryISOCode
                                            Control1..1
                                            TypeCodeableConcept
                                            [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                                            Alternate NamesLandGBACodelijst, LandISOCodelijst
                                            110. Address.country.extension:countryCode.value[x]:valueCodeableConcept.id
                                            Definition

                                            unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                            Shortxml:id (or equivalent in JSON)
                                            Control0..1
                                            Typestring
                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                            XML FormatIn the XML format, this property is represented as an attribute.
                                            112. Address.country.extension:countryCode.value[x]:valueCodeableConcept.extension
                                            Definition

                                            May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                            ShortAdditional Content defined by implementations
                                            Comments

                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                            Control0..*
                                            TypeExtension
                                            Alternate Namesextensions, user content
                                            SlicingThis element introduces a set of slices on Address.country.extension.value[x].extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                            • value @ url
                                            • 114. Address.country.extension:countryCode.value[x]:valueCodeableConcept.coding
                                              Definition

                                              A reference to a code defined by a terminology system.

                                              ShortCode defined by a terminology system
                                              Comments

                                              Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

                                              Control1..*
                                              TypeCoding
                                              Summarytrue
                                              Requirements

                                              Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

                                              SlicingThis element introduces a set of slices on Address.country.extension.value[x].coding. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                              • pattern @ $this
                                              • 116. Address.country.extension:countryCode.value[x]:valueCodeableConcept.coding:countryGBACodelist
                                                Slice NamecountryGBACodelist
                                                Definition

                                                A reference to a code defined by a terminology system.

                                                ShortCode defined by a terminology system
                                                Comments

                                                Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

                                                Control0..*
                                                BindingUnless not suitable, these codes SHALL be taken from LandGBACodelijst
                                                (extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.1--20171231000000)

                                                LandGBACodelijst

                                                TypeCoding
                                                Summarytrue
                                                Requirements

                                                Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

                                                Pattern Value{
                                                  "system" : "urn:oid:2.16.840.1.113883.2.4.4.16.34"
                                                }
                                                118. Address.country.extension:countryCode.value[x]:valueCodeableConcept.coding:countryISOCodelist
                                                Slice NamecountryISOCodelist
                                                Definition

                                                A reference to a code defined by a terminology system.

                                                ShortCode defined by a terminology system
                                                Comments

                                                Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.

                                                Control0..*
                                                BindingUnless not suitable, these codes SHALL be taken from LandISOCodelijst
                                                (extensible to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.2--20171231000000)

                                                LandISOCodelijst

                                                TypeCoding
                                                Summarytrue
                                                Requirements

                                                Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings.

                                                Pattern Value{
                                                  "system" : "urn:iso:std:iso:3166"
                                                }
                                                120. Address.country.extension:countryCode.value[x]:valueCodeableConcept.text
                                                Definition

                                                A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

                                                ShortPlain text representation of the concept
                                                Comments

                                                Very often the text is the same as a displayName of one of the codings.

                                                Control0..1
                                                Typestring
                                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                Summarytrue
                                                Requirements

                                                The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source.

                                                122. Address.country.value
                                                Definition

                                                The actual value

                                                ShortPrimitive value for string
                                                Control0..1
                                                Typestring
                                                XML FormatIn the XML format, this property is represented as an attribute.
                                                Max Length:1048576
                                                124. Address.period
                                                Definition

                                                Time period when address was/is in use.

                                                ShortTime period when address was/is in use
                                                Control0..1
                                                TypePeriod
                                                Summarytrue
                                                Requirements

                                                Allows addresses to be placed in historical context.

                                                ExampleGeneral: { "start" : "2010-03-23", "end" : "2010-07-01" }