{ "description": "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'.", "_filename": "nl-core-address.json", "package_name": "nictiz.fhir.nl.stu3.zib2017", "date": null, "derivation": "constraint", "publisher": "HL7 Netherlands", "fhirVersion": "3.0.1", "purpose": "Address information is used for visiting a person or organization and for addressing of mail.", "name": "nl-core-address", "mapping": [ { "uri": "https://zibs.nl/wiki/Patient-v2.0.1(2015EN)", "name": "AddressInformation as part of HCIM Patient-v2.0.1(2015EN)", "comment": "AddressInformation has become an independent information model as of release 2017 of the HCIMs", "identity": "hcim-address-v2.0.1-2015EN" }, { "uri": "https://zibs.nl/wiki/Patient-v3.0(2016EN)", "name": "AddressInformation as part of HCIM Patient-v3.0(2016EN)", "comment": "AddressInformation has become an independent information model as of release 2017 of the HCIMs", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "uri": "https://zibs.nl/wiki/AddressInformation-v1.0(2017EN)", "name": "HCIM AddressInformation-v1.0.1(2017EN)", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "uri": "https://nl.wikipedia.org/wiki/Basisregistratie_Personen", "name": "Basisregistratie Personen", "comment": "Voorheen GBA - Gemeentelijke basisregistratie", "identity": "BRP" } ], "abstract": false, "copyright": "CC0", "type": "Address", "experimental": null, "resourceType": "StructureDefinition", "title": "nl-core-address", "package_version": "1.1.2", "status": "active", "id": "9485389a-882f-46eb-828e-6c4df3564bc9", "kind": "complex-type", "url": "http://fhir.nl/fhir/StructureDefinition/nl-core-address", "version": "2.0.2", "differential": { "element": [ { "constraint": [ { "key": "nl-streetname-if-official-and-other-line-parts", "human": "Address.streetName in an official address SHALL have a value if one of houseNumber|buildingNumberSuffix|additionalLocator has a value", "xpath": "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')]]])", "severity": "error", "expression": "(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()))", "requirements": "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" } ], "path": "Address", "definition": "There is a variety of postal address formats defined around the world. This format defines a superset that is the basis for all addresses around the world and adds all relevant components to express Dutch addresses.\r\n\r\nA Dutch Address is a proper FHIR Address. Systems that do not understand any of the extensions, will be able to render and work with a Dutch address. 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.\r\n\r\nTo 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.\r\n\r\nThe HCIM defines certain address types in the AdresSoortCodelijst. These do not all have a one to one mapping in the FHIR Address datatype. The following explains how to deal with that.\r\n\r\nHCIM Postal Address maps to Address.type 'postal'; \r\n\r\nHCIM Primary Home Address maps to Address.extension:official 'true' + Address.use 'home' + Address.use.extension 'HP'; \r\n\r\nHCIM Visit Address (Woon-/verblijfadres) maps to Address.use 'home' + Address.type 'physical' + Address.use.extension 'PHYS'; \r\n\r\nHCIM Temporary Address maps to Address.use 'temp'; \r\n\r\nHCIM Work Place Address maps to Address.use 'work'; \r\n\r\nHCIM Vacation Home Address maps to Address.use 'temp' + Address.use.extension 'HV'.\r\n\r\nIf 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.", "short": "Address information", "mapping": [ { "map": "NL-CM:0.1.4", "comment": "AddressInformation", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.4", "comment": "AddressInformation", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.1", "comment": "AddressInformation", "identity": "hcim-addressinformation-v1.0-2017EN" } ], "alias": [ "AdresInformatie" ], "id": "Address", "condition": [ "nl-streetname-if-official-and-other-line-parts" ], "example": [ { "label": "Example of a vacation home address", "valueAddress": { "_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" } ] } ], "use": "temp", "city": "Amsterdam", "state": "NH", "extension": [ { "url": "http://fhir.nl/fhir/StructureDefinition/nl-core-address-official", "valueBoolean": false } ], "line": [ "Binnenkant 12A Hoog" ], "postalCode": "1000AA", "country": "NLD", "_use": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/iso21090-AD-use", "valueCode": "HV" } ] } } }, { "label": "Example of a primary home address", "valueAddress": { "use": "home", "city": "Amsterdam", "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" } ] } ], "state": "NH", "country": "NLD", "extension": [ { "url": "http://fhir.nl/fhir/StructureDefinition/nl-core-address-official", "valueBoolean": true } ], "postalCode": "1001AA" } } ] }, { "id": "Address.extension", "path": "Address.extension", "slicing": { "rules": "open", "discriminator": [ { "path": "url", "type": "value" } ] } }, { "path": "Address.extension", "definition": "Mark an address as an 'officially registered' address. In Dutch context that means it is registered in the Basisregistratie persoonsgegevens (BRP)", "short": "Mark an address as an 'officially registered' address.", "mapping": [ { "map": "NL-CM:0.1.11", "comment": "AddressType", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.11", "comment": "AddressType", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.8", "comment": "AddressType", "identity": "hcim-addressinformation-v1.0-2017EN" } ], "type": [ { "code": "Extension", "profile": "http://fhir.nl/fhir/StructureDefinition/nl-core-address-official" } ], "sliceName": "official", "alias": [ "Markeer een adres als een 'officieel geregistreerd adres." ], "max": "1", "id": "Address.extension:official" }, { "id": "Address.use", "path": "Address.use", "mapping": [ { "map": "NL-CM:0.1.11", "comment": "AddressType", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.11", "comment": "AddressType", "identity": "hcim-address-v3.0-2016EN" }, { "map": "NL-CM:20.5.8", "comment": "AddressType", "identity": "hcim-addressinformation-v1.0-2017EN" } ], "definition": "Purpose of this address" }, { "id": "Address.use.extension", "path": "Address.use.extension", "slicing": { "rules": "open", "discriminator": [ { "path": "url", "type": "value" } ] } }, { "id": "Address.use.extension:AD_use", "path": "Address.use.extension", "type": [ { "code": "Extension", "profile": "http://hl7.org/fhir/StructureDefinition/iso21090-AD-use" } ], "alias": [ "Precieze definiƫring van adressoort op basis van exacte zib-code" ], "short": "Further define the address use with the exact HCIM code.", "sliceName": "AD_use", "definition": "Further define the address use with the exact HCIM code. Mostly relevant to distinguish between different types of temporasry addresses." }, { "id": "Address.use.extension:AD_use.valueCode:valueCode", "path": "Address.use.extension.valueCode", "sliceName": "valueCode" }, { "id": "Address.type", "path": "Address.type", "mapping": [ { "map": "NL-CM:0.1.11", "comment": "AddressType", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.11", "comment": "AddressType", "identity": "hcim-address-v3.0-2016EN" }, { "map": "NL-CM:20.5.8", "comment": "AddressType", "identity": "hcim-addressinformation-v1.0-2017EN" } ] }, { "id": "Address.line.extension", "path": "Address.line.extension", "slicing": { "rules": "open", "discriminator": [ { "path": "url", "type": "value" } ] } }, { "id": "Address.line.extension:streetName", "max": "1", "path": "Address.line.extension", "type": [ { "code": "Extension", "profile": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName" } ], "mapping": [ { "map": "NL-CM:0.1.12", "comment": "Street", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.12", "comment": "Street", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.2", "comment": "Street", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "map": "11.10", "comment": "Straatnaam", "identity": "BRP" } ], "sliceName": "streetName", "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.", "requirements": "Basisregistratie Persoonsgegevens 11.10 Straatnaam" }, { "id": "Address.line.extension:streetName.valueString:valueString", "path": "Address.line.extension.valueString", "sliceName": "valueString" }, { "id": "Address.line.extension:houseNumber", "max": "1", "path": "Address.line.extension", "type": [ { "code": "Extension", "profile": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber" } ], "mapping": [ { "map": "NL-CM:0.1.13", "comment": "HouseNumber", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.13", "comment": "HouseNumber", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.12", "comment": "HouseNumber", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "map": "11.20", "comment": "Huisnummer", "identity": "BRP" } ], "sliceName": "houseNumber", "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.", "requirements": "Basisregistratie Persoonsgegevens 11.20 Huisnummer" }, { "id": "Address.line.extension:houseNumber.valueString:valueString", "path": "Address.line.extension.valueString", "sliceName": "valueString" }, { "id": "Address.line.extension:buildingNumbersuffix", "path": "Address.line.extension", "type": [ { "code": "Extension", "profile": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix" } ], "comment": "Export\r\n\r\n- 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.\r\n- If only a house letter is known send just that. No trailing space is required.\r\n- If only a house letter suffix is known, communicate that with a leading space.\r\n\r\nImport\r\n\r\n- If the value of buildingNumberSuffix contains no space, then the whole value is considered to be the house letter\r\n- 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", "mapping": [ { "map": "NL-CM:0.1.40", "comment": "HouseNumberLetter", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.41", "comment": "HouseNumberAddition", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.40", "comment": "HouseNumberLetter", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:0.1.41", "comment": "HouseNumberAddition", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.11", "comment": "HouseNumberLetter", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "map": "NL-CM:20.5.10", "comment": "HouseNumberAddition", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "map": "11.30", "comment": "Huisletter", "identity": "BRP" }, { "map": "11.40", "comment": "Huisnummertoevoeging", "identity": "BRP" } ], "sliceName": "buildingNumbersuffix", "definition": "HouseNumberLetter\r\n- A letter following the house number as assigned by the municipal authorities.\r\n\r\nHouseNumberAddition\r\n- The letters or signs needed to locate the mailbox, in addition to the house number and letter.", "requirements": "Basisregistratie Persoonsgegevens 11.30 Huisletter\r\n11.40 Huisnummertoevoeging\r\n12.10 Locatieomschrijving" }, { "id": "Address.line.extension:buildingNumbersuffix.valueString:valueString", "path": "Address.line.extension.valueString", "sliceName": "valueString" }, { "id": "Address.line.extension:unitID", "max": "1", "path": "Address.line.extension", "type": [ { "code": "Extension", "profile": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitID" } ], "mapping": [ { "map": "NL-CM:0.1.28", "comment": "AdditionalInformation", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.28", "comment": "AdditionalInformation", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.7", "comment": "AdditionalInformation", "identity": "hcim-addressinformation-v1.0-2017EN" } ], "sliceName": "unitID", "definition": "Extra information such as the building name, building number, entrance, route number." }, { "id": "Address.line.extension:unitID.valueString:valueString", "path": "Address.line.extension.valueString", "sliceName": "valueString" }, { "id": "Address.line.extension:additionalLocator", "max": "1", "path": "Address.line.extension", "type": [ { "code": "Extension", "profile": "http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-additionalLocator" } ], "mapping": [ { "map": "NL-CM:0.1.42", "comment": "HouseNumberIndication", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.42", "comment": "HouseNumberIndication", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.9", "comment": "HouseNumberIndication", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "map": "11.50", "comment": "Aanduiding bij huisnummer", "identity": "BRP" } ], "sliceName": "additionalLocator", "definition": "HouseNumberIndication - The indication used for addresses that do not consist of the usual street name and house number.", "requirements": "Basisregistratie Persoonsgegevens 11.50 Aanduiding bij huisnummer" }, { "id": "Address.line.extension:additionalLocator.valueString:valueString", "path": "Address.line.extension.valueString", "sliceName": "valueString" }, { "id": "Address.city", "path": "Address.city", "alias": [ "Municipality", "woonplaats" ], "example": [ { "label": "Example city", "valueString": "Den Haag" } ], "mapping": [ { "map": "NL-CM:0.1.14", "comment": "Place of residence", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.14", "comment": "Place of residence", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.3", "comment": "PlaceOfResidence", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "map": "11.70", "comment": "Woonplaatsnaam", "identity": "BRP" } ], "requirements": "Basisregistratie Persoonsgegevens 11.70 Woonplaatsnaam" }, { "id": "Address.district", "path": "Address.district", "alias": [ "Gemeente" ], "comment": "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\"", "example": [ { "label": "Example district", "valueString": "Wateringen" } ], "mapping": [ { "map": "NL-CM:0.1.16", "comment": "Municipality", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.16", "comment": "Municipality", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.4", "comment": "Municipality", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "map": "09.10", "comment": "Gemeente van inschrijving", "identity": "BRP" } ], "requirements": "Basisregistratie Persoonsgegevens 09.10 Gemeente van inschrijving" }, { "id": "Address.state", "path": "Address.state", "alias": [ "Provincie" ], "short": "Sub-unit of country (abbreviations ok).", "example": [ { "label": "Example province", "valueString": "ZH" } ], "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", "requirements": "Some (Dutch) cities have the same name in multiple provinces. Dutch examples include Bergen (Noord-Holland / Limburg) and Geesteren (Gelderland / Overijssel)." }, { "id": "Address.postalCode", "path": "Address.postalCode", "alias": [ "Postcode" ], "comment": "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.", "example": [ { "label": "Example postcode", "valueString": "9132AG" } ], "mapping": [ { "map": "NL-CM:0.1.15", "comment": "Postcode", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.15", "comment": "Postcode", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.6", "comment": "Postcode", "identity": "hcim-addressinformation-v1.0-2017EN" }, { "map": "11.60", "comment": "Postcode", "identity": "BRP" } ], "condition": [ "nl-postal-code-pattern" ], "constraint": [ { "key": "nl-postal-code-pattern", "human": "Dutch postal code pattern 'nnnnAA'", "xpath": "not(../f:country[lower-case(@value)=('nl','nld','nederland')]) or matches(@value,'^\\d{4}[A-Z]{2}$')", "severity": "error", "expression": "(country in 'nl' | 'nld' | 'nederland').not() or matches('^\\\\d{4}[A-Z]{2}$')" } ] }, { "id": "Address.country", "path": "Address.country", "alias": [ "land" ], "short": "Country (can be ISO 3166 3 letter code)", "comment": "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.", "example": [ { "label": "Example country", "valueString": "NLD" } ], "mapping": [ { "map": "NL-CM:0.1.17", "comment": "Country", "identity": "hcim-address-v2.0.1-2015EN" }, { "map": "NL-CM:0.1.17", "comment": "Country", "identity": "hcim-addressinformation-v3.0-2016EN" }, { "map": "NL-CM:20.5.5", "comment": "Country", "identity": "hcim-addressinformation-v1.0-2017EN" } ], "definition": "A country (code) for the address." }, { "id": "Address.country.extension", "path": "Address.country.extension", "slicing": { "rules": "open", "discriminator": [ { "path": "url", "type": "value" }, { "path": "value.coding.system", "type": "value" } ] } }, { "id": "Address.country.extension:LandGBACodelijst", "max": "1", "path": "Address.country.extension", "type": [ { "code": "Extension", "profile": "http://nictiz.nl/fhir/StructureDefinition/code-specification" } ], "short": "LandGBACode", "sliceName": "LandGBACodelijst" }, { "id": "Address.country.extension:LandGBACodelijst.valueCodeableConcept:valueCodeableConcept", "path": "Address.country.extension.valueCodeableConcept", "binding": { "strength": "extensible", "description": "LandGBACodelijst", "valueSetReference": { "display": "LandGBACodelijst", "reference": "http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.1--20171231000000" } }, "sliceName": "valueCodeableConcept" }, { "id": "Address.country.extension:LandISOCodelijst", "max": "1", "path": "Address.country.extension", "type": [ { "code": "Extension", "profile": "http://nictiz.nl/fhir/StructureDefinition/code-specification" } ], "short": "LandISOCode", "sliceName": "LandISOCodelijst" }, { "id": "Address.country.extension:LandISOCodelijst.valueCodeableConcept:valueCodeableConcept", "path": "Address.country.extension.valueCodeableConcept", "binding": { "strength": "extensible", "description": "LandISOCodelijst", "valueSetReference": { "display": "LandISOCodelijst", "reference": "http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.20.5.2--20171231000000" } }, "sliceName": "valueCodeableConcept" } ] }, "contact": [ { "name": "Nictiz", "telecom": [ { "use": "work", "value": "info@nictiz.nl", "system": "email" } ] } ], "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Address" }