Address - base - HL7 Italia FHIR Implementation Guide (base) v0.1.1

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:

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:

Other representations of profile: CSV, Excel, Schematron

IG © 2020+ HL7 Italia. Package hl7.fhir.it.base#0.1.1 based on FHIR 4.0.1. Generated 2025-11-18
Links: Table of Contents | QA Report