<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="nl-core-address" />
  <url value="http://fhir.nl/fhir/StructureDefinition/nl-core-address" />
  <version value="3.0.6" />
  <name value="nl-core-address" />
  <title value="nl-core-address" />
  <status value="active" />
  <publisher value="HL7 Netherlands" />
  <contact>
    <name value="Nictiz" />
    <telecom>
      <system value="url" />
      <value value="https://www.nictiz.nl" />
      <use value="work" />
    </telecom>
  </contact>
  <description value="Base StructureDefinition for Address Type with additions for Dutch realm addresses. Dutch addresses break down Address.line in several parts and it is important to mark an address as being 'officially registered'." />
  <purpose value="Address information is used for visiting a person or organization and for addressing of mail." />
  <copyright value="CC0" />
  <fhirVersion value="3.0.2" />
  <mapping>
    <identity value="hcim-addressinformation-v1.0-2017EN" />
    <uri value="https://zibs.nl/wiki/AddressInformation-v1.0(2017EN)" />
    <name value="HCIM AddressInformation-v1.0(2017EN)" />
  </mapping>
  <mapping>
    <identity value="hcim-addressinformation-v3.0-2016EN" />
    <uri value="https://zibs.nl/wiki/Patient-v3.0(2016EN)" />
    <name value="AddressInformation as part of HCIM Patient-v3.0(2016EN)" />
    <comment value="AddressInformation has become an independent information model as of release 2017 of the HCIMs" />
  </mapping>
  <mapping>
    <identity value="hcim-address-v2.0.1-2015EN" />
    <uri value="https://zibs.nl/wiki/Patient-v2.0.1(2015EN)" />
    <name value="AddressInformation as part of HCIM Patient-v2.0.1(2015EN)" />
    <comment value="AddressInformation has become an independent information model as of release 2017 of the HCIMs" />
  </mapping>
  <mapping>
    <identity value="BRP" />
    <uri value="https://nl.wikipedia.org/wiki/Basisregistratie_Personen" />
    <name value="Basisregistratie Personen" />
    <comment value="Voorheen GBA - Gemeentelijke basisregistratie" />
  </mapping>
  <kind value="complex-type" />
  <abstract value="false" />
  <type value="Address" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Address" />
  <derivation value="constraint" />
  <differential>
    <element id="Address">
      <path value="Address" />
      <short value="Address information" />
      <definition value="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.&#xD;&#xA;&#xD;&#xA;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.&#xD;&#xA;&#xD;&#xA;**Separate address parts**&#xD;&#xA;&#xD;&#xA;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.&#xD;&#xA;&#xD;&#xA;**Custom address types**&#xD;&#xA;&#xD;&#xA;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 &lt;http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse&gt; and &lt;http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType&gt; as well). The HCIM code itself should also be included using the AddressType extension.&#xD;&#xA;&#xD;&#xA;| HCIM                              |` .ext:AddressType` | `.ext:official` | `.use` | `.type`    |&#xD;&#xA;|-----------------------------------|:------------------:|:---------------:|:------:|:----------:|&#xD;&#xA;| Postal Address/Postadres          | _PST_              |                 |        | _postal_   |&#xD;&#xA;| Primary Home/Officieel adres      | _HP_               | true            | _home_ |            |&#xD;&#xA;| Visit Address/Woon-/verblijfadres | _PHYS_             |                 | _home_ | _physical_ |&#xD;&#xA;| Temporary Address/Tijdelijk adres | _TMP_              |                 | _temp_ |            |&#xD;&#xA;| Work Place/Werkadres              | _WP_               |                 | _work_ |            |&#xD;&#xA;| Vacation Home/Vakantie adres      | _HV_               |                 | _temp_ |            |&#xD;&#xA;&#xD;&#xA; 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.&#xD;&#xA;&#xD;&#xA;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." />
      <alias value="AdresInformatie" />
      <example>
        <label value="Example of a Vacation Home address" />
        <valueAddress>
          <extension url="http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType">
            <valueCodeableConcept>
              <coding>
                <system value="http://hl7.org/fhir/v3/AddressUse" />
                <code value="HV" />
                <display value="Vakantie adres" />
              </coding>
            </valueCodeableConcept>
          </extension>
          <use value="temp" />
          <line value="Binnenkant 12A Hoog">
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
              <valueString value="Binnenkant" />
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
              <valueString value="12" />
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix">
              <valueString value="A" />
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitID">
              <valueString value="Hoog" />
            </extension>
          </line>
          <city value="Amsterdam" />
          <state value="NH" />
          <postalCode value="1000AA" />
          <country value="NLD" />
        </valueAddress>
      </example>
      <example>
        <label value="Example of a Primary Home address" />
        <valueAddress>
          <extension url="http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType">
            <valueCodeableConcept>
              <coding>
                <system value="http://hl7.org/fhir/v3/AddressUse" />
                <code value="HP" />
                <display value="Officieel adres" />
              </coding>
            </valueCodeableConcept>
          </extension>
          <extension url="http://fhir.nl/fhir/StructureDefinition/nl-core-address-official">
            <valueBoolean value="true" />
          </extension>
          <use value="home" />
          <line value="Binnenkant to 10">
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
              <valueString value="Binnenkant" />
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator">
              <valueString value="to" />
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
              <valueString value="10" />
            </extension>
          </line>
          <city value="Amsterdam" />
          <state value="NH" />
          <postalCode value="1001AA" />
          <country value="NLD" />
        </valueAddress>
      </example>
      <condition value="nl-streetname-if-official-and-other-line-parts" />
      <constraint>
        <key value="nl-streetname-if-official-and-other-line-parts" />
        <requirements value="This constraint checks conformance against the Dutch BRP constraints on address parts. However: when you only send postalCode + houseNumber which is enough for certain cases this may still be a valid address" />
        <severity value="error" />
        <human value="Address.streetName in an official address SHALL have a value if one of houseNumber|buildingNumberSuffix|additionalLocator has a value" />
        <expression 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()))" />
        <xpath value="not(.[f:extension[@url='http://fhir.nl/fhir/StructureDefinition/nl-core-address-official'][f:valueBoolean/@value='true']][f:line[empty(f:extension[@url='http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName'])][f:extension[@url=('http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber','http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix','http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator')]]])" />
      </constraint>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.4" />
        <comment value="AddressInformation" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.4" />
        <comment value="AddressInformation" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.1" />
        <comment value="AddressInformation" />
      </mapping>
    </element>
    <element id="Address.extension">
      <path value="Address.extension" />
      <slicing>
        <discriminator>
          <type value="value" />
          <path value="url" />
        </discriminator>
        <rules value="open" />
      </slicing>
      <min value="0" />
    </element>
    <element id="Address.extension:AddressType">
      <path value="Address.extension" />
      <sliceName value="AddressType" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://nictiz.nl/fhir/StructureDefinition/zib-AddressInformation-AddressType" />
      </type>
    </element>
    <element id="Address.extension:AddressType.valueCodeableConcept:valueCodeableConcept">
      <path value="Address.extension.valueCodeableConcept" />
      <sliceName value="valueCodeableConcept" />
      <short value="AddressType" />
      <definition value="The type of address in question, such as a home address or mailing address." />
      <comment value="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.&#xD;&#xA;&#xD;&#xA;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." />
      <alias value="AdresSoort" />
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.11" />
        <comment value="AddressType" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.11" />
        <comment value="AddressType" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.8" />
        <comment value="AddressType" />
      </mapping>
    </element>
    <element id="Address.extension:official">
      <path value="Address.extension" />
      <sliceName value="official" />
      <short value="Mark an address as an 'officially registered' address." />
      <definition value="Mark an address as an 'officially registered' address. In Dutch context that means it is registered in the Basisregistratie persoonsgegevens (BRP)" />
      <alias value="Markeer een adres als een 'officieel geregistreerd adres." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-address-official" />
      </type>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.11" />
        <comment value="AddressType" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.11" />
        <comment value="AddressType" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.8" />
        <comment value="AddressType" />
      </mapping>
    </element>
    <element id="Address.use">
      <path value="Address.use" />
      <definition value="Purpose of this address" />
      <binding>
        <strength value="required" />
        <valueSetReference>
          <extension url="http://hl7.org/fhir/StructureDefinition/11179-permitted-value-conceptmap">
            <valueReference>
              <reference value="http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse" />
              <display value="AdresSoortCodelijst-to-AddressUse" />
            </valueReference>
          </extension>
        </valueSetReference>
      </binding>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.11" />
        <comment value="AddressType. See for details the ConceptMap http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse" />
      </mapping>
      <mapping>
        <identity value="hcim-address-v3.0-2016EN" />
        <map value="NL-CM:0.1.11" />
        <comment value="AddressType. See for details the ConceptMap http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.8" />
        <comment value="AddressType. See for details the ConceptMap http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse" />
      </mapping>
    </element>
    <element id="Address.type">
      <path value="Address.type" />
      <binding>
        <strength value="required" />
        <valueSetReference>
          <extension url="http://hl7.org/fhir/StructureDefinition/11179-permitted-value-conceptmap">
            <valueReference>
              <reference value="http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType" />
              <display value="AdresSoortCodelijst-to-AddressType" />
            </valueReference>
          </extension>
        </valueSetReference>
      </binding>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.11" />
        <comment value="AddressType. See for details the ConceptMap http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType" />
      </mapping>
      <mapping>
        <identity value="hcim-address-v3.0-2016EN" />
        <map value="NL-CM:0.1.11" />
        <comment value="AddressType. See for details the ConceptMap http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.8" />
        <comment value="AddressType. See for details the ConceptMap http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType" />
      </mapping>
    </element>
    <element id="Address.line.extension">
      <path value="Address.line.extension" />
      <slicing>
        <discriminator>
          <type value="value" />
          <path value="url" />
        </discriminator>
        <rules value="open" />
      </slicing>
      <min value="0" />
    </element>
    <element id="Address.line.extension:streetName">
      <path value="Address.line.extension" />
      <sliceName value="streetName" />
      <definition value="Street name. If the address is a P.O. Box then the Dutch word &quot;Postbus&quot; shall be communicated. If the address is an answer number (mailing address where the receiver pays postage) then the Dutch word &quot;Antwoordnummer&quot; shall be communicated." />
      <requirements value="Basisregistratie Persoonsgegevens 11.10 Straatnaam" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName" />
      </type>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.12" />
        <comment value="Street" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.12" />
        <comment value="Street" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.2" />
        <comment value="Street" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="11.10" />
        <comment value="Straatnaam" />
      </mapping>
    </element>
    <element id="Address.line.extension:streetName.valueString:valueString">
      <path value="Address.line.extension.valueString" />
      <sliceName value="valueString" />
    </element>
    <element id="Address.line.extension:houseNumber">
      <path value="Address.line.extension" />
      <sliceName value="houseNumber" />
      <definition value="The element houseNumber shall contain the house number. The house number may contains non-numeric parts that further determine the address, e.g. &quot;23a&quot;, but only if the source system cannot discretely communicate those. House letter shall, if possible, be communicated through the element buildingNumberSuffix. Information such as &quot;to&quot; (house boats that do not have their own house number, but are across (tegenover) a house with a house number or &quot;3 hoog achter&quot; are not part of this attribute. This type of information is conveyed elsewhere in the Address datatype." />
      <requirements value="Basisregistratie Persoonsgegevens 11.20 Huisnummer" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber" />
      </type>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.13" />
        <comment value="HouseNumber" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.13" />
        <comment value="HouseNumber" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.12" />
        <comment value="HouseNumber" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="11.20" />
        <comment value="Huisnummer" />
      </mapping>
    </element>
    <element id="Address.line.extension:houseNumber.valueString:valueString">
      <path value="Address.line.extension.valueString" />
      <sliceName value="valueString" />
    </element>
    <element id="Address.line.extension:buildingNumbersuffix">
      <path value="Address.line.extension" />
      <sliceName value="buildingNumbersuffix" />
      <definition value="HouseNumberLetter&#xD;&#xA;- A letter following the house number as assigned by the municipal authorities.&#xD;&#xA;&#xD;&#xA;HouseNumberAddition&#xD;&#xA;- The letters or signs needed to locate the mailbox, in addition to the house number and letter." />
      <comment value="Export&#xD;&#xA;&#xD;&#xA;- 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.&#xD;&#xA;- If only a house letter is known send just that. No trailing space is required.&#xD;&#xA;- If only a house letter suffix is known, communicate that with a leading space.&#xD;&#xA;&#xD;&#xA;Import&#xD;&#xA;&#xD;&#xA;- If the value of buildingNumberSuffix contains no space, then the whole value is considered to be the house letter&#xD;&#xA;- 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" />
      <requirements value="Basisregistratie Persoonsgegevens 11.30 Huisletter&#xD;&#xA;11.40 Huisnummertoevoeging&#xD;&#xA;12.10 Locatieomschrijving" />
      <min value="0" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix" />
      </type>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.40" />
        <comment value="HouseNumberLetter" />
      </mapping>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.41" />
        <comment value="HouseNumberAddition" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.40" />
        <comment value="HouseNumberLetter" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.41" />
        <comment value="HouseNumberAddition" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.11" />
        <comment value="HouseNumberLetter" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.10" />
        <comment value="HouseNumberAddition" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="11.30" />
        <comment value="Huisletter" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="11.40" />
        <comment value="Huisnummertoevoeging" />
      </mapping>
    </element>
    <element id="Address.line.extension:buildingNumbersuffix.valueString:valueString">
      <path value="Address.line.extension.valueString" />
      <sliceName value="valueString" />
    </element>
    <element id="Address.line.extension:unitID">
      <path value="Address.line.extension" />
      <sliceName value="unitID" />
      <definition value="Extra information such as the building name, building number, entrance, route number." />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitID" />
      </type>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.28" />
        <comment value="AdditionalInformation" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.28" />
        <comment value="AdditionalInformation" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.7" />
        <comment value="AdditionalInformation" />
      </mapping>
    </element>
    <element id="Address.line.extension:unitID.valueString:valueString">
      <path value="Address.line.extension.valueString" />
      <sliceName value="valueString" />
    </element>
    <element id="Address.line.extension:additionalLocator">
      <path value="Address.line.extension" />
      <sliceName value="additionalLocator" />
      <definition value="HouseNumberIndication - The indication used for addresses that do not consist of the usual street name and house number." />
      <requirements value="Basisregistratie Persoonsgegevens 11.50 Aanduiding bij huisnummer" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator" />
      </type>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.42" />
        <comment value="HouseNumberIndication" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.42" />
        <comment value="HouseNumberIndication" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.9" />
        <comment value="HouseNumberIndication" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="11.50" />
        <comment value="Aanduiding bij huisnummer" />
      </mapping>
    </element>
    <element id="Address.line.extension:additionalLocator.valueString:valueString">
      <path value="Address.line.extension.valueString" />
      <sliceName value="valueString" />
    </element>
    <element id="Address.city">
      <path value="Address.city" />
      <requirements value="Basisregistratie Persoonsgegevens 11.70 Woonplaatsnaam" />
      <alias value="Municipality" />
      <alias value="woonplaats" />
      <example>
        <label value="Example city" />
        <valueString value="Den Haag" />
      </example>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.14" />
        <comment value="Place of residence" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.14" />
        <comment value="Place of residence" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.3" />
        <comment value="PlaceOfResidence" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="11.70" />
        <comment value="Woonplaatsnaam" />
      </mapping>
    </element>
    <element id="Address.district">
      <path value="Address.district" />
      <comment value="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 &quot;gemeente&quot;" />
      <requirements value="Basisregistratie Persoonsgegevens 09.10 Gemeente van inschrijving" />
      <alias value="Gemeente" />
      <example>
        <label value="Example district" />
        <valueString value="Wateringen" />
      </example>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.16" />
        <comment value="Municipality" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.16" />
        <comment value="Municipality" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.4" />
        <comment value="Municipality" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="09.10" />
        <comment value="Gemeente van inschrijving" />
      </mapping>
    </element>
    <element id="Address.state">
      <path value="Address.state" />
      <short value="Sub-unit of country (abbreviations ok)." />
      <definition value="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 &quot;provincie&quot; code" />
      <requirements value="Some (Dutch) cities have the same name in multiple provinces. Dutch examples include Bergen (Noord-Holland / Limburg) and  Geesteren (Gelderland / Overijssel)." />
      <alias value="Provincie" />
      <example>
        <label value="Example province" />
        <valueString value="ZH" />
      </example>
    </element>
    <element id="Address.postalCode">
      <path value="Address.postalCode" />
      <comment value="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." />
      <alias value="Postcode" />
      <example>
        <label value="Example postcode" />
        <valueString value="9132AG" />
      </example>
      <condition value="nl-postal-code-pattern" />
      <constraint>
        <key value="nl-postal-code-pattern" />
        <severity value="error" />
        <human value="Dutch postal code pattern 'nnnnAA'" />
        <expression value="(country in 'nl' | 'nld' | 'nederland').not() or matches('^\\d{4}[A-Z]{2}$')" />
        <xpath value="not(../f:country[lower-case(@value)=('nl','nld','nederland')]) or matches(@value,'^\d{4}[A-Z]{2}$')" />
      </constraint>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.15" />
        <comment value="Postcode" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.15" />
        <comment value="Postcode" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.6" />
        <comment value="Postcode" />
      </mapping>
      <mapping>
        <identity value="BRP" />
        <map value="11.60" />
        <comment value="Postcode" />
      </mapping>
    </element>
    <element id="Address.country">
      <path value="Address.country" />
      <short value="Country" />
      <definition value="Country in which the address is located." />
      <comment value="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." />
      <alias value="Land" />
      <example>
        <label value="Example country" />
        <valueString value="NLD" />
      </example>
      <mapping>
        <identity value="hcim-address-v2.0.1-2015EN" />
        <map value="NL-CM:0.1.17" />
        <comment value="Country" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v3.0-2016EN" />
        <map value="NL-CM:0.1.17" />
        <comment value="Country" />
      </mapping>
      <mapping>
        <identity value="hcim-addressinformation-v1.0-2017EN" />
        <map value="NL-CM:20.5.5" />
        <comment value="Country" />
      </mapping>
    </element>
    <element id="Address.country.extension">
      <path value="Address.country.extension" />
      <slicing>
        <discriminator>
          <type value="value" />
          <path value="url" />
        </discriminator>
        <rules value="open" />
      </slicing>
      <min value="0" />
    </element>
    <element id="Address.country.extension:countryCode">
      <path value="Address.country.extension" />
      <sliceName value="countryCode" />
      <short value="CountryGBACode | CountryISOCode" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://nictiz.nl/fhir/StructureDefinition/code-specification" />
      </type>
    </element>
    <element id="Address.country.extension:countryCode.valueCodeableConcept:valueCodeableConcept">
      <path value="Address.country.extension.valueCodeableConcept" />
      <sliceName value="valueCodeableConcept" />
      <short value="CountryGBACode | CountryISOCode" />
      <alias value="LandGBACodelijst" />
      <alias value="LandISOCodelijst" />
    </element>
    <element id="Address.country.extension:countryCode.valueCodeableConcept:valueCodeableConcept.coding">
      <path value="Address.country.extension.valueCodeableConcept.coding" />
      <slicing>
        <discriminator>
          <type value="pattern" />
          <path value="$this" />
        </discriminator>
        <rules value="open" />
      </slicing>
      <min value="1" />
    </element>
    <element id="Address.country.extension:countryCode.valueCodeableConcept:valueCodeableConcept.coding:countryGBACodelist">
      <path value="Address.country.extension.valueCodeableConcept.coding" />
      <sliceName value="countryGBACodelist" />
      <patternCoding>
        <system value="urn:oid:2.16.840.1.113883.2.4.4.16.34" />
      </patternCoding>
      <binding>
        <strength value="extensible" />
        <description value="LandGBACodelijst" />
        <valueSetReference>
          <reference value="http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.1--20171231000000" />
          <display value="LandGBACodelijst" />
        </valueSetReference>
      </binding>
    </element>
    <element id="Address.country.extension:countryCode.valueCodeableConcept:valueCodeableConcept.coding:countryISOCodelist">
      <path value="Address.country.extension.valueCodeableConcept.coding" />
      <sliceName value="countryISOCodelist" />
      <patternCoding>
        <system value="urn:iso:std:iso:3166" />
      </patternCoding>
      <binding>
        <strength value="extensible" />
        <description value="LandISOCodelijst" />
        <valueSetReference>
          <reference value="http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.2--20171231000000" />
          <display value="LandISOCodelijst" />
        </valueSetReference>
      </binding>
    </element>
  </differential>
</StructureDefinition>