C-CDA on FHIR
2.0.0-ballot - STU 2 Ballot United States of America flag

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 2.0.0-ballot 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

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

CCDA on FHIR Client

This describes the expected capabilities of the C-CDA on FHIR Document Consumer (aka client) actor which is responsible for creating and initiating the queries for clinical documents provided by a C-CDA on FHIR Document Source (aka server) actors. This CapabilityStatement imports and extends the us-core-client CapabilityStatement

CCDA on FHIR Server

This describes the expected capabilities of the C-CDA on FHIR Document Source (aka server) actor which is responsible for responding to the queries for clinical documents provided by a C-CDA on FHIR Document Consumer (aka client) actor. This CapabilityStatement imports and extends the us-core-server CapabilityStatement

Structures: Abstract Profiles

These are profiles on resources or data types that describe patterns used by other profiles, but cannot be instantiated directly. I.e. instances can conform to profiles based on these abstract profiles, but do not declare conformance to the abstract profiles themselves.

US Realm Header

This profile defines constraints that represent common administrative and demographic concepts for US Realm clinical documents. Further specification, such as type, are provided in document profiles that conform to this profile.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

Care Plan Document

CARE PLAN FRAMEWORK: A Care Plan (including Home Health Plan of Care (HHPoC)) is a consensus-driven dynamic plan that represents a patient and Care Team Members prioritized concerns, goals, and planned interventions. It serves as a blueprint shared by all Care Team Members (including the patient, their caregivers and providers), to guide the patients care. A Care Plan integrates multiple interventions proposed by multiple providers and disciplines for multiple conditions.

A Care Plan represents one or more Plan(s) of Care and serves to reconcile and resolve conflicts between the various Plans of Care developed for a specific patient by different providers. While both a plan of care and a care plan include the patient's life goals and require Care Team Members (including patients) to prioritize goals and interventions, the reconciliation process becomes more complex as the number of plans of care increases. The Care Plan also serves to enable longitudinal coordination of care.

The Care Plan represents an instance of this dynamic Care Plan at a point in time. The composition itself is NOT dynamic.

Key differentiators between a Care Plan profile and CCD profile (another snapshot in time document):

  • Requires relationships between various concepts:

     *  Health Concerns
    
     *  Interventions
    
     *  Goals
    
     *  Outcomes
    
  • Provides the ability to identify patient and provider priorities with each act

  • Provides a header participant to indicate occurrences of Care Plan review

Consultation Note

The Consultation Note is generated by a request from a clinician for an opinion or advice from another clinician. Consultations may involve face-to-face time with the patient or may fall under the auspices of telemedicine visits. Consultations may occur while the patient is inpatient or ambulatory. The Consultation Note should also be used to summarize an Emergency Room or Urgent Care encounter.

A Consultation Note includes the reason for the referral, history of present illness, physical examination, and decision-making components (Assessment and Plan).

Continuity of Care Document

This profile was originally based on the Continuity of Care Document (CCD) Release 1.1 which itself was derived from HITSP C32 and CCD Release 1.0.

The Continuity of Care Document (CCD) profile represents a core data set of the most relevant administrative, demographic, and clinical information facts about a patient's healthcare, covering one or more healthcare encounters. It provides a means for one healthcare practitioner, system, or setting to aggregate all of the pertinent data about a patient and forward it to another to support the continuity of care.

The primary use case for the CCD is to provide a snapshot in time containing the germane clinical, demographic, and administrative data for a specific patient. The key characteristic of a CCD is that the Composition.event.code is constrained to "PCPR". This means it does not function to report new services associated with performing care. It reports on care that has already been provided. The CCD provides a historical tally of the care over a range of time and is not a record of new services delivered.

More specific use cases, such as a Discharge Summary, Transfer Summary, Referral Note, Consultation Note, or Progress Note, are available as alternative profiles.

Diagnostic Imaging Report

A Diagnostic Imaging Report (DIR) is a document that contains a consulting specialist's interpretation of image data. It conveys the interpretation to the referring (ordering) physician and becomes part of the patient's medical record. It is for use in Radiology, Endoscopy, Cardiology, and other imaging specialties. Note: this document type overlaps with the FHIR DiagnosticReport resource. Most use cases will want to use the specific resource type, but this document type is still useful for CDA to FHIR conversion and other such use cases.

Discharge Summary

The Discharge Summary is a document which synopsizes a patient's admission to a hospital, LTPAC provider, or other setting. It provides information for the continuation of care following discharge. The Joint Commission requires the following information to be included in the Discharge Summary (http://www.jointcommission.org/):

The reason for hospitalization (the admission)

The procedures performed, as applicable

The care, treatment, and services provided

The patients condition and disposition at discharge

Information provided to the patient and family

