C-CDA on FHIR, published by HL7 International / Cross-Group Projects. This guide is not an authorized publication; it is the continuous build for version 1.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/ccda-on-fhir/ and changes regularly. See the Directory of published versions

Terminology Maps (Concept Maps)

This page includes terminology mapping from CDA → FHIR and FHIR → CDA in two separate sections. These terminology mappings are not structural. For structural transformations, please refer to the general structural guidance.

These terminology maps use the ConceptMap resource which translates a source terminology to a target terminology. In addition, the specific term maps in this guide are often not semantically equivalent and may be incomplete. For these reasons, we include two maps for each terminology group, one for CDA → FHIR and another for FHIR → CDA, shown in multiple sub-lists on this page.

Note that these maps are directly referenced in the structural guidance tables and do not include any large vocabularly mappings (i.e. each of the mappings below has under 50 terms).

CDA to FHIR Terminology Mapping

Shown below are terminology mappings for use in moving from CDA → FHIR. Entry specific maps are shown first then followed by general maps which may be referenced across multiple clinical domains.

Entry Specific CDA to FHIR Resource ConceptMaps

• Allergy Intolerance Observation value (CDA) → AllergyIntolerance type (FHIR)
• Allergy Intolerance Observation value (CDA) → AllergyIntolerance category (FHIR)
• Allergy Status Observation (CDA) → AllergyIntolerance clinicalStatus (FHIR)
• Criticality value (CDA) → criticality (FHIR)
• Immunization Activity statusCode (CDA) → Immunization status (FHIR)
• Immunization Refusal Reason (CDA) → Immunization statusReason (FHIR)
• Medication Activity statusCode (CDA) → MedicationRequest status (FHIR)
• No Known Allergies (CDA) → negated code (FHIR)
• Problem Status Observation value (CDA) → Condition clinicalStatus (FHIR)
• Procedure Status (CDA) → Procedure status (FHIR)
• Section code (CDA) → Condition category (FHIR)
• Severity Observation value (CDA) → Reaction Event severity (FHIR)

General CDA to FHIR ConceptMaps

• Addr use (CDA) → Address use (FHIR)
• Administrative Gender (CDA) → Patient gender (FHIR)
• Name use (CDA) → Name use (FHIR)
• NullFlavor (CDA) → Data Absent Reason code (FHIR)
• Telecom use (CDA) → telecom contact point use (FHIR)
• Telecom value (CDA) → telecom contact point type (FHIR)

FHIR to CDA Terminology Mapping

Shown below are terminology mappings for use in moving from FHIR → CDA. Resource specific maps are shown first then followed by general maps which may be referenced across multiple clinical domains.

Resource Specific FHIR to CDA Entry ConceptMaps

• AllergyIntolerance type (FHIR) → Allergy Intolerance Observation value (CDA)
• AllergyIntolerance category (FHIR) → Allergy Intolerance Observation value (CDA)
• AllergyIntolerance clinicalStatus (FHIR) → Allergy Status Observation (CDA)
• Criticality (FHIR) → Criticality value (CDA)
• Immunization site (FHIR) → Immunization ApproachSiteCode (CDA)
• Immunization status (FHIR) → Immunization Activity statusCode (CDA)
• Immunization statusReason (FHIR) → Immunization Refusal Reason (CDA)
• MedicationRequest status(FHIR) → Medication Activity statusCode (CDA)
• Negated code (FHIR) → No Known Allergies (CDA)
• Condition clinicalStatus (FHIR) → Problem Status Observation value (CDA)
• Procedure status (FHIR) → Procedure Status (CDA)
• Condition category (FHIR) → Section code (CDA)
• Reaction Event severity (FHIR) → Severity Observation value (CDA)

General FHIR to CDA ConceptMaps

• Address use (FHIR) → Addr use (CDA)
• Administrative gender (FHIR) → Administrative Gender (CDA)
• Data Absent Reason code (FHIR) → NullFlavor (CDA)
• Name use (FHIR) → Name use (CDA)
• Telecom contact point type (FHIR) → Telecom value (CDA)
• Telecom contact point use (FHIR) → Telecom use (CDA)