| Package | hl7.fhir.uv.v2mappings |
| Resource Type | ConceptMap |
| Id | datatype-xad-to-address |
| FHIR Version | R4 |
| Source | http://hl7.org/fhir/uv/v2mappings/https://build.fhir.org/ig/HL7/v2-to-fhir/ConceptMap-datatype-xad-to-address.html |
| URL | http://hl7.org/fhir/uv/v2mappings/ConceptMap/datatype-xad-to-address |
| Version | 1.0.0 |
| Status | active |
| Date | 2025-07-29 |
| Name | DatatypeXADToAddress |
| Title | Datatype XAD to Address Map |
| Realm | uv |
| Authority | hl7 |
| Description | This ConceptMap represents a mapping from the HL7 V2 Datatype XAD to the FHIR Address Data Type. |
| Copyright | Copyright (c) 2025, HL7 International, Inc., All Rights Reserved. |
No resources found
No resources found
Note: links and images are rebased to the (stated) source
Generated Narrative: ConceptMap datatype-xad-to-address
Mapping from (not specified) to (not specified)
Group 1 Mapping from unspecified code system to unspecified code system
| Source Concept Details | Relationship | Target Concept Details | Comment | |||
| Codes from | ComputableANTLR | Codes from | ||||
| XAD.1 | Street Address | is equivalent to | line[1-3] | line[1-3] | ||
| XAD.2 | Other Designation | is equivalent to | line[4] | line[4] | Note that XAD.1 is mapped to Address.line as well using the SAD data type. That may yield up to three address lines. | |
| XAD.3 | City | is equivalent to | city | city | ||
| XAD.4 | State or Province | is equivalent to | state | state | ||
| XAD.5 | Zip or Postal Code | is equivalent to | postalCode | postalCode | ||
| XAD.6 | Country | is equivalent to | country | country | ||
| XAD.7 | Address Type | IF XAD.7 IN ("M", "SH") | is equivalent to | type | type | |
| XAD.7 | Address Type | IF XAD.7 IN ("BA", "BI", "C", "B", "H", "O") | is equivalent to | use | use | |
| XAD.7 | Address Type | IF XAD.7 EQUALS "HV" | is equivalent to | extension[1].url | extension[1].url | |
| XAD.7 | Address Type | IF XAD.7 EQUALS "HV" | is equivalent to | extension[1].valueCode | extension[1].valueCode | |
| XAD.7 | Address Type | is equivalent to | extension[2].uri | extension[2].uri | ||
| XAD.7 | Address Type | is equivalent to | extension[2].valueCodeableConcept.coding.value | extension[2].valueCodeableConcept.coding.value | ||
| XAD.7 | Address Type | is equivalent to | extension[2].valueCodeableConcept.coding.system | extension[2].valueCodeableConcept.coding.system | ||
| XAD.9 | County/Parish Code | is equivalent to | district | district | ||
| XAD.10 | Census Tract | is equivalent to | extension[3].url | extension[3].url | ||
| XAD.10 | Census Tract | is equivalent to | extension[3].valueCode | extension[3].valueCode | ||
| XAD.12 | Address Validity Range | is equivalent to | period | period | ||
| XAD.13 | Effective Date | is equivalent to | period.start | period.start | ||
| XAD.14 | Expiration Date | is equivalent to | period.end | period.end | ||
| XAD.19 | Addressee | is equivalent to | line[5] | line[5] | There is an existing ADXP extension if we prefer | |
FHIR{
"resourceType": "ConceptMap",
"id": "datatype-xad-to-address",
"text": {
"status": "generated",
"div": "<!-- snip (see above) -->"
},
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "derived-from"
},
{
"url": "label",
"valueString": "Datatype XAD to Address.fsh"
},
{
"url": "url",
"valueUri": "https://docs.google.com/spreadsheets/d/1hSTEur557TIKPEKZRoprVw-uNpw12JZtri-iQsc4uQ0/edit#gid=0"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode": "oo"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "informative",
"_valueCode": {
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
"valueCanonical": "http://hl7.org/fhir/uv/v2mappings/ImplementationGuide/hl7.fhir.uv.v2mappings"
}
]
}
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/ConceptMap/datatype-xad-to-address",
"version": "1.0.0",
"name": "DatatypeXADToAddress",
"title": "Datatype XAD to Address Map",
"status": "active",
"experimental": true,
"date": "2025-07-29",
"publisher": "HL7 International / Orders and Observations",
"contact": [
{
"name": "HL7 Orders and Observations Workgroup",
"telecom": [
{
"system": "url",
"value": "http://www.hl7.org/Special/committees/orders"
}
]
}
],
"description": "This ConceptMap represents a mapping from the HL7 V2 Datatype XAD to the FHIR Address Data Type.",
"jurisdiction": [
{
"coding": [
{
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code": "001"
}
]
}
],
"copyright": "Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.",
"group": [
{
"element": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "SAD"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.1",
"display": "Street Address",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "line[1-3]",
"display": "line[1-3]",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ST"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.2",
"display": "Other Designation",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "line[4]",
"display": "line[4]",
"equivalence": "equivalent",
"comment": "Note that XAD.1 is mapped to Address.line as well using the SAD data type. That may yield up to three address lines."
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ST"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.3",
"display": "City",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "city",
"display": "city",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ST"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.4",
"display": "State or Province",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "state",
"display": "state",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ST"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.5",
"display": "Zip or Postal Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "postalCode",
"display": "postalCode",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ID"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.6",
"display": "Country",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "country",
"display": "country",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ID"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.7",
"display": "Address Type",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70190-to-address-type"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "type",
"display": "type",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Computable-ANTLR",
"value": "IF XAD.7 IN (\"M\", \"SH\")"
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ID"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.7",
"display": "Address Type",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70190-to-address-use"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "use",
"display": "use",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Computable-ANTLR",
"value": "IF XAD.7 IN (\"BA\", \"BI\", \"C\", \"B\", \"H\", \"O\")"
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ID"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.7",
"display": "Address Type",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "uri"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "assignment",
"valueString": "\"http://hl7.org/fhir/StructureDefinition/iso21090-AD-use\""
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "extension[1].url",
"display": "extension[1].url",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Computable-ANTLR",
"value": "IF XAD.7 EQUALS \"HV\""
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ID"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.7",
"display": "Address Type",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "extension[1].valueCode",
"display": "extension[1].valueCode",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Computable-ANTLR",
"value": "IF XAD.7 EQUALS \"HV\""
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ID"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.7",
"display": "Address Type",
"target": [
{
"code": "extension[2].uri",
"display": "extension[2].uri",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ID"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.7",
"display": "Address Type",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "extension[2].valueCodeableConcept.coding.value",
"display": "extension[2].valueCodeableConcept.coding.value",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ID"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.7",
"display": "Address Type",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "uri"
},
{
"url": "assignment",
"valueString": "\"http://terminology.hl7.org/CodeSystem/v2-0190\""
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "extension[2].valueCodeableConcept.coding.system",
"display": "extension[2].valueCodeableConcept.coding.system",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.9",
"display": "County/Parish Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "district",
"display": "district",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.10",
"display": "Census Tract",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "uri"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "assignment",
"valueString": "\"http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-censusTract\""
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "extension[3].url",
"display": "extension[3].url",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.10",
"display": "Census Tract",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "extension[3].valueCode",
"display": "extension[3].valueCode",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "DR"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.12",
"display": "Address Validity Range",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "Period"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "period",
"display": "period",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "DTM"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.13",
"display": "Effective Date",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "dateTime"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "period.start",
"display": "period.start",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "DTM"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.14",
"display": "Expiration Date",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "dateTime"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "period.end",
"display": "period.end",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ST"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "XAD.19",
"display": "Addressee",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "string"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "line[5]",
"display": "line[5]",
"equivalence": "equivalent",
"comment": "There is an existing ADXP extension if we prefer"
}
]
}
]
}
]
}