Provisions for follow-up care

The best practice for a Discharge Summary is to include the discharge disposition in the display of the header.

History and Physical

A History and Physical (H&P) note is a medical report that documents the current and past conditions of the patient. It contains essential information that helps determine an individual's health status.

The first portion of the report is a current collection of organized information unique to an individual. This is typically supplied by the patient or the caregiver, concerning the current medical problem or the reason for the patient encounter. This information is followed by a description of any past or ongoing medical issues, including current medications and allergies. Information is also obtained about the patient's lifestyle, habits, and diseases among family members. The next portion of the report contains information obtained by physically examining the patient and gathering diagnostic information in the form of laboratory tests, imaging, or other diagnostic procedures.

The report ends with the clinician's assessment of the patient's situation and the intended plan to address those issues.

A History and Physical Examination is required upon hospital admission as well as before operative procedures. An initial evaluation in an ambulatory setting is often documented in the form of an H&P note.

Operative Note

The Operative Note is a frequently used type of procedure note with specific requirements set forth by regulatory agencies.

The Operative Note is created immediately following a surgical or other high-risk procedure. It records the pre- and post-surgical diagnosis, pertinent events of the procedure, as well as the condition of the patient following the procedure. The report should be sufficiently detailed to support the diagnoses, justify the treatment, document the course of the procedure, and provide continuity of care.

Procedure Note

A Procedure Note encompasses many types of non-operative procedures including interventional cardiology, gastrointestinal endoscopy, osteopathic manipulation, and many other specialty fields. Procedure Notes are differentiated from Operative Notes because they do not involve incision or excision as the primary act.

The Procedure Note is created immediately following a non-operative procedure. It records the indications for the procedure and, when applicable, postprocedure diagnosis, pertinent events of the procedure, and the patients tolerance for the procedure. It should be detailed enough to justify the procedure, describe the course of the procedure, and provide continuity of care.

Progress Note

This profile represents a patient's clinical status during a hospitalization, outpatient visit, treatment with a LTPAC provider, or other healthcare encounter.

Taber's medical dictionary defines a Progress Note as An ongoing record of a patient's illness and treatment. Physicians, nurses, consultants, and therapists record their notes concerning the progress or lack of progress made by the patient between the time of the previous note and the most recent note.

Mosby's medical dictionary defines a Progress Note as Notes made by a nurse, physician, social worker, physical therapist, and other health care professionals that describe the patient's condition and the treatment given or planned.

A Progress Note is not a re-evaluation note. A Progress Note is not intended to be a Progress Report for Medicare. Medicare B Section 1833(e) defines the requirements of a Medicare Progress Report.

Referral Note

A Referral Note communicates pertinent information from a provider who is requesting services of another provider of clinical or non-clinical services. The information in this document includes the reason for the referral and additional information that would augment decision making and care delivery.

Examples of referral situations are:

  • When a patient is referred from a family physician to a cardiologist for cardiac evaluation.
  • When patient is sent by a cardiologist to an emergency department for angina.
  • When a patient is referred by a nurse practitioner to an audiologist for hearing screening.
  • When a patient is referred by a hospitalist to social services.
Transfer Summary

This profile describes constraints for a Transfer Summary. The Transfer Summary standardizes critical information for exchange of information between providers of care when a patient moves between health care settings. Standardization of information used in this form will promote interoperability; create information suitable for reuse in quality measurement, public health, research, and for reimbursement.

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

Authorization Extension

The C-CDA on FHIR Authorization Extension contains the C-CDA on FHIR Consent profile which represents information about a patient's consents.

Data Enterer Extension

The Data Enterer Extension represents the person who transferred the content, written or dictated, into the clinical document. To clarify, an author provides the content, subject to their own interpretation; a dataEnterer adds an author's information to the electronic system.

For further information see the C-CDA specification here: http://www.hl7.org/implement/standards/product_brief.cfm?product_id=408.

Informant Extension

The C-CDA on FHIR Informant Extension describes an information source for any content within the clinical document. This informant is constrained for use when the source of information is an assigned health care provider for the patient.

Information Recipient Extension

The Information Recipient Extension records the intended recipient of the information at the time the document was created.

For further information see the C-CDA specification here: http://www.hl7.org/implement/standards/product_brief.cfm?product_id=408.

Order Extension

The Order Extension represents orders that are fulfilled by this document such as a radiologists report of an x-ray.

Participant Extension

The C-CDA on FHIR Participant Extension identifies supporting entities, including parents, relatives, caregivers, insurance policyholders, guarantors, and others related in some way to the patient. A supporting person or organization is an individual or an organization with a relationship to the patient. A supporting person who is playing multiple roles would be recorded in multiple participants (e.g., emergency contact and next-of-kin).

Performer Extension

