HL7 Italia FHIR Implementation Guide (base)
0.1.0 - PC Ballot

This page is part of the HL7 Italia FHIR Implementation Guide (base) (v0.1.0: Public Comment 1 Ballot 1) based on FHIR R4. This is the current published version in it's permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

StructureDefinition: AddressItBase

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.

The official URL for this profile is: 

http://hl7.it/fhir/StructureDefinition/Address-it-base

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.

Formal Views of Profile Content

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

This structure is derived from Address

NameFlagsCard.TypeDescription & Constraintsdoco
.. Address I0..*AddressIndirizzo fisico o postale
Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
... address-official 0..1boolean, CodeableConceptIndica l'indirizzo di residenza
URL: http://hl7.org/fhir/StructureDefinition/address-official
... recordCertification 0..*(Complex)Certificazione Indirizzo
URL: http://hl7.it/fhir/StructureDefinition/recordCertification
... line 0..*stringNome completo strada (e.g. Via Corta 1, interno 2)
Example ex-1: Via Corta 1, interno 2
.... iso21090-ADXP-streetName 0..1stringOdonimo, Toponimo Stradale
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName
Example ex-1: Via Corta
.... iso21090-ADXP-streetNameType 0..*stringDenominazione Urbanistica Generica (DUG)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType
Example ex-1: Via
.... address-dug 0..1CodeableConceptCodice Denominazione Urbanistica Generica (DUG)
URL: http://hl7.it/fhir/StructureDefinition/address-dug
Binding: ISTAT - DUG (extensible)
Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
.... iso21090-ADXP-streetNameBase 0..1stringDenominazione Urbanistica Ufficiale (DUF)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase
Example ex-1: Corta
.... iso21090-ADXP-houseNumber 0..1stringNumero Civico
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber
Example ex-1: 1
.... iso21090-SC-coding 0..*CodingCodice Comune
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
... district 0..1stringNome della Provincia
Example General: Campobasso
.... iso21090-SC-coding 0..*CodingCodice Provincia
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
... state 0..1stringSotto-unità dello stato (Regione).
Example Regione: Lazio
.... iso21090-SC-coding 0..*CodingCodice Regione
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
... postalCode I0..1stringPostal code for area
Example General: 50125
... country 0..1stringStato
Example Nome Stato: Italia
.... iso21090-SC-coding 0..*CodingCodice Stato
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Address I0..*AddressIndirizzo fisico o postale

Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
... id 0..1stringUnique id for inter-element referencing
... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
... address-official I0..1boolean, CodeableConceptIndica l'indirizzo di residenza
URL: http://hl7.org/fhir/StructureDefinition/address-official
... use ?!ΣI0..1codehome | work | temp | old | billing - purpose of this address
Binding: AddressUse (required)
Example General: home
... type ΣI0..1codepostal | physical | both
Binding: AddressType (required)
Example General: both
... text ΣI0..1stringText representation of the address
Example General: 137 Nowhere Street, Erewhon 9132
... line ΣI0..*stringNome 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..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-ADXP-streetName I0..1stringOdonimo, Toponimo Stradale
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName

Example ex-1: Via Corta
.... iso21090-ADXP-streetNameType I0..*stringDenominazione Urbanistica Generica (DUG)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType

Example ex-1: Via
.... address-dug I0..1CodeableConceptCodice Denominazione Urbanistica Generica (DUG)
URL: http://hl7.it/fhir/StructureDefinition/address-dug
Binding: ISTAT - DUG (extensible)

Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
.... iso21090-ADXP-streetNameBase I0..1stringDenominazione Urbanistica Ufficiale (DUF)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase

Example ex-1: Corta
.... iso21090-ADXP-houseNumber I0..1stringNumero Civico
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber

Example ex-1: 1
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... city ΣI0..1stringName of city, town etc.
Example General: Erewhon
Example General: Bagno a Ripoli
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-SC-coding I0..*CodingCodice Comune
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... district ΣI0..1stringNome della Provincia
Example General: Madison
Example General: Campobasso
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-SC-coding I0..*CodingCodice Provincia
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... state ΣI0..1stringSotto-unità dello stato (Regione).
Example Regione: Lazio
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-SC-coding I0..*CodingCodice Regione
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... postalCode ΣI0..1stringPostal code for area
Example General: 9132
Example General: 50125
... country ΣI0..1stringStato
Example Nome Stato: Italia
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-SC-coding I0..*CodingCodice Stato
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... period ΣI0..1PeriodTime period when address was/is in use
Example General: {"start":"2010-03-23","end":"2010-07-01"}

doco Documentation for this format

Differential View

This structure is derived from Address

