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

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 2024-12-12

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

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

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.

ShortIndirizzo fisico o postale
Comments

Nota: address è per indirizzi postali, non per la localizzazione fisica.

Alternate NamesIndirizzo
Example<br/><b>Completo</b>:{ "line" : ["Via dei Ciliegi 15"], "city" : "Artimino", "state" : "PO", "postalCode" : "59015", "country" : "IT" }
Invariantsit-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 Nameresidenza
Definition

Indica se questo indirizzo è quello di residenza, come indirizzo 'ufficialmente registrato' address.

ShortIndica l'indirizzo di residenza
Control0..1
TypeExtension(Official Address) (Extension Type: Choice of: boolean, CodeableConcept)
4. Address.extension:certificazioneIndirizzo
Slice NamecertificazioneIndirizzo
Definition

Indica che i dati di questo indirizzo sono stati certificati da una specifica entità

ShortCertificazione Indirizzo
TypeExtension(Certificazione) (Complex Extension)
6. Address.line
ShortNome completo strada (e.g. Via Corta 1, interno 2)
Example<br/><b>ex-1</b>:Via Corta 1, interno 2
8. Address.line.extension:odonimo
Slice Nameodonimo
ShortOdonimo, Toponimo Stradale
Control0..1
TypeExtension(ADXP Street Name) (Extension Type: string)
Requirements

Nome della Strada

Alternate NamesToponimo Stradale
Example<br/><b>ex-1</b>:Via Corta
10. Address.line.extension:denominazioneUrbanisticaGenerica
Slice NamedenominazioneUrbanisticaGenerica
ShortDenominazione Urbanistica Generica (DUG)
TypeExtension(ADXP Street Name Type) (Extension Type: string)
Example<br/><b>ex-1</b>:Via
12. Address.line.extension:dugCode
Slice NamedugCode
ShortCodice Denominazione Urbanistica Generica (DUG)
Control0..1
TypeExtension(DUG (Denominazione Urbanistica Generica)) (Extension Type: CodeableConcept)
Alternate Namesspecie
Example<br/><b>ex-1</b>:{ "coding" : [{ "system" : "http://registry.geodati.gov.it/dug", "code" : "67", "display" : "via" }] }
14. Address.line.extension:denominazioneUrbanisticaUfficiale
Slice NamedenominazioneUrbanisticaUfficiale
ShortDenominazione Urbanistica Ufficiale (DUF)
Control0..1
TypeExtension(ADXP Street Name Base) (Extension Type: string)
Alternate Namesdenominazione
Example<br/><b>ex-1</b>:Corta
16. Address.line.extension:houseNumber
Slice NamehouseNumber
ShortNumero Civico
Control0..1
TypeExtension(ADXP House Number) (Extension Type: string)
Requirements

Numero Civico

Example<br/><b>ex-1</b>:1
18. Address.city
Definition

The name of the city, town, village or other community or delivery center.

