{
  "description": "Generate a measure report",
  "_filename": "OperationDefinition-report.json",
  "package_name": "hl7.fhir.us.davinci-ra",
  "date": "2022-06-16T14:23:36+00:00",
  "system": false,
  "publisher": "HL7 Clinical Quality Information Work Group",
  "instance": false,
  "jurisdiction": [ {
    "coding": [ {
      "code": "US",
      "system": "urn:iso:std:iso:3166",
      "display": "United States of America"
    } ]
  } ],
  "name": "Report",
  "type": "true",
  "experimental": null,
  "resourceType": "OperationDefinition",
  "title": "Report Operation",
  "package_version": "1.0.0",
  "status": "active",
  "id": "b69c76d3-3e72-437d-9003-752138b2b5dd",
  "resource": [ "MeasureReport" ],
  "kind": "operation",
  "url": "http://hl7.org/fhir/us/davinci-ra/OperationDefinition/report",
  "code": "report",
  "version": "1.0.0",
  "contact": [ {
    "name": "HL7 Clinical Quality Information Work Group",
    "telecom": [ {
      "value": "http://www.hl7.org/Special/committees/cqi",
      "system": "url"
    } ]
  } ],
  "parameter": [ {
    "max": "1",
    "min": 1,
    "use": "in",
    "name": "periodStart",
    "type": "date",
    "documentation": "The start of a clinical evaluation period. The periodStart and periodEnd parameters will be compared with the clinical evaluation period (`MeasureReport.period.start` and `MeasureReport.period.end`)           of a [Risk Adjustment Coding Gap MeasureReport](StructureDefinition-ra-measurereport.html) available on the Server. The MeasureReport will be returned if there is an overlap of the two periods."
  }, {
    "max": "1",
    "min": 1,
    "use": "in",
    "name": "periodEnd",
    "type": "date",
    "documentation": "The end of a clinical evaluation period."
  }, {
    "max": "1",
    "min": 1,
    "use": "in",
    "name": "subject",
    "type": "string",
    "searchType": "reference",
    "documentation": "Subject will be a reference to either Patient ([US Core Patient](http://hl7.org/fhir/us/core/STU3.1.1/StructureDefinition-us-core-patient.html)) or Group ([Patient Group](StructureDefinition-ra-patient-group.html)). Must provide either Patient/123 or Group/123, cannot simply provide 123. If only 123 is provided, then the operation would not know if it is a Patient reference or a Group reference."
  }, {
    "max": "*",
    "min": 0,
    "use": "out",
    "name": "return",
    "type": "Bundle",
    "documentation": "The $report operation will always return one [Parameters](https://www.hl7.org/fhir/parameters.html) whether the subject is a single patient or a group of patients. [Risk Adjustment Coding Gap Report Bundle](StructureDefinition-ra-measurereport-bundle.html) for a patient is in a `Parameters.parameter` element. A Risk Adjustment Coding Gap Report Bundle contains the Risk Adjustment Coding Gap Reports for the same patient. For example, if a Group has 10 valid patients, then a [Parameters](https://www.hl7.org/fhir/parameters.html) will contain 10 `Parameters.parameter`elements, with each `Parameters.parameter` for a unique patient."
  }, {
    "max": "*",
    "min": 0,
    "use": "out",
    "name": "outcome",
    "type": "OperationOutcome",
    "documentation": "If subject is a patient and the patient is not found on the Server, or if subject is a Group and the group is not found on the Server, then the $report returns a `Parameters.parameter` with an [OperationOutcome](https://www.hl7.org/fhir/operationOutcome.html).           If subject is a Group, the group is valid but one or more patients within the Group can not be found on the Server, then the $report returns a separate `Parameters.parameter` with an OperationOutcome for each of the invalid patients.           For example, if a Group has 10 patients and two of the patients cannot be found on the Server, then the $report returns a Parameters resource containing 10 `parameter` elements (two `parameter` elements containing OperationOutcome for the two invalid patients and eight `parameter` elements containing [Risk Adjustment Coding Gap Report Bundle](StructureDefinition-ra-measurereport-bundle.html) for the eight valid patients)."
  } ]
}