Short Description

C-CDAs are everywhere in the United States and HL7 is developing a map to guide transformation from C-CDA to FHIR (and back!). Please join multiple vendors engaged in this important work.

Long Description

Current estimates are that billions of C-CDA clinical documents are exchanged annually in the United States. To make this data easier to use and integrate with newer FHIR R4 US CORE conformant resources, the Cross Group Project workgroup ( launched a project ( to develop a mapping between the standards. This also includes the ability to take US CORE conformant FHIR resources and present that information in C-CDA clinical documents.

The work to date has created multiple spreadsheets and informative guidance on this process ( The project group has also collected mapping samples from multiple vendors from a common input CCD to compare and ultimately, align on best practice recommendation. At this Connectathon, we are looking to continue this effort and generate mapping artifacts to support the a future HL7 ballot for this mapping project.


Test mappings and implementation guide. 

Related Tracks?


Call for participants

Vendors who generate or consume C-CDA/FHIR data and are interested in mapping information between the respective standards.

Track Prerequisites

Have developed mappings for at least one C-CDA entry to the relevant FHIR resource 

Have basic knowledge on C-CDA and FHIR IG

Track Lead(s)

Chun Li, Jay Lyle

Track Lead Email(s)

Specification Information

Zulip stream

Track Kick off Call

April 24th 10am, 2023

Chun Li is inviting you to a scheduled Zoom meeting.

Topic: Chun Li's Personal Meeting Room

Join Zoom Meeting

Meeting ID: 797 263 3415
Passcode: 4SMbb5
One tap mobile
+13052241968,,7972633415#,,,,*472771# US
+13092053325,,7972633415#,,,,*472771# US

Dial by your location
        +1 305 224 1968 US
        +1 309 205 3325 US
        +1 312 626 6799 US (Chicago)
        +1 646 931 3860 US
        +1 929 205 6099 US (New York)
        +1 301 715 8592 US (Washington DC)
        +1 253 215 8782 US (Tacoma)
        +1 346 248 7799 US (Houston)
        +1 360 209 5623 US
        +1 386 347 5053 US
        +1 507 473 4847 US
        +1 564 217 2000 US
        +1 669 444 9171 US
        +1 669 900 6833 US (San Jose)
        +1 689 278 1000 US
        +1 719 359 4580 US
        +1 253 205 0468 US
Meeting ID: 797 263 3415
Passcode: 472771
Find your local number:


Passcode: 5Sv7wz%M

Attendance sheet:

Report out:

System Roles

1)      Vendors that currently produce C-CDA clinical documents and seeks to produce the same data as US CORE conformant FHIR R4 resources.

2)      An organization (or vendor) which receives C-CDA clinical documents and seeks to transform these data to US CORE conformant FHIR resources

3)      Vendors that host FHIR servers and are seeking guidance for how to assemble these data into C-CDA 2.1 conformant clinical documents.

We will work with interested vendors in advance to come with some example mappings between the standards to facilitate discussion during the connectathon. Vendors do not need active servers to participate, although technologies that can facilitate real-time mapping are very welcome.

We will use the same inbound CCD example to compare the outbound FHIR resources. The CCD example can be found in here: The vendor's output will be uploaded to the same repo. 

We may use multiple tools for the visualization of C-CDA and FHIR data. We may also use previously developed tools to facilitate the visualization of mapping data between relevant standards (e.g.

Testing Scenario:


  1. Discuss C-CDA to FHIR mapping artifacts and best practice recommendations for the following clinical domains:

Priority 1 domains:

-          Results (Lab)

-          Vital Signs

-          Social History

Priority 2 domains:

-          Encounter

-          Clinical Notes

-          Plan of Care / Treatment Plan

-          Other ancillary area

2. compare and discuss FHIR to C-CDA mapping (example inbounding FHIR PAMPI resources + bundle: Example Data)

3. Review the comments for the ballot


Collect different vendor's mappings and compare them. Discuss the common and different approaches and align on a consensus mapping recommendation, which will be part of the future ballot.


Having a pool of vendors' mappings from the common CCD construct to ease the comparison. These are hosted in

We welcome anyone who have developed mappings for at least one C-CDA entry to the relevant FHIR resource in the discussion. The session will focus on mapping C-CDA entries to FHIR resources, and if there is time and interest, we will consider mapping from FHIR to C-CDA.

Success Criteria:

Create mapping artifacts of recommendations.


Bonus point:

-          Bring active development servers to perform real-time transformation during the event

-          Contribute new samples (either C-CDA or FHIR) to be used in transformations


No test scripts will be used 

Security and Privacy Considerations:

No PHI will be used during the event. C-CDA and FHIR both have privacy considerations which may be part of mapping.