The Performer Extension represents clinicians who actually and principally carry out the clinical services being documented. In a transfer of care this represents the healthcare providers involved in the current or pertinent historical care of the patient. Preferably, the patients key healthcare care team members would be listed, particularly their primary physician and any active consulting physicians, therapists, and counselors.

Version Number

The CCDA on FHIR VersionNumber Extension represents a numeric value used to version successive replacement documents.

For further information see the C-CDA specification here: http://www.hl7.org/implement/standards/product_brief.cfm?product_id=408.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Care Plan Document Type

Care Plan Document Type

ConsultDocumentType

ConsultDocumentType

DischargeSummaryDocumentTypeCode

DischargeSummaryDocumentTypeCode

HPDocumentType

HPDocumentType

LOINC Imaging Document Codes

LOINC Imaging Document Codes

ProcedureNoteDocumentTypeCodes

ProcedureNoteDocumentTypeCodes

ProgressNoteDocumentTypeCode

ProgressNoteDocumentTypeCode

ReferralDocumentType

ReferralDocumentType

SurgicalOperationNoteDocumentTypeCode

SurgicalOperationNoteDocumentTypeCode

TransferDocumentType

TransferDocumentType

Terminology: Concept Maps

These define transformations to convert between codes by systems conforming with this implementation guide.

C-CDA Immunization Refusal to FHIR Immunization Status Reason

C-CDA Immunization Refusal to FHIR Immunization Status Reason

C-CDA NullFlavor to FHIR Data Absent Reason

C-CDA NullFlavor to FHIR Data Absent Reason. Adapted from https://hl7.org/fhir/R4/cm-data-absent-reason-v3.html but several key changes have been made. Note that this prior concept map (from R4) is no longer included in current FHIR build.

C-CDA Problem Status value to FHIR Condition clinicalStatus

C-CDA Problem Status value to FHIR Condition clinicalStatus

C-CDA Severity to FHIR Severity

C-CDA Severity to FHIR Severity

C-CDA section to FHIR Condition category code

C-CDA section code to FHIR Condition category

C-CDA to FHIR Address Use

C-CDA to FHIR Address Use

C-CDA to FHIR Adminmistrative Gender

C-CDA to FHIR Adminmistrative Gender

C-CDA to FHIR Allergy Status

C-CDA to FHIR Allergy Status

C-CDA to FHIR Encounter Status

C-CDA to FHIR Encounter Status

C-CDA to FHIR Immunization Status

C-CDA to FHIR Immunization Status

C-CDA to FHIR Medication Status

C-CDA to FHIR Medication Status. Based on http://cdasearch.hl7.org/examples/view/Medications/Medication%20statusCodes

C-CDA to FHIR NameUse

C-CDA to FHIR NameUse

C-CDA to FHIR No Known Allergies

C-CDA Allergy Intolerance Observation value to FHIR code for No Known Allergies

C-CDA to FHIR Procedure Status

C-CDA to FHIR Procedure Status

C-CDA to FHIR Telecom Type

C-CDA to FHIR Telecom Type. In CDA, these are prefixes inside the value attribute.

C-CDA to FHIR Telecom Use

C-CDA to FHIR Telecom Use

CCDA Criticality to FHIR Criticality

C-CDA Criticality to FHIR Criticality

CCDA Medication Activity Mood to FHIR MedicationRequest.intent

CCDA Medication Activity Mood to FHIR MedicationRequest.intent

CCDA Problem Concern Status to FHIR Condition Clinical Status

CCDA Problem Concern Status to FHIR Condition Clinical Status

CCDA ResultStatus to FHIR DiagnosticReport status

C-CDA Result Status to FHIR DiagnosticReport status

CCDA ResultStatus to FHIR Observation Status

C-CDA Result Status to FHIR Observation Status

CCDA to FHIR Allergy Intolerance Category

C-CDA Allergy Intolerance Observation value elements to FHIR category codes

CCDA to FHIR Allergy Intolerance Type

C-CDA Allergy Intolerance Observation value elements to FHIR type codes

FHIR Allergy Intolerance Type to CCDA value

FHIR type codes to C-CDA Allergy Intolerance Observation value

FHIR Condition category to C-CDA section code

FHIR Condition category to C-CDA section code

FHIR Condition clinicalStatus to C-CDA Problem Status value

FHIR Condition clinicalStatus to C-CDA Problem Status value

FHIR Criticality to C-CDA Criticality

FHIR Criticality to C-CDA Criticality

FHIR Data Absent Reason to C-CDA NullFlavor

FHIR Data Absent Reason to C-CDA NullFlavor. Adapted from https://hl7.org/fhir/R4/cm-data-absent-reason-v3.html but several key changes have been made. Note that this prior concept map (from R4) is no longer included in current FHIR build.

