<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="HdBe-AddressInformation" />
  <meta>
    <lastUpdated value="2023-05-08T17:10:13.4826628+00:00" />
  </meta>
  <url value="https://fhir.healthdata.be/StructureDefinition/HdBe-AddressInformation" />
  <name value="HdBeAddressInformation" />
  <title value="HdBe AddressInformation" />
  <status value="draft" />
  <publisher value="Healthdata.be (Sciensano)" />
  <contact>
    <name value="Service portal – healthdata.be" />
    <telecom>
      <system value="url" />
      <value value="https://sciensano.service-now.com/sp" />
      <use value="work" />
    </telecom>
  </contact>
  <description value="Address information includes data where a person resides (temporarily, permanently) or where a building is located." />
  <copyright value="Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise." />
  <fhirVersion value="4.0.1" />
  <mapping>
    <identity value="zib-addressinformation-v1.1-2020EN" />
    <uri value="https://zibs.nl/wiki/AddressInformation-v1.1(2020EN)" />
    <name value="zib AddressInformation-v1.1(2020EN)" />
  </mapping>
  <mapping>
    <identity value="HdBe-AddressInformation" />
    <uri value="https://fhir.healthdata.be/StructureDefinition/LogicalModel/HdBe-AddressInformation" />
    <name value="HdBe logical model AddressInformation" />
  </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="AddressInformation" />
      <definition value="This datatype defines a common basis for expressing all addresses around the world, but adds extensions to express Belgium addresses specifically, according to the CBB AddressInformation. A Belgian 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 Belgium context, the implementer SHOULD in addition use the extension element.&#xD;&#xA;&#xD;&#xA;**Separate address parts**&#xD;&#xA;&#xD;&#xA;The first addition is that Belgium addresses make certain address parts separately communicable. These parts are required for use in true Belgian systems when dealing with Belgian addresses, but may not have value for international systems when information gets sent abroad." />
      <alias value="Adresgegevens" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.1" />
        <comment value="AddressInformation" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map 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="1" />
    </element>
    <element id="Address.extension:language">
      <path value="Address.extension" />
      <sliceName value="language" />
      <min value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/language" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Address.use">
      <path value="Address.use" />
      <short value="AddressType" />
      <definition value="The type of address in question, such as a home address or mailing address." />
      <alias value="AdresSoort" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.8" />
        <comment value="AddressType" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.AddressUse" />
      </mapping>
    </element>
    <element id="Address.type">
      <path value="Address.type" />
      <short value="AddressType" />
      <definition value="The type of address in question, such as a home address or mailing address." />
      <alias value="AdresSoort" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.8" />
        <comment value="AddressType" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.AddressType" />
      </mapping>
    </element>
    <element id="Address.line">
      <path value="Address.line" />
      <comment value="The elements of Address stored in the address-part extensions will be ignored by applications that do not support them, so any information in them should also be duplicated in the `Address.line` to which they are attached. The value of `Address.line` should be populated with a complete string representation of all the separate extension values, like: &quot;[Street] [HouseNumberIndication] [HouseNumber] [HouseNumberLetter] [HouseNumberAddition]&quot;." />
    </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" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName" />
      </type>
    </element>
    <element id="Address.line.extension:streetName.value[x]">
      <path value="Address.line.extension.value[x]" />
      <short value="Street" />
      <definition value="Street name of the address." />
      <alias value="Straat" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.2" />
        <comment value="Street" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.Street" />
      </mapping>
    </element>
    <element id="Address.line.extension:houseNumber">
      <path value="Address.line.extension" />
      <sliceName value="houseNumber" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber" />
      </type>
    </element>
    <element id="Address.line.extension:houseNumber.value[x]">
      <path value="Address.line.extension.value[x]" />
      <short value="HouseNumber" />
      <definition value="House number of the address." />
      <alias value="Huisnummer" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.12" />
        <comment value="HouseNumber" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.HouseNumber" />
      </mapping>
    </element>
    <element id="Address.line.extension:houseNumberLetter-houseNumberAddition">
      <path value="Address.line.extension" />
      <sliceName value="houseNumberLetter-houseNumberAddition" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix" />
      </type>
    </element>
    <element id="Address.line.extension:houseNumberLetter-houseNumberAddition.value[x]">
      <path value="Address.line.extension.value[x]" />
      <short value="HouseNumberLetter / HouseNumberAddition" />
      <definition value="Export:&#xD;&#xA;&#xD;&#xA;- If a HouseNumberLetter as well as a HouseNumberAddition is known: HouseNumberLetter first, followed by a space and finally the HouseNumberAddition.&#xD;&#xA;- If only a HouseNumberLetter is known, send just that. No trailing space is required.&#xD;&#xA;- If only a HouseNumberAddition 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 HouseNumberLetter.&#xD;&#xA;- If the value of buildingNumberSuffix contains a space, then everything before the first space is considered to be the HouseNumberLetter, and the everything trailing the first space is considered to be the HouseNumberAddition.&#xD;&#xA;&#xD;&#xA;Note: While a leading space is allowed in string values in FHIR, the parsing of such space cannot be guaranteed in XML representations. Although aware of this issue, this mapping is not changed because of compatibility reasons. If an implementer cannot parse a leading space, the practical risk of mapping a HouseNumberIndication to a HouseNumberAddition is deemed insignificant." />
      <alias value="Huisnummerletter" />
      <alias value="Huisnummertoevoeging" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.11" />
        <comment value="HouseNumberLetter" />
      </mapping>
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.10" />
        <comment value="HouseNumberAddition" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.HouseNumberLetter" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.HouseNumberAddition" />
      </mapping>
    </element>
    <element id="Address.line.extension:houseNumberIndication">
      <path value="Address.line.extension" />
      <sliceName value="houseNumberIndication" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator" />
      </type>
    </element>
    <element id="Address.line.extension:houseNumberIndication.value[x]">
      <path value="Address.line.extension.value[x]" />
      <short value="HouseNumberIndication" />
      <definition value="The indication used for addresses which do not consist of the usual street name and house number." />
      <comment value="The coded HouseNumberIndication concept (CD datatype) is mapped to a FHIR string datatype with a constraint added (the value can only be 'by' or 'to')." />
      <alias value="AanduidingBijNummer" />
      <constraint>
        <key value="houseNumberIndication" />
        <severity value="error" />
        <human value="Must have value 'by' or 'to'" />
        <expression value="value in ('by' | 'to')" />
      </constraint>
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.9" />
        <comment value="HouseNumberIndication" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.HouseNumberIndication" />
      </mapping>
    </element>
    <element id="Address.line.extension:additionalInformation">
      <path value="Address.line.extension" />
      <sliceName value="additionalInformation" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitID" />
      </type>
    </element>
    <element id="Address.line.extension:additionalInformation.value[x]">
      <path value="Address.line.extension.value[x]" />
      <short value="AdditionalInformation" />
      <alias value="AdditioneleInformatie" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.7" />
        <comment value="AdditionalInformation" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.AdditionalInformation" />
      </mapping>
    </element>
    <element id="Address.city">
      <path value="Address.city" />
      <short value="PlaceOfResidence" />
      <definition value="A geographically determined area which forms part of the municipal area." />
      <alias value="Woonplaats" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.3" />
        <comment value="PlaceOfResidence" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.PlaceOfResidence" />
      </mapping>
    </element>
    <element id="Address.district">
      <path value="Address.district" />
      <short value="Municipality" />
      <definition value="Municipality of residence." />
      <alias value="Gemeente" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.4" />
        <comment value="Municipality" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.Municipality" />
      </mapping>
    </element>
    <element id="Address.postalCode">
      <path value="Address.postalCode" />
      <short value="Postcode" />
      <definition value="Postcode of the address." />
      <alias value="Postcode" />
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.6" />
        <comment value="Postcode" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.Postcode" />
      </mapping>
    </element>
    <element id="Address.country">
      <path value="Address.country" />
      <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 CodeSpecification extension under `Address.country.extension:countryCode`." />
    </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" />
      <min value="0" />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="https://fhir.healthdata.be/StructureDefinition/ext-CodeSpecification" />
      </type>
    </element>
    <element id="Address.country.extension:countryCode.value[x]">
      <path value="Address.country.extension.value[x]" />
      <short value="Country" />
      <definition value="Country in which the address is located." />
      <alias value="Land" />
      <binding>
        <strength value="required" />
        <description value="Iso 3166 Part 1: 2 Letter Codes" />
        <valueSet value="https://fhir.healthdata.be/ValueSet/CountryISO" />
      </binding>
      <mapping>
        <identity value="zib-addressinformation-v1.1-2020EN" />
        <map value="NL-CM:20.5.5" />
        <comment value="Country" />
      </mapping>
      <mapping>
        <identity value="HdBe-AddressInformation" />
        <map value="AddressInformation.Country" />
      </mapping>
    </element>
  </differential>
</StructureDefinition>