Alternate NamesComune
Example<br/><b>General</b>:Bagno a Ripoli
20. Address.city.extension:codiceComune
Slice NamecodiceComune
ShortCodice Comune
BindingThe codes SHOULD be taken from http://terminology.hl7.it/ValueSet/istat-comune
(preferred to http://terminology.hl7.it/ValueSet/istat-comune)
TypeExtension(SC-coding) (Extension Type: Coding)
22. Address.district
Definition

Nome dell'area amministrativa (county). Per gli indirizzi italiani è usato per indicare la Provincia

ShortNome della Provincia
Alternate NamesProvincia
Example<br/><b>General</b>:Campobasso
24. Address.district.extension:codiceProvincia
Slice NamecodiceProvincia
ShortCodice Provincia
BindingThe codes SHOULD be taken from http://terminology.hl7.it/ValueSet/istat-provincia
(preferred to http://terminology.hl7.it/ValueSet/istat-provincia)
TypeExtension(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"

ShortSotto-unità dello stato (Regione).
Alternate NamesRegione
Example<br/><b>Regione</b>:Lazio
28. Address.state.extension:codiceRegione
Slice NamecodiceRegione
ShortCodice Regione
BindingThe codes SHOULD be taken from http://terminology.hl7.it/ValueSet/istat-regione
(preferred to http://terminology.hl7.it/ValueSet/istat-regione)
TypeExtension(SC-coding) (Extension Type: Coding)
30. Address.postalCode
Comments

I codici postali italiani hanno un pattern '[1,9]\d{4}'.

Alternate NamesCAP, postcode
Example<br/><b>General</b>:50125
Invariantsit-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
ShortStato
Example<br/><b>Nome Stato</b>:Italia
34. Address.country.extension:codiceStato
Slice NamecodiceStato
ShortCodice Stato
BindingThe codes SHOULD be taken from http://terminology.hl7.it/ValueSet/istat-stato
(preferred to http://terminology.hl7.it/ValueSet/istat-stato)
TypeExtension(SC-coding) (Extension Type: Coding)

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

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.

ShortIndirizzo 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).

Control0..*
This element is affected by the following invariants: ele-1
Is Modifierfalse
Alternate NamesIndirizzo
Example<br/><b>Completo</b>:{ "line" : ["Via dei Ciliegi 15"], "city" : "Artimino", "state" : "PO", "postalCode" : "59015", "country" : "IT" }
Invariantsele-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 Nameresidenza
Definition

Indica se questo indirizzo è quello di residenza, come indirizzo 'ufficialmente registrato' address.

ShortIndica l'indirizzo di residenza
Control0..1
TypeExtension(Official Address) (Extension Type: Choice of: boolean, CodeableConcept)
Is Modifierfalse
Summaryfalse
Invariantsele-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 NamecertificazioneIndirizzo
Definition

Indica che i dati di questo indirizzo sono stati certificati da una specifica entità

ShortCertificazione Indirizzo
Control0..*
TypeExtension(Certificazione) (Complex Extension)
Is Modifierfalse
Invariantsele-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.

Shorthome | 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.

Control0..1
BindingThe codes SHALL be taken from AddressUsehttp://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.

Typecode
Is Modifiertrue because This is labeled as "Is Modifier" because applications should not mistake a temporary or old address etc.for a current/permanent one
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Requirements

Allows an appropriate address to be chosen from a list of many.

Example<br/><b>General</b>:home
Invariantsele-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.

ShortNome completo strada (e.g. Via Corta 1, interno 2)Street name, number, direction & P.O. Box etc.
Control0..*
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Example<br/><b>General</b>:137 Nowhere Street <br/><b>ex-1</b>:Via Corta 1, interno 2
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
10. Address.line.extension:odonimo
Slice Nameodonimo
Definition

streetName.

ShortOdonimo, Toponimo Stradale
Control0..1
TypeExtension(ADXP Street Name) (Extension Type: string)
Is Modifierfalse
Requirements

Nome della Strada

Alternate NamesToponimo Stradale
Example<br/><b>ex-1</b>:Via Corta
Invariantsele-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 NamedenominazioneUrbanisticaGenerica
Definition

The designation given to the street. (e.g. Street, Avenue, Crescent, etc.).

ShortDenominazione Urbanistica Generica (DUG)
Control0..*
TypeExtension(ADXP Street Name Type) (Extension Type: string)
Is Modifierfalse
Example<br/><b>ex-1</b>:Via
Invariantsele-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 NamedugCode
Definition

An Extension

ShortCodice Denominazione Urbanistica Generica (DUG)
Control0..1
This element is affected by the following invariants: ele-1
TypeExtension(DUG (Denominazione Urbanistica Generica)) (Extension Type: CodeableConcept)
Is Modifierfalse
Alternate Namesspecie
Example<br/><b>ex-1</b>:{ "coding" : [{ "system" : "http://registry.geodati.gov.it/dug", "code" : "67", "display" : "via" }] }
Invariantsele-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 NamedenominazioneUrbanisticaUfficiale
Definition

The base name of a roadway or artery recognized by a municipality (excluding street type and direction).

ShortDenominazione Urbanistica Ufficiale (DUF)
Control0..1
TypeExtension(ADXP Street Name Base) (Extension Type: string)
Is Modifierfalse
Alternate Namesdenominazione
Example<br/><b>ex-1</b>:Corta
Invariantsele-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 NamehouseNumber
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.

ShortNumero Civico
Control0..1
TypeExtension(ADXP House Number) (Extension Type: string)
Is Modifierfalse
Requirements

Numero Civico

Example<br/><b>ex-1</b>:1
Invariantsele-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.

ShortName of city, town etc.
Control0..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Alternate NamesMunicpality, Comune
Example<br/><b>General</b>:Erewhon <br/><b>General</b>:Bagno a Ripoli
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
22. Address.city.extension:codiceComune
Slice NamecodiceComune
Definition

Provides a coded expression for the content represented in a string.

ShortCodice Comune
Control0..*
This element is affected by the following invariants: ele-1
TypeExtension(SC-coding) (Extension Type: Coding)
Is Modifierfalse
Invariantsele-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())
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).

ShortNome 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.

Control0..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Alternate NamesCounty, Provincia
Example<br/><b>General</b>:Madison <br/><b>General</b>:Campobasso
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
26. Address.district.extension:codiceProvincia
Slice NamecodiceProvincia
Definition

Provides a coded expression for the content represented in a string.

ShortCodice Provincia
Control0..*
This element is affected by the following invariants: ele-1
TypeExtension(SC-coding) (Extension Type: Coding)
Is Modifierfalse
Invariantsele-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())
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).