FHIR Immunization Site to C-CDA Immunization approachSiteCode

FHIR Immunization Site to C-CDA Immunization approachSiteCode. Note that the FHIR valueset is example and may be incomplete (only 2 codes)

FHIR Immunization Status Reason to C-CDA Immunization Refusal

FHIR Immunization Status Reason to C-CDA Immunization Refusal

FHIR ObservationStatus to C-CDA ObservationStatus

FHIR ObservationStatus to C-CDA ObservationStatus

FHIR Severity to C-CDA Severity

FHIR Severity to C-CDA Severity

FHIR to C-CDA Address Use

FHIR to C-CDA Address Use. Based on http://hl7.org/fhir/cm-address-use-v3.html

FHIR to C-CDA Adminmistrative Gender

FHIR to C-CDA Adminmistrative Gender. Based on http://hl7.org/fhir/cm-administrative-gender-v3.html

FHIR to C-CDA Allergy Status

FHIR to C-CDA Allergy Status

FHIR to C-CDA Immunization Status

FHIR to C-CDA Immunization Status

FHIR to C-CDA Medication Status

FHIR to C-CDA Medication Status. Based on http://cdasearch.hl7.org/examples/view/Medications/Medication%20statusCodes

FHIR to C-CDA NameUse

FHIR to C-CDA NameUse. Based on http://hl7.org/fhir/cm-name-use-v3.html

FHIR to C-CDA No Known Allergies

FHIR negated code for No Known Allergies to C-CDA Allergy Intolerance Observation value.

Note that when placing the target code in the C-CDA AllergyIntolerance Observation, the Observation must have @negationInd=true.

FHIR to C-CDA Procedure Status

FHIR to C-CDA Procedure Status

FHIR to C-CDA Telecom Type

FHIR to C-CDA Telecom Type. In CDA, these are prefixes inside the value attribute.

FHIR to C-CDA Telecom Use

FHIR to C-CDA Telecom Use. Note that CDA's PG use code is equivalent to FHIR's ContactPoint.system of 'pager'.

FHIR to CCDA Allergy Intolerance Category

FHIR AllergyIntolerance category code to C-CDA Allergy Intolerance Observation value

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Acme Clinic

Acme Clinic

Acme Lab

Acme Lab

Acme Labs

Acme Labs

CF-allergy-example

ccda-to-fhir-allergy

CF-immunization-example

ccda-to-fhir-immunization

CF-medication-example

ccda-to-fhir-medication

CF-patient-example

ccda-to-fhir-patient

CF-problem-example

ccda-to-fhir-problem

CF-procedure-example

ccda-to-fhir-procedure

Care Plan

Care Plan

Colonoscopy

Colonoscopy

Complete Document Bundle Example

Complete Document Bundle Example

Consent Example Basic

Basic consent

Consultation Note - Composition

Consultation Note

Continuity of Care Document - Composition

Continuity of Care Document

Diagnostic Imaging Report - Composition

Diagnostic Imaging Report

Discharge Summary - Composition

Discharge Summary

FC-allergy-example

fhir-to-ccda-allergy

FC-immunization-example

fhir-to-ccda-immunization

FC-medication-example

fhir-to-ccda-medication

FC-problem-example

fhir-to-ccda-problem

History and Physical Note - Composition

History and Physical Note

Operative Note - Composition

Operative Note

Patient Amy V. Shaw

Patient Amy V. Shaw

Practitioner Brenda Jennings Richard

Practitioner Brenda Jennings Richard

Procedure Note - Composition

Procedure Note

Progress Note - Composition

Progress Note

Referral Note - Composition

Referral Note

Ronald Boone, MD

Ronald Boone, MD

Transfer Summary - Composition

Transfer Summary

allergy-intolerance

allergy-intolerance

ccda-practitionerrole-example

ccda-practitionerrole-example

condition-problem

condition-problem

encounter-1

encounter-1

example-1

example-1

immunization

immunization

medication-statement

medication-statement

observation-lab-urine

observation-lab-urine

observation-smoker

observation-smoker

observation-vitals-temp

observation-vitals-temp

procedure-rehab

procedure-rehab

rehab

rehab

Other

These are resources that are used within this implementation guide that do not fit into one of the other categories.

CF-allergy

ccda-to-fhir-allergy

CF-immunization

ccda-to-fhir-immunization

CF-medication

ccda-to-fhir-medication

CF-patient

ccda-to-fhir-patient

CF-problem

ccda-to-fhir-problem

CF-procedure

ccda-to-fhir-procedure

FC-allergy

fhir-to-ccda-allergy

FC-immunization

fhir-to-ccda-immunization

FC-medication

fhir-to-ccda-medication

FC-problem

fhir-to-ccda-problem