HL7 Italia FHIR Implementation Guide (base)
0.1.1 - CI Build IT

HL7 Italia FHIR Implementation Guide (base), published by HL7 Italia. This guide is not an authorized publication; it is the continuous build for version 0.1.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-it/base/ and changes regularly. See the Directory of published versions

## Data Type Profile: AddressItBase - Detailed Descriptions

Draft as of 2025-11-18

Definitions for the Address-it-base data type profile.

- Key Elements Table
- Differential Elements Table
- Snapshot Elements Table

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

0. Address
Definition | Esiste una varietà di formati di indirizzi postali definiti in tutto il mondo. Questo profilo (Address-it-base) estende il datatype base Address includendo una serie di informazioni rilevanti per esprimere gli indirizzi in Italia. Un Address-it-base è un indirizzo FHIR valido; i sistemi che non supportano le estensioni utilizzate saranno in grado comunque di eseguire il rendering e lavorare con un Address-it-base. Un indirizzo Address-it-base rende alcune parti di indirizzo comunicabili separatamente. Queste parti sono necessarie in alcuni scenari d'uso italiani, ma potrebbero non avere valore per i sistemi internazionali quando le informazioni vengono inviate all'estero. 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.
Short | Indirizzo fisico o postaleAn address expressed using postal conventions (as opposed to GPS or other location definition formats)
Comments | Nota: address è per indirizzi postali, non per la localizzazione fisica. Note: address is intended to describe postal addresses for administrative purposes, not to describe absolute geographical coordinates. Postal addresses are often used as proxies for physical locations (also see the Location resource).
Control | 0..* This element is affected by the following invariants: ele-1
Is Modifier | false
Alternate Names | Indirizzo
Example | Completo: { "line" : ["Via dei Ciliegi 15"], "city" : "Artimino", "state" : "PO", "postalCode" : "59015", "country" : "IT" }
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) it-address-official: Se Address rappresenta la residenza allora city e line devono essere inclusi (`extension.where(url = 'http://hl7.org/fhir/StructureDefinition/address-official').valueBoolean.where(true).empty() or ( line.exists() and city.exists() )`)
2. Address.extension:residenza
Slice Name | residenza
Definition | Indica se questo indirizzo è quello di residenza, come indirizzo 'ufficialmente registrato' address.
Short | Indica l'indirizzo di residenza
Control | 0..1
Type | Extension(Official Address) (Extension Type: Choice of: boolean, CodeableConcept)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
4. Address.extension:certificazioneIndirizzo
Slice Name | certificazioneIndirizzo
Definition | Indica che i dati di questo indirizzo sono stati certificati da una specifica entità
Short | Certificazione Indirizzo
Control | 0..*
Type | Extension(Certificazione) (Complex Extension)
Is Modifier | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
6. Address.use
Definition | The purpose of this address.
Short | home | work | temp | old | billing - purpose of this address
Comments | Applications can assume that an address is current unless it explicitly says that it is temporary or old.
Control | 0..1
Binding | The codes SHALL be taken from AddressUse http://hl7.org/fhir/ValueSet/address-use|4.0.1 (required to `http://hl7.org/fhir/ValueSet/address-use|4.0.1` ) The use of an address.
Type | code
Is Modifier | true because This is labeled as "Is Modifier" because applications should not mistake a temporary or old address etc.for a current/permanent one
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Requirements | Allows an appropriate address to be chosen from a list of many.
Example | General: home
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
8. 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.
Short | Nome completo strada (e.g. Via Corta 1, interno 2)Street name, number, direction & P.O. Box etc.
Control | 0..*
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Example | General: 137 Nowhere Street ex-1: Via Corta 1, interno 2
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
10. Address.line.extension:odonimo
Slice Name | odonimo
Definition | streetName.
Short | Odonimo, Toponimo Stradale
Control | 0..1
Type | Extension(ADXP Street Name) (Extension Type: string)
Is Modifier | false
Summary | false
Requirements | Nome della Strada
Alternate Names | Toponimo Stradale
Example | ex-1: Via Corta
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
12. Address.line.extension:denominazioneUrbanisticaGenerica
Slice Name | denominazioneUrbanisticaGenerica
Definition | The designation given to the street. (e.g. Street, Avenue, Crescent, etc.).
Short | Denominazione Urbanistica Generica (DUG)
Control | 0..*
Type | Extension(ADXP Street Name Type) (Extension Type: string)
Is Modifier | false
Summary | false
Example | ex-1: Via
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
14. Address.line.extension:dugCode
Slice Name | dugCode
Definition | An Extension
Short | Codice Denominazione Urbanistica Generica (DUG)
Control | 0..1 This element is affected by the following invariants: ele-1
Type | Extension(DUG (Denominazione Urbanistica Generica)) (Extension Type: CodeableConcept)
Is Modifier | false
Summary | false
Alternate Names | specie
Example | ex-1: { "coding" : [{ "system" : "http://registry.geodati.gov.it/dug", "code" : "67", "display" : "via" }] }
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
16. Address.line.extension:denominazioneUrbanisticaUfficiale
Slice Name | denominazioneUrbanisticaUfficiale
Definition | The base name of a roadway or artery recognized by a municipality (excluding street type and direction).
Short | Denominazione Urbanistica Ufficiale (DUF)
Control | 0..1
Type | Extension(ADXP Street Name Base) (Extension Type: string)
Is Modifier | false
Summary | false
Alternate Names | denominazione
Example | ex-1: Corta
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
18. Address.line.extension:houseNumber
Slice Name | houseNumber
Definition | The number of a building, house or lot alongside the street. Also known as "primary street number". This does not number the street but rather the building.
Short | Numero Civico
Control | 0..1
Type | Extension(ADXP House Number) (Extension Type: string)
Is Modifier | false
Summary | false
Requirements | Numero Civico
Example | ex-1: 1
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
20. Address.city
Definition | The name of the city, town, village or other community or delivery center. The name of the city, town, suburb, village or other community or delivery center.
Short | Name of city, town etc.
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Alternate Names | Municpality, Comune
Example | General: Erewhon General: Bagno a Ripoli
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
22. Address.city.extension:codiceComune
Slice Name | codiceComune
Definition | Provides a coded expression for the content represented in a string.
Short | Codice Comune
Control | 0..*
Type | Extension(SC Coding) (Extension Type: Coding)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
24. Address.district
Definition | Nome dell'area amministrativa (county). Per gli indirizzi italiani è usato per indicare la Provincia The name of the administrative area (county).
Short | Nome della ProvinciaDistrict 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.
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Alternate Names | County, Provincia
Example | General: Madison General: Campobasso
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
26. Address.district.extension:codiceProvincia
Slice Name | codiceProvincia
Definition | Provides a coded expression for the content represented in a string.
Short | Codice Provincia
Control | 0..*
Type | Extension(SC Coding) (Extension Type: Coding)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
28. Address.state
Definition | Sotto-unità dello stato con limitata sovranità in uno stato oragnizzato federalmente. Nel contesto italiano indica la "Regione" Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (e.g. US 2 letter state codes).
Short | Sotto-unità dello stato (Regione).Sub-unit of country (abbreviations ok)
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Alternate Names | Province, Territory, Regione
Example | Regione: Lazio
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
30. Address.state.extension:codiceRegione
Slice Name | codiceRegione
Definition | Provides a coded expression for the content represented in a string.
Short | Codice Regione
Control | 0..*
Type | Extension(SC Coding) (Extension Type: Coding)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
32. Address.postalCode
Definition | A postal code designating a region defined by the postal service.
Short | Postal code for area
Comments | I codici postali italiani hanno un pattern '[1,9]\d{4}'.
Control | 0..1 This element is affected by the following invariants: it-postal-code-pattern
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Alternate Names | Zip, CAP, postcode
Example | General: 9132 General: 50125
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) it-postal-code-pattern: I codici postali italiani hanno un pattern 'nnnnn' (n intero) (`(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`)
34. Address.country
Definition | Country - a nation as commonly understood or generally accepted.
Short | StatoCountry (e.g. can be ISO 3166 2 or 3 letter code)
Comments | ISO 3166 3 letter codes can be used in place of a human readable country name.
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Example | Nome Stato: Italia
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
36. Address.country.extension:codiceStato
Slice Name | codiceStato
Definition | Provides a coded expression for the content represented in a string.
Short | Codice Stato
Control | 0..*
Type | Extension(SC Coding) (Extension Type: Coding)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`) ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())

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

0. Address
Definition | Esiste una varietà di formati di indirizzi postali definiti in tutto il mondo. Questo profilo (Address-it-base) estende il datatype base Address includendo una serie di informazioni rilevanti per esprimere gli indirizzi in Italia. Un Address-it-base è un indirizzo FHIR valido; i sistemi che non supportano le estensioni utilizzate saranno in grado comunque di eseguire il rendering e lavorare con un Address-it-base. Un indirizzo Address-it-base rende alcune parti di indirizzo comunicabili separatamente. Queste parti sono necessarie in alcuni scenari d'uso italiani, ma potrebbero non avere valore per i sistemi internazionali quando le informazioni vengono inviate all'estero.
Short | Indirizzo fisico o postale
Comments | Nota: address è per indirizzi postali, non per la localizzazione fisica.
Alternate Names | Indirizzo
Example | Completo: { "line" : ["Via dei Ciliegi 15"], "city" : "Artimino", "state" : "PO", "postalCode" : "59015", "country" : "IT" }
Invariants | it-address-official: Se Address rappresenta la residenza allora city e line devono essere inclusi (`extension.where(url = 'http://hl7.org/fhir/StructureDefinition/address-official').valueBoolean.where(true).empty() or ( line.exists() and city.exists() )`)
2. Address.extension:residenza
Slice Name | residenza
Definition | Indica se questo indirizzo è quello di residenza, come indirizzo 'ufficialmente registrato' address.
Short | Indica l'indirizzo di residenza
Control | 0..1
Type | Extension(Official Address) (Extension Type: Choice of: boolean, CodeableConcept)
4. Address.extension:certificazioneIndirizzo
Slice Name | certificazioneIndirizzo
Definition | Indica che i dati di questo indirizzo sono stati certificati da una specifica entità
Short | Certificazione Indirizzo
Type | Extension(Certificazione) (Complex Extension)
6. Address.line
Short | Nome completo strada (e.g. Via Corta 1, interno 2)
Example | ex-1: Via Corta 1, interno 2
8. Address.line.extension:odonimo
Slice Name | odonimo
Short | Odonimo, Toponimo Stradale
Control | 0..1
Type | Extension(ADXP Street Name) (Extension Type: string)
Requirements | Nome della Strada
Alternate Names | Toponimo Stradale
Example | ex-1: Via Corta
10. Address.line.extension:denominazioneUrbanisticaGenerica
Slice Name | denominazioneUrbanisticaGenerica
Short | Denominazione Urbanistica Generica (DUG)
Type | Extension(ADXP Street Name Type) (Extension Type: string)
Example | ex-1: Via
12. Address.line.extension:dugCode
Slice Name | dugCode
Short | Codice Denominazione Urbanistica Generica (DUG)
Control | 0..1
Type | Extension(DUG (Denominazione Urbanistica Generica)) (Extension Type: CodeableConcept)
Alternate Names | specie
Example | ex-1: { "coding" : [{ "system" : "http://registry.geodati.gov.it/dug", "code" : "67", "display" : "via" }] }
14. Address.line.extension:denominazioneUrbanisticaUfficiale
Slice Name | denominazioneUrbanisticaUfficiale
Short | Denominazione Urbanistica Ufficiale (DUF)
Control | 0..1
Type | Extension(ADXP Street Name Base) (Extension Type: string)
Alternate Names | denominazione
Example | ex-1: Corta
16. Address.line.extension:houseNumber
Slice Name | houseNumber
Short | Numero Civico
Control | 0..1
Type | Extension(ADXP House Number) (Extension Type: string)
Requirements | Numero Civico
Example | ex-1: 1
18. Address.city
Definition | The name of the city, town, village or other community or delivery center.
Alternate Names | Comune
Example | General: Bagno a Ripoli
20. Address.city.extension:codiceComune
Slice Name | codiceComune
Short | Codice Comune
Binding | ​The codes SHOULD be taken from http://terminology.hl7.it/ValueSet/istat-comune (preferred to `http://terminology.hl7.it/ValueSet/istat-comune` )
Type | Extension(SC Coding) (Extension Type: Coding)
22. Address.district
Definition | Nome dell'area amministrativa (county). Per gli indirizzi italiani è usato per indicare la Provincia
Short | Nome della Provincia
Alternate Names | Provincia
Example | General: Campobasso
24. Address.district.extension:codiceProvincia
Slice Name | codiceProvincia
Short | Codice Provincia
Binding | ​The codes SHOULD be taken from http://terminology.hl7.it/ValueSet/istat-provincia (preferred to `http://terminology.hl7.it/ValueSet/istat-provincia` )
Type | Extension(SC Coding) (Extension Type: Coding)
26. Address.state
Definition | Sotto-unità dello stato con limitata sovranità in uno stato oragnizzato federalmente. Nel contesto italiano indica la "Regione"
Short | Sotto-unità dello stato (Regione).
Alternate Names | Regione
Example | Regione: Lazio
28. Address.state.extension:codiceRegione
Slice Name | codiceRegione
Short | Codice Regione
Binding | ​The codes SHOULD be taken from http://terminology.hl7.it/ValueSet/istat-regione (preferred to `http://terminology.hl7.it/ValueSet/istat-regione` )
Type | Extension(SC Coding) (Extension Type: Coding)
30. Address.postalCode
Comments | I codici postali italiani hanno un pattern '[1,9]\d{4}'.
Alternate Names | CAP, postcode
Example | General: 50125
Invariants | it-postal-code-pattern: I codici postali italiani hanno un pattern 'nnnnn' (n intero) (`(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`)
32. Address.country
Short | Stato
Example | Nome Stato: Italia
34. Address.country.extension:codiceStato
Slice Name | codiceStato
Short | Codice Stato
Binding | ​The codes SHOULD be taken from http://terminology.hl7.it/ValueSet/istat-stato (preferred to `http://terminology.hl7.it/ValueSet/istat-stato` )
Type | Extension(SC Coding) (Extension Type: Coding)

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

