This page is part of the Making EHR Data MOre available for Research and Public Health (MedMorph) Central Cancer Registry Reporting Content IG (v1.0.0: STU1) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions

Detailed Specification

This section defines the specific requirements for systems wishing to conform to actors specified in this MedMorph Central Cancer Registry Reporting Content IG. The specification focuses on using the Health Data Exchange App (HDEA), MedMorph’s backend services app, to report cancer data to central cancer registries.

Context

Pre-reading

Before reading this formal specification, implementers should first be familiar with these sections of the specification:

• The Use Cases page provides the business context and general process flow enabled by the formal specification.

Conventions

This implementation guide uses specific terminology to flag statements that have relevance for the evaluation of conformance with the guide:

• SHALL indicates requirements that must be met to be conformant with the specification.

• SHOULD indicates behaviors that are strongly recommended (and which may result in interoperability issues or sub-optimal behavior if not adhered to), but which do not, for this version of the specification, affect the determination of specification conformance.

• MAY describes optional behaviors that are free to consider but where there is no recommendation for or against adoption.

Claiming Conformance

Actors and Systems asserting conformance to this implementation guide have to implement the requirements outlined in the corresponding capability statements. The following definition of MUST SUPPORT is to be used in the implementation of the requirements.

MUST SUPPORT Definition

• Systems SHALL be capable of populating data elements as specified by the profiles and data elements are returned using the specified APIs in the capability statement.
• Systems SHALL be capable of processing resource instances containing the MUST SUPPORT data elements without generating an error or causing the application to fail. In other words, Systems SHOULD be capable of displaying the data elements for human use or storing it for other purposes.
• In situations where information on a particular data element is not present and the reason for absence is unknown, Systems SHALL NOT include the data elements in the resource instance returned from executing the API requests.
• When accessing Central Cancer Registry Reporting data, Systems SHALL interpret missing data elements within resource instances returned from API requests as data not present.
• When data is not available for any of the mandatory elements specified in the IG, a data absent reason extension should be added to satisfy the requirement along with an appropriate value from the data-absent-reason value set.

Profiles and Other IGs Usage

This specification makes significant use of FHIR profiles, search parameter definitions, and terminology artifacts to describe the content to be shared as part of MedMorph Central Cancer Registry Reporting Content IG workflows. The implementation guide is based on FHIR R4 and profiles are listed for each interaction.

The full set of profiles defined in this implementation guide can be found by following the links on the FHIR Artifacts page.

MedMorph Reference Architecture (RA) IG Usage

This IG leverages the MedMorph RA IG defined by HL7 Public Health WG as the reference architecture for automating and implementing the central cancer registry reporting use case.

US Core Usage

This IG leverages the US Core set of profiles defined by HL7 for sharing non-veterinary EMR individual health data in the U.S. Where US Core profiles exist, this IG either leverages them directly or uses them as a base for any additional constraints needed to support the research use cases. If no constraints are needed, this IG does not define any profiles.

US Public Health (PH) library profiles Usage

This IG leverages the US PH Library Profiles as a reference to define the following profile(s) in this IG:

* USPublicHealthEncounter
* USPublicHealthPatient

mCode FHIR IG Usage

This IG leverages the mCode FHIR IG for exchanging cancer specific information which includes the following profiles:

• mCODE Primary Cancer Condition Profile
• mCODE Secondary Cancer Condition Profile
• mCODE Cancer Stage Group Profile
• mCODE TNM Distant Metastases Category Profile
• mCODE TNM Primary Tumor Category Profile
• mCODE TNM Regional Nodes Category Profile
• mCODE Cancer-Related Medication Request Profile
• mCODE Cancer-Related Administration Request Profile
• mCODE Radiotherapy Course Summary Profile

Implementers SHOULD use the mCode Disease characterization guidance and mCode Treatment guidance when using the above profiles.

Cancer Pathology IG Usage in the future

The Cancer Pathology Data Sharing IG is currently under development. Once published, profiles of the following resources from the Cancer Pathology Data Sharing IG will be referenced in this IG.

• DiagnosticReport
• Specimen
• RelatedPerson: Next-of-Kin
• PractitionerRole

Inclusion of the above profiles will allow the extraction of Cancer Pathology Reports from the EHR and include them in the Central Cancer Registry Content Bundle in the future.

Occupational Data for Health (ODH) IG Usage

This IG leverages the ODH FHIR IG for exchanging occupational data for health which includes the following profile

* [Occupation Data for Health Usual Work Profile](/StructureDefinition-odh-UsualWork.html)

Subscriptions Backport IG Usage

This IG leverages the Subscriptions Backport IG defined by HL7 Infrastructure WG for automating reporting workflows using subscriptions.

SMART App Launch IG Usage

This IG leverages the SMART App Launch IG defined by HL7 Infrastructure WG for enabling authentication and authorization between various actors involved in the workflows.

Implementation Requirements

Overall Security Requirements

Implementations must meet the general security requirements documented in FHIR Security guidance. In addition the EHR needs to meet the security requirements as outlined in the Authentication and Authorization Requirements section below. Implementers of this IG SHOULD follow the HIPPA guidance to ensure applicable security and privacy laws are implemented.

Authentication and Authorization Requirements

This section outlines how the SMART on FHIR Backend Services Authorization will be used by the Central Cancer Registry (CCR) Reporting Content implementation guide.

• The system actors namely EHR, Health Data Exchange App (backend services app), Trusted Third Party and the Central Cancer Registry are required to conform to the MedMorph Authentication and Authorization Requirements for the following interactions:

  • HDEA accessing data from the EHR.
  • HDEA posting data to the Central Cancer Registry data store via the TTP or directly to the Central Cancer Registry.