ShortSotto-unità dello stato (Regione).Sub-unit of country (abbreviations ok)
Control0..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Alternate NamesProvince, Territory, Regione
Example<br/><b>Regione</b>:Lazio
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
30. Address.state.extension:codiceRegione
Slice NamecodiceRegione
Definition

Provides a coded expression for the content represented in a string.

ShortCodice Regione
Control0..*
This element is affected by the following invariants: ele-1
TypeExtension(SC-coding) (Extension Type: Coding)
Is Modifierfalse
Invariantsele-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())
32. Address.postalCode
Definition

A postal code designating a region defined by the postal service.

ShortPostal code for area
Comments

I codici postali italiani hanno un pattern '[1,9]\d{4}'.

Control0..1
This element is affected by the following invariants: it-postal-code-pattern
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Alternate NamesZip, CAP, postcode
Example<br/><b>General</b>:9132 <br/><b>General</b>:50125
Invariantsele-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.

ShortStatoCountry (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.

Control0..1
Typestring
Is Modifierfalse
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Example<br/><b>Nome Stato</b>:Italia
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
36. Address.country.extension:codiceStato
Slice NamecodiceStato
Definition

Provides a coded expression for the content represented in a string.

ShortCodice Stato
Control0..*
This element is affected by the following invariants: ele-1
TypeExtension(SC-coding) (Extension Type: Coding)
Is Modifierfalse
Invariantsele-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())

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

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.

ShortIndirizzo fisico o postale
Comments

Nota: address è per indirizzi postali, non per la localizzazione fisica.

Control0..*
This element is affected by the following invariants: ele-1
Is Modifierfalse
Alternate NamesIndirizzo
Example<br/><b>Completo</b>:{ "line" : ["Via dei Ciliegi 15"], "city" : "Artimino", "state" : "PO", "postalCode" : "59015", "country" : "IT" }
Invariantsele-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.

ShortUnique id for inter-element referencing
Control0..1
Typestring
Is Modifierfalse
XML FormatIn the XML format, this property is represented as an attribute.
Summaryfalse
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.

ShortAdditional 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.