0. Address
Definition | Esiste una varietà di formati di indirizzi postali definiti in tutto il mondo. Questo profilo (Address-it-base) estende il datatype base Address includendo una serie di informazioni rilevanti per esprimere gli indirizzi in Italia. Un Address-it-base è un indirizzo FHIR valido; i sistemi che non supportano le estensioni utilizzate saranno in grado comunque di eseguire il rendering e lavorare con un Address-it-base. Un indirizzo Address-it-base rende alcune parti di indirizzo comunicabili separatamente. Queste parti sono necessarie in alcuni scenari d'uso italiani, ma potrebbero non avere valore per i sistemi internazionali quando le informazioni vengono inviate all'estero.
Short | Indirizzo fisico o postale
Comments | Nota: address è per indirizzi postali, non per la localizzazione fisica.
Control | 0..* This element is affected by the following invariants: ele-1
Is Modifier | false
Alternate Names | Indirizzo
Example | Completo: { "line" : ["Via dei Ciliegi 15"], "city" : "Artimino", "state" : "PO", "postalCode" : "59015", "country" : "IT" }
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) it-address-official: Se Address rappresenta la residenza allora city e line devono essere inclusi (`extension.where(url = 'http://hl7.org/fhir/StructureDefinition/address-official').valueBoolean.where(true).empty() or ( line.exists() and city.exists() )`)
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.
Short | Unique id for inter-element referencing
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
4. Address.extension
Definition | May be used to represent additional information that is not part of the basic definition of the element. 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 can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short | Additional 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.
Control | 0..*
Type | Extension
Is Modifier | false
Summary | false
Alternate Names | extensions, user content
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing | This 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:residenza
Slice Name | residenza
Definition | Indica se questo indirizzo è quello di residenza, come indirizzo 'ufficialmente registrato' address.
Short | Indica l'indirizzo di residenza
Control | 0..1
Type | Extension(Official Address) (Extension Type: Choice of: boolean, CodeableConcept)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
8. Address.extension:certificazioneIndirizzo
Slice Name | certificazioneIndirizzo
Definition | Indica che i dati di questo indirizzo sono stati certificati da una specifica entità
Short | Certificazione Indirizzo
Control | 0..*
Type | Extension(Certificazione) (Complex Extension)
Is Modifier | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
10. Address.use
Definition | The purpose of this address.
Short | home | work | temp | old | billing - purpose of this address
Comments | Applications can assume that an address is current unless it explicitly says that it is temporary or old.
Control | 0..1
Binding | The codes SHALL be taken from AddressUse (required to `http://hl7.org/fhir/ValueSet/address-use|4.0.1` ) The use of an address.
Type | code
Is Modifier | true because This is labeled as "Is Modifier" because applications should not mistake a temporary or old address etc.for a current/permanent one
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Requirements | Allows an appropriate address to be chosen from a list of many.
Example | General: home
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
12. 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.
Short | postal | physical | both
Comments | The definition of Address states that "address is intended to describe postal addresses, not physical locations". However, many applications track whether an address has a dual purpose of being a location that can be visited as well as being a valid delivery destination, and Postal addresses are often used as proxies for physical locations (also see the Location resource).
Control | 0..1
Binding | The codes SHALL be taken from AddressType (required to `http://hl7.org/fhir/ValueSet/address-type|4.0.1` ) The type of an address (physical / postal).
Type | code
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Example | General: both
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
14. Address.text
Definition | Specifies the entire address as it should be displayed e.g. on a postal label. This may be provided instead of or as well as the specific parts.
Short | Text representation of the address
Comments | Can provide both a text representation and parts. Applications updating an address SHALL ensure that when both text and parts are present, no content is included in the text that isn't found in a part.
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Requirements | A renderable, unencoded form.
Example | General: 137 Nowhere Street, Erewhon 9132
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
16. 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.
Short | Nome completo strada (e.g. Via Corta 1, interno 2)
Control | 0..*
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Example | General: 137 Nowhere Street ex-1: Via Corta 1, interno 2
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
18. Address.line.id
Definition | unique id for the element within a resource (for internal references)
Short | xml:id (or equivalent in JSON)
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
20. Address.line.extension
Definition | An Extension
Short | Extension
Control | 0..*
Type | Extension
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing | This 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
22. Address.line.extension:odonimo
Slice Name | odonimo
Definition | streetName.
Short | Odonimo, Toponimo Stradale
Control | 0..1
Type | Extension(ADXP Street Name) (Extension Type: string)
Is Modifier | false
Summary | false
Requirements | Nome della Strada
Alternate Names | Toponimo Stradale
Example | ex-1: Via Corta
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
24. Address.line.extension:denominazioneUrbanisticaGenerica
Slice Name | denominazioneUrbanisticaGenerica
Definition | The designation given to the street. (e.g. Street, Avenue, Crescent, etc.).
Short | Denominazione Urbanistica Generica (DUG)
Control | 0..*
Type | Extension(ADXP Street Name Type) (Extension Type: string)
Is Modifier | false
Summary | false
Example | ex-1: Via
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
26. Address.line.extension:dugCode
Slice Name | dugCode
Definition | An Extension
Short | Codice Denominazione Urbanistica Generica (DUG)
Control | 0..1 This element is affected by the following invariants: ele-1
Type | Extension(DUG (Denominazione Urbanistica Generica)) (Extension Type: CodeableConcept)
Is Modifier | false
Summary | false
Alternate Names | specie
Example | ex-1: { "coding" : [{ "system" : "http://registry.geodati.gov.it/dug", "code" : "67", "display" : "via" }] }
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
28. Address.line.extension:denominazioneUrbanisticaUfficiale
Slice Name | denominazioneUrbanisticaUfficiale
Definition | The base name of a roadway or artery recognized by a municipality (excluding street type and direction).
Short | Denominazione Urbanistica Ufficiale (DUF)
Control | 0..1
Type | Extension(ADXP Street Name Base) (Extension Type: string)
Is Modifier | false
Summary | false
Alternate Names | denominazione
Example | ex-1: Corta
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
30. Address.line.extension:houseNumber
Slice Name | houseNumber
Definition | The number of a building, house or lot alongside the street. Also known as "primary street number". This does not number the street but rather the building.
Short | Numero Civico
Control | 0..1
Type | Extension(ADXP House Number) (Extension Type: string)
Is Modifier | false
Summary | false
Requirements | Numero Civico
Example | ex-1: 1
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
32. Address.line.value
Definition | The actual value
Short | Primitive value for string
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
Max Length: | 1048576
34. Address.city
Definition | The name of the city, town, village or other community or delivery center.
Short | Name of city, town etc.
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Alternate Names | Municpality, Comune
Example | General: Erewhon General: Bagno a Ripoli
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
36. Address.city.id
Definition | unique id for the element within a resource (for internal references)
Short | xml:id (or equivalent in JSON)
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
38. Address.city.extension
Definition | An Extension
Short | Extension
Control | 0..*
Type | Extension
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing | This element introduces a set of slices on `Address.city.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
40. Address.city.extension:codiceComune
Slice Name | codiceComune
Definition | Provides a coded expression for the content represented in a string.
Short | Codice Comune
Control | 0..*
Type | Extension(SC Coding) (Extension Type: Coding)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
42. Address.city.value
Definition | The actual value
Short | Primitive value for string
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
Max Length: | 1048576
44. Address.district
Definition | Nome dell'area amministrativa (county). Per gli indirizzi italiani è usato per indicare la Provincia
Short | Nome della Provincia
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.
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Alternate Names | County, Provincia
Example | General: Madison General: Campobasso
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
46. Address.district.id
Definition | unique id for the element within a resource (for internal references)
Short | xml:id (or equivalent in JSON)
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
48. Address.district.extension
Definition | An Extension
Short | Extension
Control | 0..*
Type | Extension
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing | This element introduces a set of slices on `Address.district.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
50. Address.district.extension:codiceProvincia
Slice Name | codiceProvincia
Definition | Provides a coded expression for the content represented in a string.
Short | Codice Provincia
Control | 0..*
Type | Extension(SC Coding) (Extension Type: Coding)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
52. Address.district.value
Definition | The actual value
Short | Primitive value for string
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
Max Length: | 1048576
54. Address.state
Definition | Sotto-unità dello stato con limitata sovranità in uno stato oragnizzato federalmente. Nel contesto italiano indica la "Regione"
Short | Sotto-unità dello stato (Regione).
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Alternate Names | Province, Territory, Regione
Example | Regione: Lazio
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
56. Address.state.id
Definition | unique id for the element within a resource (for internal references)
Short | xml:id (or equivalent in JSON)
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
58. Address.state.extension
Definition | An Extension
Short | Extension
Control | 0..*
Type | Extension
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing | This element introduces a set of slices on `Address.state.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
60. Address.state.extension:codiceRegione
Slice Name | codiceRegione
Definition | Provides a coded expression for the content represented in a string.
Short | Codice Regione
Control | 0..*
Type | Extension(SC Coding) (Extension Type: Coding)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
62. Address.state.value
Definition | The actual value
Short | Primitive value for string
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
Max Length: | 1048576
64. Address.postalCode
Definition | A postal code designating a region defined by the postal service.
Short | Postal code for area
Comments | I codici postali italiani hanno un pattern '[1,9]\d{4}'.
Control | 0..1 This element is affected by the following invariants: it-postal-code-pattern
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Alternate Names | Zip, CAP, postcode
Example | General: 9132 General: 50125
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) it-postal-code-pattern: I codici postali italiani hanno un pattern 'nnnnn' (n intero) (`(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`)
66. Address.country
Definition | Country - a nation as commonly understood or generally accepted.
Short | Stato
Comments | ISO 3166 3 letter codes can be used in place of a human readable country name.
Control | 0..1
Type | string
Is Modifier | false
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
Summary | true
Example | Nome Stato: Italia
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
68. Address.country.id
Definition | unique id for the element within a resource (for internal references)
Short | xml:id (or equivalent in JSON)
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
70. Address.country.extension
Definition | An Extension
Short | Extension
Control | 0..*
Type | Extension
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing | This 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
72. Address.country.extension:codiceStato
Slice Name | codiceStato
Definition | Provides a coded expression for the content represented in a string.
Short | Codice Stato
Control | 0..*
Type | Extension(SC Coding) (Extension Type: Coding)
Is Modifier | false
Summary | false
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
74. Address.country.value
Definition | The actual value
Short | Primitive value for string
Control | 0..1
Type | string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
Max Length: | 1048576
76. Address.period
Definition | Time period when address was/is in use.
Short | Time period when address was/is in use
Control | 0..1
Type | Period
Is Modifier | false
Summary | true
Requirements | Allows addresses to be placed in historical context.
Example | General: { "start" : "2010-03-23", "end" : "2010-07-01" }
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)