• For the Central Cancer Registry Reporting use cases, EHRs SHALL support the system/*.read scopes.

• The Central Cancer Registry SHALL support the system/.read and system/.write scopes.

• The healthcare organization’s existing processes along with the EHRs authorization server SHALL verify consent and other policy requirements before allowing the HDEA to access the data to be included in the central cancer registry report.

Knowledge Artifact and Knowledge Artifact Repository Requirements

• The Central Cancer Registry SHALL create a Knowledge Artifact following the constraints identified by the MedMorph Provisioning Requirements.

• The Central Cancer Registry SHALL publish the value sets required to trigger a cancer report for a patient with an encounter diagnosis of cancer. This can be published in the Central Cancer Registry FHIR Server or a separate Knowledge Artifact Repository.

• The Central Cancer Registry SHALL republish the value sets when the list of concepts comprising the value sets change.

• The Central Cancer Registry SHALL create the Knowledge Artifact following the constraints identified in ccrr-plandefinition.

• The Central Cancer Registry SHALL implement the Knowledge Artifact Repository requirements as outlined in the MedMorph RA Knowledge Artifact Repository Requirements.

EHR Requirements

• The EHR SHALL support the requirements as outlined in the EHR Capability Statement.

Security requirements

• EHRs SHALL support the Authentication and Authorization Requirements outlined above as a Server.

Subscription requirements

• EHRs SHALL support notifications based on the encounter-end Subscription Topic.

• EHRs SHALL support rest-hook Subscription channel to notify the HDEA.

• • EHRs MAY support the creation, deletion, updation of Subscriptions for the encounter-end Subscription Topic.

• EHRs SHOULD support Notification Bundles with either full resource payload or '’id-only payload’’ as outlined in the Backport Subscriptions IG.

• EHRs MAY support operations and APIs for Subscription, Notification Bundle, and Subscription Status resources as outlined in the EHR Capability Statement.

Data API requirements

• EHRs SHALL support the APIs as outlined in the EHR Capability Statement for the HDEA to access patient data.

HDEA Requirements

Security requirements

• The HDEA SHALL support the Authentication and Authorization Requirements outlined above as a client.

Subscription requirements

• The HDEA SHALL create Subscriptions for the encounter-end Subscription Topic.

• The HDEA SHALL support rest-hook Subscription channel to receive notifications from the EHR.

Subscription Notification API

• The HDEA SHALL support a POST API /receive-notification with a payload of the Subscription Notification Bundle to receive the notifications from the EHR.

Knowledge Artifact processing requirements

• The HDEA SHALL allow the healthcare organization to activate/deactivate a specific Knowledge Artifact. Activation indicates applying the Knowledge Artifact and deactivation indicates not applying the Knowledge Artifact for events occurring within the healthcare organization.

• The HDEA SHALL process the MedMorph Central Cancer Registry Reporting Knowledge Artifact and create Subscription resources in the EHR for each trigger event.

• For the Central Cancer Registry Reporting IG, the HDEA SHALL create the Subscription for the encounter-close Subscription Topic trigger event.

• Upon deactivation of a Knowledge Artifact, The HDEA SHALL delete the Subscriptions previously created by the BSA for the Knowledge Artifact (e.g., delete the Subscription created for encounter-end trigger event).

• The HDEA SHALL implement FhirPath expression processing to process the Central Cancer Registry Reporting Knowledge Artifact actions.

• The HDEA SHALL use the default queries outlined by the Central Cancer Registry Reporting Knowledge Artifact unless overridden by the healthcare organization.

• The HDEA SHALL ensure no duplicate reports are submitted for the same patient and encounter occurring within a healthcare organization.

Data API requirements

• The HDEA acting as a client SHALL use the APIs as outlined in the EHR Capability Statement to access patient data from the EHR.

Report generation requirements

• The HDEA SHALL create a central cancer registry report following the constraints identified in Central Cancer Registry Content Bundle.

• The HDEA SHALL package the central cancer registry report following the constraints identified in Central Cancer Registry Reporting Bundle.

• The HDEA SHALL submit the message containing the central cancer registry report to the endpoint identified in the MedMorph Central Cancer Registry Reporting Knowledge Artifact unless overridden by the healthcare organization.

MedMorph RA Requirements

• The HDEA SHALL implement the MedMorph HDEA requirements as outlined in the MedMorph HDEA requirements.

Central Cancer Registry Requirements

Message Receiving and Processing requirements

• The Central Cancer Registry Data Store SHALL implement the $process-message operation on the ROOT URL of the FHIR Server to receive reports from the HDEA using the POST operation.

• Upon receipt of the message, the Central Cancer Registry Data Store SHALL validate the message before accepting the message.

• When there are validation failures, the Central Cancer Registry Data Store SHALL return an Operation Outcome response with the details of the validations as part of the POST response.

• The Central Cancer Registry SHALL implement the PHA requirements as outlined in the MedMorph Data Receiver requirements.

Trusted Third Party Requirements

Message Receiving and Processing requirements

• Trusted Third Parties SHALL implement the $process-message operation on the ROOT URL of the FHIR Server to receive reports from the HDEA using the POST operation.

• Upon receipt of the message, the Trusted Third Parties MAY validate the message before accepting the message.

• When the message is validated and there are validation failures, Trusted Third Parties SHALL return an Operation Outcome response with the details of the validations as part of the POST response.

• Once a message is accepted by a Trusted Third Party without errors, the Trusted Third Party will have to route the message to the Central Cancer Registry.

• The TTP SHALL implement the Trusted Third Party requirements as outlined in the MedMorph RA TTP requirements.