×

To enhance security, Multi-Factor Authentication (MFA) is mandatory for all HL7 users. More information

 

C-CDA to and from FHIR Structural Mapping (Jira PSS-1811)

Basics

C-CDA to and from FHIR Structural Mapping (Jira PSS-1811)

1732
Ballot - STU to Normative




Details

This project will establish definitive HL7 mapping guidance for C-CDA templates to FHIR resources conformant with US Core profiles where possible. It also will establish definitive HL7 mapping guidance from US Core profiles and base FHIR resources to C-CDA templates. The scope of the work includes templates in C-CDA R2.1, templates in C-CDA Companion Guide R2 (used in the 2015 Certification Edition Cures Update) and templates relevant for USCDI v2.

The project will be addressed in phases. Phase I. includes CCD, Discharge Summary, Referral Note, Consultation Note, Procedure Note, History and Physical, Progress Note, and Unstructured document types, and focuses on section and entry templates that are associated with USCDI V2 data classes and elements, and on section and entry templates that are required by EHR certification.

The project will:

1. Produce mappings for C-CDA section and C-CDA entry templates to and from FHIR resources using US Core profiles when available. The mappings include mapping at the value set level. This includes relevant entries associated with USCDI V2 data classes and data elements including provenance. High-priority sections include (using C-CDA Section Names): Patients, Encounters, Problems, Allergies/Intolerances, Vital Signs, Results, Medications Administered, Social History, Procedures, Immunizations, History of Present Illness, Medications, Plan of Treatment, Reason for Visit, and other sections of interest and agreed to using as a starting point the initial mappings established in the C-CDA on FHIR R1 implementation guide, as well as community developed mappings.

2. Propose additional FHIR attributes, extensions and/or FHIR Core additions through the respective FHIR resource stewards as identified and appropriate.

3. Propose additional CDA extensions and new template designs or revisions for existing C-CDA templates through SDWG as appropriate.

4. Contribute to the list of value set alignment issues being documented under the 2021 Annual Value Set Update for C-CDA project (PSS 1696). The work of PSS 1696 focuses on building the list of known value set correspondences across C-CDA value sets and value sets used in US Core profiles, and summarizing the status of the alignment.

5. Establish a publication format, informed by the v2-to-FHIR and other mapping efforts, to ballot and publish the proposed definitive mappings, that also enables FHIR standard/IGs and C-CDA IG to reference applicable mappings in context.

Not in scope:

1. Incorporation of new FHIR extensions and/or profiles within the US Core Implementation Guide. The US Core project may consider any proposed FHIR extensions and/or attribute updates for inclusion.

2. Incorporation of new C-CDA templates within the C-CDA Implementation Guide. The Structured Documents workgroup may consider any proposed templates for inclusion.

3. Additional document types of interest not listed in Phase I above, although they may be added through a PSS update when agreed to.

4. Changes to the logical model that is covered in the CDA IG Web Publishing project (PSS-1684).

5. Updates to RIM (V3) mappings in FHIR R4 or updates to mappings in the C-CDA on FHIR IG. This will be managed by the respective projects maintaining those specifications.


There is a growing need to generate C-CDAs from data sourced through FHIR APIs. For wider adaptability and meaningful use, transformed FHIR resources are required to be conformant with US Core profiles using data sourced from C-CDA documents. There is a need for consistency across transformations so the same data will not yield an inappropriate shift in meaning when it is shifted to a different format. Additionally, we need to ensure that data is interpreted consistently regardless if it is being communicated using CDA or FHIR.



1. CDA Implementation Guide Create New Release (specify Lineage) Informative/STU to Normative January 2022 2. FHIR Implementation Guide C-CDA on FHIR IG Informative/STU to Normative January 2022


TO BE ESTABLISHED PSS: https://jira.hl7.org/browse/PSS-1811


The current annual vocabulary value set update project (currently PSS 1696)

Regulatory Agency, Standards Development Organizations (SDOs), Payors,Health Care IT

MDIX, Cerner, Google, MaxMD

ONC currently requires through certification that C-CDA and FHIR US Core are used to support USCDI.

C-CDA to and from US Core Mapping


Yes



2026 June: TSC approved an STU Publication Request for HL7 FHIR® Implementation Guide: C-CDA on FHIR, Edition 2 – US Realm for one year 2024 February: TSC approved STU Publication Request for C-CDA on FHIR for one year.
Organization & Realm

Realm Specific - Enter "U.S." or name of HL7 Affiliate below

U.S.
People

Natalee Agassi



Cross-Group Projects Work Group

Structured Documents Work Group

Status & Dates

Active

STU - Test Period/Accepting Comments

08/12/2021

05/01/2028

2028 May WGM/Ballot

01/01/2026

2026 Jan WGM/Ballot

2025 Jan Ballot Cycle Info: STU Ballot results: Met basic vote requirements. 3 Negatives to reconcile Document Name: HL7 FHIR Implementation Guide: C-CDA on FHIR, Edition 2 - US Realm 2024 Sept Ballot Cycle Info: STU Ballot Results: Postponed Document Name: HL7 FHIR Implementation Guide: C-CDA on FHIR, Release 1- US Realm
Approvals

09/28/2021


Received


All Received




CDA Management Group -- Agreed -- (PSS-1862)
FHIR Management Group -- Agreed -- (PSS-1863)
US Realm -- Agreed -- (PSS-1864)
System Info

161733

PSS-1811



07/02/2026

Anne Wizauer