NameFlagsCard.TypeDescription & Constraintsdoco
.. Address I0..*AddressIndirizzo fisico o postale
Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
... address-official 0..1boolean, CodeableConceptIndica l'indirizzo di residenza
URL: http://hl7.org/fhir/StructureDefinition/address-official
... recordCertification 0..*(Complex)Certificazione Indirizzo
URL: http://hl7.it/fhir/StructureDefinition/recordCertification
... line 0..*stringNome completo strada (e.g. Via Corta 1, interno 2)
Example ex-1: Via Corta 1, interno 2
.... iso21090-ADXP-streetName 0..1stringOdonimo, Toponimo Stradale
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName
Example ex-1: Via Corta
.... iso21090-ADXP-streetNameType 0..*stringDenominazione Urbanistica Generica (DUG)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType
Example ex-1: Via
.... address-dug 0..1CodeableConceptCodice Denominazione Urbanistica Generica (DUG)
URL: http://hl7.it/fhir/StructureDefinition/address-dug
Binding: ISTAT - DUG (extensible)
Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
.... iso21090-ADXP-streetNameBase 0..1stringDenominazione Urbanistica Ufficiale (DUF)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase
Example ex-1: Corta
.... iso21090-ADXP-houseNumber 0..1stringNumero Civico
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber
Example ex-1: 1
.... iso21090-SC-coding 0..*CodingCodice Comune
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
... district 0..1stringNome della Provincia
Example General: Campobasso
.... iso21090-SC-coding 0..*CodingCodice Provincia
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
... state 0..1stringSotto-unità dello stato (Regione).
Example Regione: Lazio
.... iso21090-SC-coding 0..*CodingCodice Regione
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
... postalCode I0..1stringPostal code for area
Example General: 50125
... country 0..1stringStato
Example Nome Stato: Italia
.... iso21090-SC-coding 0..*CodingCodice Stato
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Address I0..*AddressIndirizzo fisico o postale

Example Completo: {"line":["Via dei Ciliegi 15"],"city":"Artimino","state":"PO","postalCode":"59015","country":"IT"}
... id 0..1stringUnique id for inter-element referencing
... extension I0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
... address-official I0..1boolean, CodeableConceptIndica l'indirizzo di residenza
URL: http://hl7.org/fhir/StructureDefinition/address-official
... use ?!ΣI0..1codehome | work | temp | old | billing - purpose of this address
Binding: AddressUse (required)
Example General: home
... type ΣI0..1codepostal | physical | both
Binding: AddressType (required)
Example General: both
... text ΣI0..1stringText representation of the address
Example General: 137 Nowhere Street, Erewhon 9132
... line ΣI0..*stringNome 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..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-ADXP-streetName I0..1stringOdonimo, Toponimo Stradale
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName

Example ex-1: Via Corta
.... iso21090-ADXP-streetNameType I0..*stringDenominazione Urbanistica Generica (DUG)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameType

Example ex-1: Via
.... address-dug I0..1CodeableConceptCodice Denominazione Urbanistica Generica (DUG)
URL: http://hl7.it/fhir/StructureDefinition/address-dug
Binding: ISTAT - DUG (extensible)

Example ex-1: {"coding":[{"system":"http://registry.geodati.gov.it/dug","code":"67","display":"via"}]}
.... iso21090-ADXP-streetNameBase I0..1stringDenominazione Urbanistica Ufficiale (DUF)
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetNameBase

Example ex-1: Corta
.... iso21090-ADXP-houseNumber I0..1stringNumero Civico
URL: http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber

Example ex-1: 1
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... city ΣI0..1stringName of city, town etc.
Example General: Erewhon
Example General: Bagno a Ripoli
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-SC-coding I0..*CodingCodice Comune
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... district ΣI0..1stringNome della Provincia
Example General: Madison
Example General: Campobasso
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-SC-coding I0..*CodingCodice Provincia
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... state ΣI0..1stringSotto-unità dello stato (Regione).
Example Regione: Lazio
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-SC-coding I0..*CodingCodice Regione
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... postalCode ΣI0..1stringPostal code for area
Example General: 9132
Example General: 50125
... country ΣI0..1stringStato
Example Nome Stato: Italia
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension I0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... iso21090-SC-coding I0..*CodingCodice Stato
URL: http://hl7.org/fhir/StructureDefinition/iso21090-SC-coding
Binding: (unbound) (example)
.... value 0..1stringPrimitive value for string
Max Length: 1048576
... period ΣI0..1PeriodTime period when address was/is in use
Example General: {"start":"2010-03-23","end":"2010-07-01"}

doco Documentation for this format

 

Other representations of profile: Schematron

Terminology Bindings

Terminology Bindings

PathConformanceValueSet
Address.userequiredAddressUse
Address.typerequiredAddressType

Constraints

Constraints

IdPathDetailsRequirements
ele-1AddressAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
it-address-officialAddressSe 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() )
ele-1Address.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.extension:residenzaAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.extension:residenzaMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.extension:certificazioneIndirizzoAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.extension:certificazioneIndirizzoMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.useAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Address.typeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Address.textAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Address.lineAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Address.line.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.line.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.line.extension:odonimoAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.line.extension:odonimoMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.line.extension:denominazioneUrbanisticaGenericaAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.line.extension:denominazioneUrbanisticaGenericaMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.line.extension:dugCodeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.line.extension:dugCodeMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.line.extension:denominazioneUrbanisticaUfficialeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.line.extension:denominazioneUrbanisticaUfficialeMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.line.extension:houseNumberAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.line.extension:houseNumberMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.cityAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Address.city.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.city.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.city.extension:codiceComuneAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.city.extension:codiceComuneMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.districtAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Address.district.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.district.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.district.extension:codiceProvinciaAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.district.extension:codiceProvinciaMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.stateAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Address.state.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.state.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.state.extension:codiceRegioneAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.state.extension:codiceRegioneMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.postalCodeAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
it-postal-code-patternAddress.postalCodeI codici postali italiani hanno un pattern 'nnnnn' (n intero)
: (country in 'it' | 'ita' | 'italia' | 'italy').not() or matches('^[1-9]\\d{4}$')
ele-1Address.countryAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ele-1Address.country.extensionAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.country.extensionMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.country.extension:codiceStatoAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1Address.country.extension:codiceStatoMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Address.periodAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())