{
  "description": "This ConceptMap represents a mapping from the HL7 V2 Datatype XAD to the FHIR Address Data Type.",
  "_filename": "ConceptMap-datatype-xad-to-address.json",
  "package_name": "hl7.fhir.uv.v2mappings.r4b",
  "date": "2025-08-25",
  "group": [ {
    "element": [ {
      "code": "XAD.1",
      "target": [ {
        "code": "line[1-3]",
        "display": "line[1-3]",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": -1
          }, {
            "url": "cardinalityMax",
            "valueInteger": -1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Street Address",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "SAD"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.2",
      "target": [ {
        "code": "line[4]",
        "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.",
        "display": "line[4]",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": -1
          }, {
            "url": "cardinalityMax",
            "valueInteger": -1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Other Designation",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ST"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.3",
      "target": [ {
        "code": "city",
        "display": "city",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "City",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ST"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.4",
      "target": [ {
        "code": "state",
        "display": "state",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "State or Province",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ST"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.5",
      "target": [ {
        "code": "postalCode",
        "display": "postalCode",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Zip or Postal Code",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ST"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.6",
      "target": [ {
        "code": "country",
        "display": "country",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Country",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ID"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.7",
      "target": [ {
        "code": "type",
        "display": "type",
        "dependsOn": [ {
          "value": "IF XAD.7 IN (\"M\", \"SH\")",
          "property": "Computable-ANTLR"
        } ],
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "code"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          }, {
            "url": "mappedVia",
            "valueUrl": "ConceptMap/table-hl70190-to-address-type"
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Address Type",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ID"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.7",
      "target": [ {
        "code": "use",
        "display": "use",
        "dependsOn": [ {
          "value": "IF XAD.7 IN (\"BA\", \"BI\", \"C\", \"B\", \"H\", \"O\")",
          "property": "Computable-ANTLR"
        } ],
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "code"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          }, {
            "url": "mappedVia",
            "valueUrl": "ConceptMap/table-hl70190-to-address-use"
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Address Type",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ID"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.7",
      "target": [ {
        "code": "extension[1].url",
        "display": "extension[1].url",
        "dependsOn": [ {
          "value": "IF XAD.7 EQUALS \"HV\"",
          "property": "Computable-ANTLR"
        } ],
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "uri"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          }, {
            "url": "assignment",
            "valueString": "\"http://hl7.org/fhir/StructureDefinition/iso21090-AD-use\""
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Address Type",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ID"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.7",
      "target": [ {
        "code": "extension[1].valueCode",
        "display": "extension[1].valueCode",
        "dependsOn": [ {
          "value": "IF XAD.7 EQUALS \"HV\"",
          "property": "Computable-ANTLR"
        } ],
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "code"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Address Type",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ID"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.7",
      "target": [ {
        "code": "extension[2].uri",
        "display": "extension[2].uri",
        "equivalence": "equivalent"
      } ],
      "display": "Address Type",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ID"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.7",
      "target": [ {
        "code": "extension[2].valueCodeableConcept.coding.value",
        "display": "extension[2].valueCodeableConcept.coding.value",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "code"
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Address Type",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ID"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.7",
      "target": [ {
        "code": "extension[2].valueCodeableConcept.coding.system",
        "display": "extension[2].valueCodeableConcept.coding.system",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "uri"
          }, {
            "url": "assignment",
            "valueString": "\"http://terminology.hl7.org/CodeSystem/v2-0190\""
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Address Type",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ID"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.9",
      "target": [ {
        "code": "district",
        "display": "district",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "County/Parish Code",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "CWE"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.10",
      "target": [ {
        "code": "extension[3].url",
        "display": "extension[3].url",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "uri"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          }, {
            "url": "assignment",
            "valueString": "\"http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-censusTract\""
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Census Tract",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "CWE"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.10",
      "target": [ {
        "code": "extension[3].valueCode",
        "display": "extension[3].valueCode",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Census Tract",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "CWE"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.12",
      "target": [ {
        "code": "period",
        "display": "period",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "Period"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Address Validity Range",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "DR"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.13",
      "target": [ {
        "code": "period.start",
        "display": "period.start",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "dateTime"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Effective Date",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "DTM"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.14",
      "target": [ {
        "code": "period.end",
        "display": "period.end",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "dateTime"
          }, {
            "url": "cardinalityMin",
            "valueInteger": 1
          }, {
            "url": "cardinalityMax",
            "valueInteger": 1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Expiration Date",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "DTM"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    }, {
      "code": "XAD.19",
      "target": [ {
        "code": "line[5]",
        "comment": "There is an existing ADXP extension if we prefer",
        "display": "line[5]",
        "extension": [ {
          "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
          "extension": [ {
            "url": "type",
            "valueCode": "string"
          }, {
            "url": "cardinalityMin",
            "valueInteger": -1
          }, {
            "url": "cardinalityMax",
            "valueInteger": -1
          } ]
        } ],
        "equivalence": "equivalent"
      } ],
      "display": "Addressee",
      "extension": [ {
        "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo",
        "extension": [ {
          "url": "type",
          "valueCode": "ST"
        }, {
          "url": "cardinalityMin",
          "valueInteger": 0
        }, {
          "url": "cardinalityMax",
          "valueInteger": 1
        } ]
      } ]
    } ]
  } ],
  "publisher": "HL7 International / Orders and Observations",
  "jurisdiction": [ {
    "coding": [ {
      "code": "001",
      "system": "http://unstats.un.org/unsd/methods/m49/m49.htm"
    } ]
  } ],
  "name": "DatatypeXADToAddress",
  "copyright": "Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.",
  "type": null,
  "experimental": "true",
  "resourceType": "ConceptMap",
  "title": "Datatype XAD to Address Map",
  "package_version": "1.0.0",
  "extension": [ {
    "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact",
    "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/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"
      } ]
    }
  } ],
  "status": "active",
  "id": "78b6433a-3c1e-4496-9477-6b9afcdfb637",
  "kind": null,
  "url": "http://hl7.org/fhir/uv/v2mappings/ConceptMap/datatype-xad-to-address",
  "version": "1.0.0",
  "contact": [ {
    "name": "HL7 Orders and Observations Workgroup",
    "telecom": [ {
      "value": "http://www.hl7.org/Special/committees/orders",
      "system": "url"
    } ]
  } ]
}