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: Address - base

Official URL: http://hl7.it/fhir/StructureDefinition/Address-it-base | Version: 0.1.1
Draft as of 2025-11-18 | Computable Name: AddressItBase
Copyright/Legal: CC0

Base StructureDefinition per il tipo Address con parti addizionali specifiche per gli indirizzi italiani. Questo profilo struttura l'elemento Address.line in più parti, consente la codifica di alcune di queste parti e supporta la caratterizzazine degli indirizzi di tipo Residenza. Questa prima versione è ispirata al data type Address Olandese.

### Caratterizzazione degli indirizzi

La capacità di individuare il tipo di indirizzo (e.g. indirizzo di residenza, di domicilio) è un requisito oggettivo di diversi contesti di uso.

Se per alcuni tipi, come quelli citati, esiste una condivisione del loro significato; per molti altri, non è sempre possible trovare una accezione comune.

Per questo motivo, in questa fase, è stato scelto di non sovra-specificare le diverse categorie; lasciando ad eventuali estensioni e vocabolari locali la capacità di descrivere queste ulteriori classi di indirizzi.

In generale le tipologie di indirizzo sono descritte attraverso un insieme di diversi elementi come:

- address.use
- address.type
- address.extension['address-official']

una estensione locale opzionale di tipo CodeableConcept potrà inoltre essere utilizzata per caratterizzare più dettagliatamente gli indirizzi.

In particolare:

- address.use='home' indica il domicilio
- address.extension['address-official']='true' indica la residenza

l'assenza di extension['address-official'] non permette di desumere alcuna informazione riguardo alla residenza; considerazioni simili possono essere fatte riguardo l'assenza di address.use e domicilio.

Usages:

