Consolidated CDA (C-CDA)
4.0.0-ballot - STU4 Ballot United States of America flag

Consolidated CDA (C-CDA), published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 4.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-ccda/ and changes regularly. See the Directory of published versions

Logical Model: USRealmAddress - Detailed Descriptions

Draft as of 2024-12-19

Definitions for the USRealmAddress logical model.

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

0. AD
Logical ContainerClinicalDocument (CDA Class)
XML FormatIn the XML format, this property has the namespace urn:hl7-org:v3.
Invariantsshall-city: SHALL contain exactly one [1..1] city (CONF:81-7292). (nullFlavor.exists() or item.city.count() = 1)
shall-streetAddressLine: SHALL contain at least one and not more than 4 streetAddressLine (CONF:81-7291). (nullFlavor.exists() or (item.streetAddressLine.count() >= 1 and item.streetAddressLine.count() <= 4))
should-use: SHOULD contain @use (nullFlavor.exists() or use.exists())
should-country: SHOULD contain country (nullFlavor.exists() or item.country.exists())
81-7296: **SHALL NOT** have mixed content except for white space (CONF:81-7296) (item.xmlText.empty())
81-10024: If the country is US, the state element is required and SHALL be selected from ValueSet StateValueSet but SHOULD have @nullFlavor if the state is unknown. If country is not specified, it's assumed to be US. If country is something other than US, the state MAY be present but MAY be bound to different vocabularies (CONF:81-10024). (nullFlavor.exists() or (item.country.exists() and item.country.xmlText != 'US' and item.country.xmlText != 'USA') or item.state.exists(nullFlavor.exists() or xmlText.memberOf('http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state')))
81-10025: If the country is US, the postalCode element is required but SHOULD have @nullFlavor if the postalCode is unknown. If country is not specified, it's assumed to be US. If country is something other than US, the postalCode MAY be present but MAY be bound to different vocabularies (CONF:81-10025). (nullFlavor.exists() or (item.country.exists() and item.country.xmlText != 'US' and item.country.xmlText != 'USA') or item.postalCode.exists(nullFlavor.exists() or xmlText.matches('[0-9]{5}(-[0-9]{4})?')))
shall-max-ad-parts: SHALL have at most one of each: state, city, postalCode, and country ((item.state.empty() or item.state.count() = 1) and (item.city.empty() or item.city.count() = 1) and (item.postalCode.empty() or item.postalCode.count() = 1) and (item.country.empty() or item.country.count() = 1))
2. AD.nullFlavor
ShortIf addr/@nullFlavor is present, none of the address parts are required.
4. AD.use
ShortIdentifies which address to use for a given purpose.
Comments

Historically this was bound to ValueSet PostalAddressUse urn:oid:2.16.840.1.113883.1.11.10637 STATIC 2005-05-01, but this contained 'CONF' which is not allowed by CDA. So the binding has been removed in the current version of C-CDA.

6. AD.item
8. AD.item.country
BindingThe codes SHALL be taken from Country2
(required to http://terminology.hl7.org/ValueSet/v3-Country2)
10. AD.item.state
Binding

If country is something other than US, the state MAY be present but MAY be bound to different vocabularies

12. AD.item.city
Shortcity is required if nullFlavor is absent
Comments

SHALL contain exactly one [1..1] city (CONF:81-7292).

14. AD.item.postalCode
ShortIf country is US, shall be a 5-digit or 9-digit zip code (##### or #####-####)
16. AD.item.streetAddressLine
ShortMin: 1, Max: 4 streetAddressLine required if nullFlavor is absent
18. AD.useablePeriod
Short𝗨𝗦𝗖𝗗𝗜: Previous Address - Current or prior place where a person may have been located or could have been contacted.
Default Typehttp://hl7.org/cda/stds/core/StructureDefinition/SXPR-TS