# DEQM Data Exchange MeasureReport Profile - Data Exchange For Quality Measures Implementation Guide v1.0.0-ballot

## Resource Profile: DEQM Data Exchange MeasureReport Profile 

 
[MeasureReport](http://hl7.org/fhir/R4/measurereport.html) is used as an organizer for both data exchange for measure and for measure reporting. Three profiles on the MeasureReport resource are defined in this guide to delineate these different uses. When a data producer needs to send data to a data consumer, they use the **DEQM Data-Exchange MeasureReport Profile** defined here. The `type` element in this profile is set to "data-collection". Along with the MeasureReport profile, the data producer sends the reporter, subject, and any relevant resources for the measure they have produced data on. When a data producer sends a MeasureReport and the associated data, they may not have all the data that is required to calculate the measure report. Additional data may need to be collected later or there may be additional data used in the measure that the aggregator owns such as a continuous coverage period requirement. 

### Mandatory Data Elements and Terminology

The following data-elements are mandatory (i.e data MUST be present).

**Each MeasureReport Must Have:**

1. period.start: Starting time with inclusive boundary
1. subject: What individual(s) the report is for
1. status: complete | pending | error
1. type: individual | subject-list | summary | data-collection
1. reporter: The organization where the measure was completed
1. period.end: End time with inclusive boundary, if not ongoing
1. updatetype: Optional Extensions Element
1. date: When the report was generated
1. period: What period the report covers
1. measure: What measure and version was calculated

**Each MeasureReport Must Support:**

1. evaluatedResource: What data was used to calculate the measure score
1. measurereport-category: What category is this measure report
1. description: Description of the population

**Additional Profile specific implementation guidance:**

* *For a detailed discussion of incremental and snapshot updates see these sections on [Submit Data](datax.md#submit-updates) and [Collect Data](datax.md#collect-updates)
* The Producer may not have all the data that is required to calculate the measure report at that time it is transmitted. It that case the MeasureReport may not have **any** evaluatedResources (in other words, no measure data). The missing data may be transmitted in a subsequent update or the additional data used in the measure is owned by an aggregator (such as a continuous coverage period requirement).
* The `reporter` should be consistent with the [X-Provenance header data](http://hl7.org/fhir/R4/provenance.html#header) if present.

A data producer

### Examples

* [Measurereport Datax Measurereport01](MeasureReport-datax-measurereport01.md)
* [Measurereport Datax Measurereport02](MeasureReport-datax-measurereport02.md)
* [Measurereport Datax Measurereport03](MeasureReport-datax-measurereport03.md)

**Usages:**

* Examples for this Profile: [MeasureReport/datax-measurereport01](MeasureReport-datax-measurereport01.md), [MeasureReport/datax-measurereport02](MeasureReport-datax-measurereport02.md) and [MeasureReport/datax-measurereport03](MeasureReport-datax-measurereport03.md)
* CapabilityStatements using this Profile: [Consumer Client CapabilityStatement](CapabilityStatement-consumer-client.md) and [Producer Client CapabilityStatement](CapabilityStatement-producer-client.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.uv.deqm|current/StructureDefinition/deqm-dataexchangemeasurereport)

### Formal Views of Profile Content

 [Description Differentials, Snapshots, and other representations](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](../StructureDefinition-deqm-dataexchangemeasurereport.csv), [Excel](../StructureDefinition-deqm-dataexchangemeasurereport.xlsx), [Schematron](../StructureDefinition-deqm-dataexchangemeasurereport.sch) 

### Notes:

This profile is used in the following transactions:

[Data Exchange](datax.md)



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "deqm-dataexchangemeasurereport",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "cqi"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 4,
    "_valueInteger" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/uv/deqm/ImplementationGuide/hl7.fhir.uv.deqm"
      }]
    }
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use",
    "_valueCode" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/uv/deqm/ImplementationGuide/hl7.fhir.uv.deqm"
      }]
    }
  }],
  "url" : "http://hl7.org/fhir/uv/deqm/StructureDefinition/deqm-dataexchangemeasurereport",
  "version" : "1.0.0-ballot",
  "name" : "DEQMDataExchangeMeasureReportProfile",
  "title" : "DEQM Data Exchange MeasureReport Profile",
  "status" : "active",
  "experimental" : false,
  "date" : "2018-06-19T00:00:00-07:00",
  "publisher" : "HL7 International / Clinical Quality Information",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/cqi"
    }]
  }],
  "description" : "[MeasureReport](http://hl7.org/fhir/R4/measurereport.html) is used as an organizer for both data exchange for measure and for measure reporting.  Three profiles on the MeasureReport resource are defined in this guide to delineate these different uses.\nWhen a data producer needs to send data to a data consumer, they use the **DEQM Data-Exchange MeasureReport Profile** defined here.  The `type` element in this profile is set to \"data-collection\".  Along with the MeasureReport profile, the data producer sends the reporter, subject, and any relevant resources for the measure they have produced data on.  When a data producer sends a MeasureReport and the associated data, they may not have all the data that is required to calculate the measure report.  Additional data may need to be collected later or there may be additional data used in the measure that the aggregator owns such as a continuous coverage period requirement.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "MeasureReport",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/MeasureReport",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "MeasureReport",
      "path" : "MeasureReport",
      "mustSupport" : false
    },
    {
      "id" : "MeasureReport.extension:updatetype",
      "path" : "MeasureReport.extension",
      "sliceName" : "updatetype",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/uv/deqm/StructureDefinition/deqm-submitDataUpdateType"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.extension:measurereport-category",
      "path" : "MeasureReport.extension",
      "sliceName" : "measurereport-category",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/measurereport-category"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.extension:software",
      "path" : "MeasureReport.extension",
      "sliceName" : "software",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-softwaresystem"]
      }]
    },
    {
      "id" : "MeasureReport.extension:vendor",
      "path" : "MeasureReport.extension",
      "sliceName" : "vendor",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/uv/deqm/StructureDefinition/deqm-reportingVendor"]
      }]
    },
    {
      "id" : "MeasureReport.extension:location",
      "path" : "MeasureReport.extension",
      "sliceName" : "location",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/uv/deqm/StructureDefinition/deqm-dataLocation"]
      }]
    },
    {
      "id" : "MeasureReport.extension:message",
      "path" : "MeasureReport.extension",
      "sliceName" : "message",
      "short" : "Messages encountered while creating the report",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/cqf-messages"]
      }]
    },
    {
      "id" : "MeasureReport.extension:inputParameters",
      "path" : "MeasureReport.extension",
      "sliceName" : "inputParameters",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/cqf-inputParameters"]
      }]
    },
    {
      "id" : "MeasureReport.status",
      "path" : "MeasureReport.status",
      "mustSupport" : true,
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://hl7.org/fhir/ValueSet/measure-report-status"
      }
    },
    {
      "id" : "MeasureReport.type",
      "path" : "MeasureReport.type",
      "type" : [{
        "code" : "code"
      }],
      "fixedCode" : "data-collection",
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.measure",
      "path" : "MeasureReport.measure",
      "short" : "What measure and version was calculated",
      "definition" : "A reference to the Measure that was calculated to produce this report. When known, the version of the measure SHALL be included.",
      "requirements" : "This will indicate the measure being reported on. For example,  the cannonical uri location for the MRP measure.",
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.subject",
      "path" : "MeasureReport.subject",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/StructureDefinition/Patient",
        "http://hl7.org/fhir/StructureDefinition/Practitioner",
        "http://hl7.org/fhir/StructureDefinition/PractitionerRole",
        "http://hl7.org/fhir/StructureDefinition/Location",
        "http://hl7.org/fhir/StructureDefinition/Device",
        "http://hl7.org/fhir/StructureDefinition/RelatedPerson",
        "http://hl7.org/fhir/StructureDefinition/Group"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.date",
      "path" : "MeasureReport.date",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.reporter",
      "path" : "MeasureReport.reporter",
      "short" : "Who is reporting the data. The reporter is the entity fulfilling the reporting requirement.",
      "definition" : "Who is reporting the data. The reporter is the entity fulfilling the reporting requirement.",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/StructureDefinition/Organization",
        "http://hl7.org/fhir/StructureDefinition/Practitioner",
        "http://hl7.org/fhir/StructureDefinition/PractitionerRole"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.period",
      "path" : "MeasureReport.period",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Period"
      }],
      "condition" : ["deqm-1"],
      "constraint" : [{
        "key" : "deqm-1",
        "severity" : "error",
        "human" : "Date precision SHALL be at least to day ( YYYY-MM-DD )",
        "expression" : "start.toString().length()>9 and end.toString().length()>9"
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.period.start",
      "path" : "MeasureReport.period.start",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.period.end",
      "path" : "MeasureReport.period.end",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.group.extension:linkId",
      "path" : "MeasureReport.group.extension",
      "sliceName" : "linkId",
      "short" : "Unique id of the group from the measure.",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/5.0/StructureDefinition/extension-MeasureReport.group.linkId"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.group.population.extension:linkId",
      "path" : "MeasureReport.group.population.extension",
      "sliceName" : "linkId",
      "short" : "Unique id for group.population from the measure.",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/5.0/StructureDefinition/extension-MeasureReport.group.population.linkId"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.group.population.extension:description",
      "path" : "MeasureReport.group.population.extension",
      "sliceName" : "description",
      "short" : "Description of the population",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/measurereport-populationDescription"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.group.population.extension:supportingEvidence",
      "path" : "MeasureReport.group.population.extension",
      "sliceName" : "supportingEvidence",
      "short" : "Specifies the result of a supporting evidence expression in the measure population.",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/cqf-supportingEvidence"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MeasureReport.group.measureScore",
      "path" : "MeasureReport.group.measureScore",
      "min" : 0,
      "max" : "0"
    },
    {
      "id" : "MeasureReport.group.stratifier",
      "path" : "MeasureReport.group.stratifier",
      "min" : 0,
      "max" : "0"
    },
    {
      "id" : "MeasureReport.evaluatedResource",
      "path" : "MeasureReport.evaluatedResource",
      "mustSupport" : true
    }]
  }
}

```