Control0..*
TypeExtension
Is Modifierfalse
Summaryfalse
Alternate Namesextensions, user content
Invariantsele-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())
SlicingThis 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 Nameresidenza
    Definition

    Indica se questo indirizzo è quello di residenza, come indirizzo 'ufficialmente registrato' address.

    ShortIndica l'indirizzo di residenza
    Control0..1
    TypeExtension(Official Address) (Extension Type: Choice of: boolean, CodeableConcept)
    Is Modifierfalse
    Summaryfalse
    Invariantsele-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 NamecertificazioneIndirizzo
    Definition

    Indica che i dati di questo indirizzo sono stati certificati da una specifica entità

    ShortCertificazione Indirizzo
    Control0..*
    TypeExtension(Certificazione) (Complex Extension)
    Is Modifierfalse
    Invariantsele-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.

    Shorthome | 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.

    Control0..1
    BindingThe codes SHALL be taken from AddressUse
    (required to http://hl7.org/fhir/ValueSet/address-use|4.0.1)

    The use of an address.

    Typecode
    Is Modifiertrue because This is labeled as "Is Modifier" because applications should not mistake a temporary or old address etc.for a current/permanent one
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    Allows an appropriate address to be chosen from a list of many.

    Example<br/><b>General</b>:home
    Invariantsele-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.

    Shortpostal | 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).

    Control0..1
    BindingThe 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).

    Typecode
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Example<br/><b>General</b>:both
    Invariantsele-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.

    ShortText 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.

    Control0..1
    Typestring
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    A renderable, unencoded form.

    Example<br/><b>General</b>:137 Nowhere Street, Erewhon 9132
    Invariantsele-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.

    ShortNome completo strada (e.g. Via Corta 1, interno 2)
    Control0..*
    Typestring
    Is Modifierfalse
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Example<br/><b>General</b>:137 Nowhere Street <br/><b>ex-1</b>:Via Corta 1, interno 2
    Invariantsele-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)

    Shortxml:id (or equivalent in JSON)
    Control0..1
    Typestring
    Is Modifierfalse
    XML FormatIn the XML format, this property is represented as an attribute.
    Summaryfalse
    20. Address.line.extension
    Definition

    An Extension

    ShortExtension
    Control0..*
    TypeExtension
    Is Modifierfalse
    Summaryfalse
    Invariantsele-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())
    SlicingThis 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 Nameodonimo
      Definition

      streetName.

      ShortOdonimo, Toponimo Stradale
      Control0..1
      TypeExtension(ADXP Street Name) (Extension Type: string)
      Is Modifierfalse
      Requirements

      Nome della Strada

      Alternate NamesToponimo Stradale
      Example<br/><b>ex-1</b>:Via Corta
      Invariantsele-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 NamedenominazioneUrbanisticaGenerica
      Definition

      The designation given to the street. (e.g. Street, Avenue, Crescent, etc.).

      ShortDenominazione Urbanistica Generica (DUG)
      Control0..*
      TypeExtension(ADXP Street Name Type) (Extension Type: string)
      Is Modifierfalse
      Example<br/><b>ex-1</b>:Via
      Invariantsele-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 NamedugCode
      Definition

      An Extension

      ShortCodice Denominazione Urbanistica Generica (DUG)
      Control0..1
      This element is affected by the following invariants: ele-1
      TypeExtension(DUG (Denominazione Urbanistica Generica)) (Extension Type: CodeableConcept)
      Is Modifierfalse
      Alternate Namesspecie
      Example<br/><b>ex-1</b>:{ "coding" : [{ "system" : "http://registry.geodati.gov.it/dug", "code" : "67", "display" : "via" }] }
      Invariantsele-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 NamedenominazioneUrbanisticaUfficiale
      Definition

      The base name of a roadway or artery recognized by a municipality (excluding street type and direction).

      ShortDenominazione Urbanistica Ufficiale (DUF)
      Control0..1
      TypeExtension(ADXP Street Name Base) (Extension Type: string)
      Is Modifierfalse
      Alternate Namesdenominazione
      Example<br/><b>ex-1</b>:Corta
      Invariantsele-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 NamehouseNumber
      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.

      ShortNumero Civico
      Control0..1
      TypeExtension(ADXP House Number) (Extension Type: string)
      Is Modifierfalse
      Requirements

      Numero Civico

      Example<br/><b>ex-1</b>:1
      Invariantsele-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

      ShortPrimitive value for string
      Control0..1
      Typestring
      Is Modifierfalse
      XML FormatIn the XML format, this property is represented as an attribute.
      Summaryfalse
      Max Length:1048576
      34. Address.city
      Definition

      The name of the city, town, village or other community or delivery center.

      ShortName of city, town etc.
      Control0..1
      Typestring
      Is Modifierfalse
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      Summarytrue
      Alternate NamesMunicpality, Comune
      Example<br/><b>General</b>:Erewhon <br/><b>General</b>:Bagno a Ripoli
      Invariantsele-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)

      Shortxml:id (or equivalent in JSON)
      Control0..1
      Typestring
      Is Modifierfalse
      XML FormatIn the XML format, this property is represented as an attribute.
      Summaryfalse
      38. Address.city.extension
      Definition

      An Extension

      ShortExtension
      Control0..*
      TypeExtension
      Is Modifierfalse
      Summaryfalse
      Invariantsele-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())
      SlicingThis 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 NamecodiceComune
        Definition

        Provides a coded expression for the content represented in a string.

        ShortCodice Comune
        Control0..*
        This element is affected by the following invariants: ele-1
        TypeExtension(SC-coding) (Extension Type: Coding)
        Is Modifierfalse
        Invariantsele-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

        ShortPrimitive value for string
        Control0..1
        Typestring
        Is Modifierfalse
        XML FormatIn the XML format, this property is represented as an attribute.
        Summaryfalse
        Max Length:1048576
        44. Address.district
        Definition

        Nome dell'area amministrativa (county). Per gli indirizzi italiani è usato per indicare la Provincia

        ShortNome 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.

        Control0..1
        Typestring
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Summarytrue
        Alternate NamesCounty, Provincia
        Example<br/><b>General</b>:Madison <br/><b>General</b>:Campobasso
        Invariantsele-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)

        Shortxml:id (or equivalent in JSON)
        Control0..1
        Typestring
        Is Modifierfalse
        XML FormatIn the XML format, this property is represented as an attribute.
        Summaryfalse
        48. Address.district.extension
        Definition

        An Extension

        ShortExtension
        Control0..*
        TypeExtension
        Is Modifierfalse
        Summaryfalse
        Invariantsele-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())
        SlicingThis 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 NamecodiceProvincia
          Definition

          Provides a coded expression for the content represented in a string.

          ShortCodice Provincia
          Control0..*
          This element is affected by the following invariants: ele-1
          TypeExtension(SC-coding) (Extension Type: Coding)
          Is Modifierfalse
          Invariantsele-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

          ShortPrimitive value for string
          Control0..1
          Typestring
          Is Modifierfalse
          XML FormatIn the XML format, this property is represented as an attribute.
          Summaryfalse
          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"

          ShortSotto-unità dello stato (Regione).
          Control0..1
          Typestring
          Is Modifierfalse
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          Summarytrue
          Alternate NamesProvince, Territory, Regione
          Example<br/><b>Regione</b>:Lazio
          Invariantsele-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)

          Shortxml:id (or equivalent in JSON)
          Control0..1
          Typestring
          Is Modifierfalse
          XML FormatIn the XML format, this property is represented as an attribute.
          Summaryfalse
          58. Address.state.extension
          Definition

          An Extension

          ShortExtension
          Control0..*
          TypeExtension
          Is Modifierfalse
          Summaryfalse
          Invariantsele-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())
          SlicingThis 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 NamecodiceRegione
            Definition

            Provides a coded expression for the content represented in a string.

            ShortCodice Regione
            Control0..*
            This element is affected by the following invariants: ele-1
            TypeExtension(SC-coding) (Extension Type: Coding)
            Is Modifierfalse
            Invariantsele-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

            ShortPrimitive value for string
            Control0..1
            Typestring
            Is Modifierfalse
            XML FormatIn the XML format, this property is represented as an attribute.
            Summaryfalse
            Max Length:1048576
            64. Address.postalCode
            Definition

            A postal code designating a region defined by the postal service.

            ShortPostal code for area
            Comments

            I codici postali italiani hanno un pattern '[1,9]\d{4}'.

            Control0..1
            This element is affected by the following invariants: it-postal-code-pattern
            Typestring
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Alternate NamesZip, CAP, postcode
            Example<br/><b>General</b>:9132 <br/><b>General</b>:50125
            Invariantsele-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.

            ShortStato
            Comments

            ISO 3166 3 letter codes can be used in place of a human readable country name.

            Control0..1
            Typestring
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Example<br/><b>Nome Stato</b>:Italia
            Invariantsele-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)

            Shortxml:id (or equivalent in JSON)
            Control0..1
            Typestring
            Is Modifierfalse
            XML FormatIn the XML format, this property is represented as an attribute.
            Summaryfalse
            70. Address.country.extension
            Definition

            An Extension

            ShortExtension
            Control0..*
            TypeExtension
            Is Modifierfalse
            Summaryfalse
            Invariantsele-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())
            SlicingThis 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 NamecodiceStato
              Definition

              Provides a coded expression for the content represented in a string.

              ShortCodice Stato
              Control0..*
              This element is affected by the following invariants: ele-1
              TypeExtension(SC-coding) (Extension Type: Coding)
              Is Modifierfalse
              Invariantsele-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

              ShortPrimitive value for string
              Control0..1
              Typestring
              Is Modifierfalse
              XML FormatIn the XML format, this property is represented as an attribute.
              Summaryfalse
              Max Length:1048576
              76. Address.period
              Definition

              Time period when address was/is in use.

              ShortTime period when address was/is in use
              Control0..1
              TypePeriod
              Is Modifierfalse
              Summarytrue
              Requirements

              Allows addresses to be placed in historical context.

              Example<br/><b>General</b>:{ "start" : "2010-03-23", "end" : "2010-07-01" }
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))