- Use this DataType Profile: Patient - base

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Address | C | 0..* | Address | Indirizzo fisico o postale Constraints: it-address-official Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
Slices for extension |  |  |  | Content/Rules for all slices
extension:residenza |  | 0..1 | boolean | Indica l'indirizzo di residenza URL: http://hl7.org/fhir/StructureDefinition/address-official
extension:certificazioneIndirizzo |  | 0..* | (Complex) | Certificazione Indirizzo URL: http://hl7.it/fhir/StructureDefinition/recordCertification
use | ?!Σ | 0..1 | code | home | work | temp | old | billing - purpose of this address Binding: AddressUse (required): The use of an address. Example General: home
line | Σ | 0..* | string | Nome completo strada (e.g. Via Corta 1, interno 2) This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street Example ex-1: Via Corta 1, interno 2
Slices for extension |  |  |  | Content/Rules for all slices
extension:odonimo |  | 0..1 | string | Odonimo, Toponimo Stradale URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName Example ex-1: Via Corta
extension:denominazioneUrbanisticaGenerica |  | 0..* | string | Denominazione Urbanistica Generica (DUG) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType Example ex-1: Via
extension:dugCode |  | 0..1 | CodeableConcept | ​Codice Denominazione Urbanistica Generica (DUG) URL: http://hl7.it/fhir/StructureDefinition/address-dug Binding: http://terminology.hl7.it/ValueSet/istat-dug (extensible) Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
extension:denominazioneUrbanisticaUfficiale |  | 0..1 | string | Denominazione Urbanistica Ufficiale (DUF) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase Example ex-1: Corta
extension:houseNumber |  | 0..1 | string | Numero Civico URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber Example ex-1: 1
city | Σ | 0..1 | string | Name of city, town etc. Example General: Erewhon Example General: Bagno a Ripoli
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceComune |  | 0..* | Coding | Codice Comune URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
district | Σ | 0..1 | string | Nome della Provincia Example General: Madison Example General: Campobasso
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceProvincia |  | 0..* | Coding | Codice Provincia URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
state | Σ | 0..1 | string | Sotto-unità dello stato (Regione). Example Regione: Lazio
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceRegione |  | 0..* | Coding | Codice Regione URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
postalCode | Σ C | 0..1 | string | Postal code for area Constraints: it-postal-code-pattern Example General: 9132 Example General: 50125
country | Σ | 0..1 | string | Stato Example Nome Stato: Italia
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceStato |  | 0..* | Coding | Codice Stato URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Address.use | Base | required | AddressUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
it-address-official | error | Address | 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() )`
it-postal-code-pattern | error | Address.postalCode | I codici postali italiani hanno un pattern 'nnnnn' (n intero) | `(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`

This structure is derived from Address

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Address | C | 0..* | Address | Indirizzo fisico o postale Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
Slices for extension |  |  |  | Content/Rules for all slices
extension:residenza |  | 0..1 | boolean | Indica l'indirizzo di residenza URL: http://hl7.org/fhir/StructureDefinition/address-official
extension:certificazioneIndirizzo |  | 0..* | (Complex) | Certificazione Indirizzo URL: http://hl7.it/fhir/StructureDefinition/recordCertification
line |  | 0..* | string | Nome completo strada (e.g. Via Corta 1, interno 2) Example ex-1: Via Corta 1, interno 2
Slices for extension |  |  |  | Content/Rules for all slices
extension:odonimo |  | 0..1 | string | Odonimo, Toponimo Stradale URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName Example ex-1: Via Corta
extension:denominazioneUrbanisticaGenerica |  | 0..* | string | Denominazione Urbanistica Generica (DUG) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType Example ex-1: Via
extension:dugCode |  | 0..1 | CodeableConcept | ​Codice Denominazione Urbanistica Generica (DUG) URL: http://hl7.it/fhir/StructureDefinition/address-dug Binding: http://terminology.hl7.it/ValueSet/istat-dug (extensible) Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
extension:denominazioneUrbanisticaUfficiale |  | 0..1 | string | Denominazione Urbanistica Ufficiale (DUF) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase Example ex-1: Corta
extension:houseNumber |  | 0..1 | string | Numero Civico URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber Example ex-1: 1
city |  | 0..1 | string | Name of city, town etc. Example General: Bagno a Ripoli
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceComune |  | 0..* | Coding | Codice Comune URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
district |  | 0..1 | string | Nome della Provincia Example General: Campobasso
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceProvincia |  | 0..* | Coding | Codice Provincia URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
state |  | 0..1 | string | Sotto-unità dello stato (Regione). Example Regione: Lazio
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceRegione |  | 0..* | Coding | Codice Regione URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
postalCode | C | 0..1 | string | Postal code for area Example General: 50125
country |  | 0..1 | string | Stato Example Nome Stato: Italia
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceStato |  | 0..* | Coding | Codice Stato URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Address.city.extension:codiceComune<br/>[CanonicalType[http://hl7.​org/fhir/StructureDefinition/iso21090-SC-coding]] | Base | preferred | ​ http://terminology.hl7.it/ValueSet/istat-comune | Not State | Unknown
Address.district.extension:codiceProvincia<br/>[CanonicalType[http://hl7.​org/fhir/StructureDefinition/iso21090-SC-coding]] | Base | preferred | ​ http://terminology.hl7.it/ValueSet/istat-provincia | Not State | Unknown
Address.state.extension:codiceRegione<br/>[CanonicalType[http://hl7.​org/fhir/StructureDefinition/iso21090-SC-coding]] | Base | preferred | ​ http://terminology.hl7.it/ValueSet/istat-regione | Not State | Unknown
Address.country.extension:codiceStato<br/>[CanonicalType[http://hl7.​org/fhir/StructureDefinition/iso21090-SC-coding]] | Base | preferred | ​ http://terminology.hl7.it/ValueSet/istat-stato | Not State | Unknown

#### Constraints

Id | Grade | Path(s) | Description | Expression
it-address-official | error | Address | 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() )`
it-postal-code-pattern | error | Address.postalCode | I codici postali italiani hanno un pattern 'nnnnn' (n intero) | `(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Address | C | 0..* | Address | Indirizzo fisico o postale Constraints: it-address-official Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
extension:residenza |  | 0..1 | boolean | Indica l'indirizzo di residenza URL: http://hl7.org/fhir/StructureDefinition/address-official
extension:certificazioneIndirizzo |  | 0..* | (Complex) | Certificazione Indirizzo URL: http://hl7.it/fhir/StructureDefinition/recordCertification
use | ?!Σ | 0..1 | code | home | work | temp | old | billing - purpose of this address Binding: AddressUse (required): The use of an address. Example General: home
type | Σ | 0..1 | code | postal | physical | both Binding: AddressType (required): The type of an address (physical / postal). Example General: both
text | Σ | 0..1 | string | Text representation of the address Example General: 137 Nowhere Street, Erewhon 9132
line | Σ | 0..* | string | Nome completo strada (e.g. Via Corta 1, interno 2) This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street Example ex-1: Via Corta 1, interno 2
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:odonimo |  | 0..1 | string | Odonimo, Toponimo Stradale URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName Example ex-1: Via Corta
extension:denominazioneUrbanisticaGenerica |  | 0..* | string | Denominazione Urbanistica Generica (DUG) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType Example ex-1: Via
extension:dugCode |  | 0..1 | CodeableConcept | ​Codice Denominazione Urbanistica Generica (DUG) URL: http://hl7.it/fhir/StructureDefinition/address-dug Binding: http://terminology.hl7.it/ValueSet/istat-dug (extensible) Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
extension:denominazioneUrbanisticaUfficiale |  | 0..1 | string | Denominazione Urbanistica Ufficiale (DUF) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase Example ex-1: Corta
extension:houseNumber |  | 0..1 | string | Numero Civico URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber Example ex-1: 1
value |  | 0..1 | string | Primitive value for string Max Length:1048576
city | Σ | 0..1 | string | Name of city, town etc. Example General: Erewhon Example General: Bagno a Ripoli
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:codiceComune |  | 0..* | Coding | Codice Comune URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
value |  | 0..1 | string | Primitive value for string Max Length:1048576
district | Σ | 0..1 | string | Nome della Provincia Example General: Madison Example General: Campobasso
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:codiceProvincia |  | 0..* | Coding | Codice Provincia URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
value |  | 0..1 | string | Primitive value for string Max Length:1048576
state | Σ | 0..1 | string | Sotto-unità dello stato (Regione). Example Regione: Lazio
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:codiceRegione |  | 0..* | Coding | Codice Regione URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
value |  | 0..1 | string | Primitive value for string Max Length:1048576
postalCode | Σ C | 0..1 | string | Postal code for area Constraints: it-postal-code-pattern Example General: 9132 Example General: 50125
country | Σ | 0..1 | string | Stato Example Nome Stato: Italia
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:codiceStato |  | 0..* | Coding | Codice Stato URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
value |  | 0..1 | string | Primitive value for string Max Length:1048576
period | Σ | 0..1 | Period | Time period when address was/is in use Example General: {"start":"2010-03-23","end":"2010-07-01"}
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Address.use | Base | required | AddressUse | 📍4.0.1 | FHIR Std.
Address.type | Base | required | AddressType | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
it-address-official | error | Address | 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() )`
it-postal-code-pattern | error | Address.postalCode | I codici postali italiani hanno un pattern 'nnnnn' (n intero) | `(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`

This structure is derived from Address

Summary

Extensions

This structure refers to these extensions:

- http://hl7.org/fhir/StructureDefinition/address-official
- http://hl7.it/fhir/StructureDefinition/recordCertification
- http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName
- http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType
- http://hl7.it/fhir/StructureDefinition/address-dug
- http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase
- http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber
- http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Address | C | 0..* | Address | Indirizzo fisico o postale Constraints: it-address-official Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
Slices for extension |  |  |  | Content/Rules for all slices
extension:residenza |  | 0..1 | boolean | Indica l'indirizzo di residenza URL: http://hl7.org/fhir/StructureDefinition/address-official
extension:certificazioneIndirizzo |  | 0..* | (Complex) | Certificazione Indirizzo URL: http://hl7.it/fhir/StructureDefinition/recordCertification
use | ?!Σ | 0..1 | code | home | work | temp | old | billing - purpose of this address Binding: AddressUse (required): The use of an address. Example General: home
line | Σ | 0..* | string | Nome completo strada (e.g. Via Corta 1, interno 2) This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street Example ex-1: Via Corta 1, interno 2
Slices for extension |  |  |  | Content/Rules for all slices
extension:odonimo |  | 0..1 | string | Odonimo, Toponimo Stradale URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName Example ex-1: Via Corta
extension:denominazioneUrbanisticaGenerica |  | 0..* | string | Denominazione Urbanistica Generica (DUG) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType Example ex-1: Via
extension:dugCode |  | 0..1 | CodeableConcept | ​Codice Denominazione Urbanistica Generica (DUG) URL: http://hl7.it/fhir/StructureDefinition/address-dug Binding: http://terminology.hl7.it/ValueSet/istat-dug (extensible) Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
extension:denominazioneUrbanisticaUfficiale |  | 0..1 | string | Denominazione Urbanistica Ufficiale (DUF) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase Example ex-1: Corta
extension:houseNumber |  | 0..1 | string | Numero Civico URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber Example ex-1: 1
city | Σ | 0..1 | string | Name of city, town etc. Example General: Erewhon Example General: Bagno a Ripoli
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceComune |  | 0..* | Coding | Codice Comune URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
district | Σ | 0..1 | string | Nome della Provincia Example General: Madison Example General: Campobasso
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceProvincia |  | 0..* | Coding | Codice Provincia URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
state | Σ | 0..1 | string | Sotto-unità dello stato (Regione). Example Regione: Lazio
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceRegione |  | 0..* | Coding | Codice Regione URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
postalCode | Σ C | 0..1 | string | Postal code for area Constraints: it-postal-code-pattern Example General: 9132 Example General: 50125
country | Σ | 0..1 | string | Stato Example Nome Stato: Italia
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceStato |  | 0..* | Coding | Codice Stato URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Address.use | Base | required | AddressUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
it-address-official | error | Address | 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() )`
it-postal-code-pattern | error | Address.postalCode | I codici postali italiani hanno un pattern 'nnnnn' (n intero) | `(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`

Differential View

This structure is derived from Address

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Address | C | 0..* | Address | Indirizzo fisico o postale Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
Slices for extension |  |  |  | Content/Rules for all slices
extension:residenza |  | 0..1 | boolean | Indica l'indirizzo di residenza URL: http://hl7.org/fhir/StructureDefinition/address-official
extension:certificazioneIndirizzo |  | 0..* | (Complex) | Certificazione Indirizzo URL: http://hl7.it/fhir/StructureDefinition/recordCertification
line |  | 0..* | string | Nome completo strada (e.g. Via Corta 1, interno 2) Example ex-1: Via Corta 1, interno 2
Slices for extension |  |  |  | Content/Rules for all slices
extension:odonimo |  | 0..1 | string | Odonimo, Toponimo Stradale URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName Example ex-1: Via Corta
extension:denominazioneUrbanisticaGenerica |  | 0..* | string | Denominazione Urbanistica Generica (DUG) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType Example ex-1: Via
extension:dugCode |  | 0..1 | CodeableConcept | ​Codice Denominazione Urbanistica Generica (DUG) URL: http://hl7.it/fhir/StructureDefinition/address-dug Binding: http://terminology.hl7.it/ValueSet/istat-dug (extensible) Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
extension:denominazioneUrbanisticaUfficiale |  | 0..1 | string | Denominazione Urbanistica Ufficiale (DUF) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase Example ex-1: Corta
extension:houseNumber |  | 0..1 | string | Numero Civico URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber Example ex-1: 1
city |  | 0..1 | string | Name of city, town etc. Example General: Bagno a Ripoli
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceComune |  | 0..* | Coding | Codice Comune URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
district |  | 0..1 | string | Nome della Provincia Example General: Campobasso
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceProvincia |  | 0..* | Coding | Codice Provincia URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
state |  | 0..1 | string | Sotto-unità dello stato (Regione). Example Regione: Lazio
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceRegione |  | 0..* | Coding | Codice Regione URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
postalCode | C | 0..1 | string | Postal code for area Example General: 50125
country |  | 0..1 | string | Stato Example Nome Stato: Italia
Slices for extension |  |  |  | Content/Rules for all slices
extension:codiceStato |  | 0..* | Coding | Codice Stato URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Address.city.extension:codiceComune<br/>[CanonicalType[http://hl7.​org/fhir/StructureDefinition/iso21090-SC-coding]] | Base | preferred | ​ http://terminology.hl7.it/ValueSet/istat-comune | Not State | Unknown
Address.district.extension:codiceProvincia<br/>[CanonicalType[http://hl7.​org/fhir/StructureDefinition/iso21090-SC-coding]] | Base | preferred | ​ http://terminology.hl7.it/ValueSet/istat-provincia | Not State | Unknown
Address.state.extension:codiceRegione<br/>[CanonicalType[http://hl7.​org/fhir/StructureDefinition/iso21090-SC-coding]] | Base | preferred | ​ http://terminology.hl7.it/ValueSet/istat-regione | Not State | Unknown
Address.country.extension:codiceStato<br/>[CanonicalType[http://hl7.​org/fhir/StructureDefinition/iso21090-SC-coding]] | Base | preferred | ​ http://terminology.hl7.it/ValueSet/istat-stato | Not State | Unknown

#### Constraints

Id | Grade | Path(s) | Description | Expression
it-address-official | error | Address | 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() )`
it-postal-code-pattern | error | Address.postalCode | I codici postali italiani hanno un pattern 'nnnnn' (n intero) | `(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Address | C | 0..* | Address | Indirizzo fisico o postale Constraints: it-address-official Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
extension:residenza |  | 0..1 | boolean | Indica l'indirizzo di residenza URL: http://hl7.org/fhir/StructureDefinition/address-official
extension:certificazioneIndirizzo |  | 0..* | (Complex) | Certificazione Indirizzo URL: http://hl7.it/fhir/StructureDefinition/recordCertification
use | ?!Σ | 0..1 | code | home | work | temp | old | billing - purpose of this address Binding: AddressUse (required): The use of an address. Example General: home
type | Σ | 0..1 | code | postal | physical | both Binding: AddressType (required): The type of an address (physical / postal). Example General: both
text | Σ | 0..1 | string | Text representation of the address Example General: 137 Nowhere Street, Erewhon 9132
line | Σ | 0..* | string | Nome completo strada (e.g. Via Corta 1, interno 2) This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street Example ex-1: Via Corta 1, interno 2
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:odonimo |  | 0..1 | string | Odonimo, Toponimo Stradale URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName Example ex-1: Via Corta
extension:denominazioneUrbanisticaGenerica |  | 0..* | string | Denominazione Urbanistica Generica (DUG) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType Example ex-1: Via
extension:dugCode |  | 0..1 | CodeableConcept | ​Codice Denominazione Urbanistica Generica (DUG) URL: http://hl7.it/fhir/StructureDefinition/address-dug Binding: http://terminology.hl7.it/ValueSet/istat-dug (extensible) Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
extension:denominazioneUrbanisticaUfficiale |  | 0..1 | string | Denominazione Urbanistica Ufficiale (DUF) URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase Example ex-1: Corta
extension:houseNumber |  | 0..1 | string | Numero Civico URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber Example ex-1: 1
value |  | 0..1 | string | Primitive value for string Max Length:1048576
city | Σ | 0..1 | string | Name of city, town etc. Example General: Erewhon Example General: Bagno a Ripoli
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:codiceComune |  | 0..* | Coding | Codice Comune URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
value |  | 0..1 | string | Primitive value for string Max Length:1048576
district | Σ | 0..1 | string | Nome della Provincia Example General: Madison Example General: Campobasso
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:codiceProvincia |  | 0..* | Coding | Codice Provincia URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
value |  | 0..1 | string | Primitive value for string Max Length:1048576
state | Σ | 0..1 | string | Sotto-unità dello stato (Regione). Example Regione: Lazio
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:codiceRegione |  | 0..* | Coding | Codice Regione URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
value |  | 0..1 | string | Primitive value for string Max Length:1048576
postalCode | Σ C | 0..1 | string | Postal code for area Constraints: it-postal-code-pattern Example General: 9132 Example General: 50125
country | Σ | 0..1 | string | Stato Example Nome Stato: Italia
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:codiceStato |  | 0..* | Coding | Codice Stato URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding Binding Description: (example): A coded representation for a string. Could be codes for country in a country address part, codes for prefixes in a name part, etc.
value |  | 0..1 | string | Primitive value for string Max Length:1048576
period | Σ | 0..1 | Period | Time period when address was/is in use Example General: {"start":"2010-03-23","end":"2010-07-01"}
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Address.use | Base | required | AddressUse | 📍4.0.1 | FHIR Std.
Address.type | Base | required | AddressType | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
it-address-official | error | Address | 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() )`
it-postal-code-pattern | error | Address.postalCode | I codici postali italiani hanno un pattern 'nnnnn' (n intero) | `(country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')`

This structure is derived from Address

Summary

Extensions

This structure refers to these extensions:

- http://hl7.org/fhir/StructureDefinition/address-official
- http://hl7.it/fhir/StructureDefinition/recordCertification
- http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName
- http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType
- http://hl7.it/fhir/StructureDefinition/address-dug
- http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase
- http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber
- http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding

Other representations of profile: CSV, Excel, Schematron