Da Vinci Risk Adjustment Implementation Guide
2.1.0 - STU 2.1

Da Vinci Risk Adjustment Implementation Guide, published by HL7 International / Clinical Quality Information. This guide is not an authorized publication; it is the continuous build for version 2.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/davinci-ra/ and changes regularly. See the Directory of published versions

## OperationDefinition: Evaluate Measure

Official URL: http://hl7.org/fhir/us/davinci-ra/OperationDefinition/ra.evaluate-measure | Version: 2.1.0
Standards status: Draft | Maturity Level: 1 | Computable Name: RAEvaluateMeasure
Other Identifiers: OID:2.16.840.1.113883.4.642.40.29.33.1
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License

The ra.evaluate-measure operation is used to evaluate Digital Condition Category and obtain the results.

The $ra.evaluate-measure is DRAFT and open for review.

This operation executes digital condition category (dCC) measures specified in Clinical Quality Language (CQL) against the patient data to produce a Risk Adjustment Coding Gap Report Bundle. Patient data, dCC measures, and CQL libraries are pre-populated on FHIR server.

Conformance Requirement 1:

- If the operation is invoked at the instance level, the parameters `measureId`, `measureIdentifier`, and `measureUrl` is not allowed
- If the operation is invoked at the type level, one of the `measureId`, `measureIdentifier`, and `measureUrl` parameters is required

URL: [base]/Measure/$ra.evaluate-measure

URL: [base]/Measure/[id]/$ra.evaluate-measure

### Parameters

Use | Name | Scope | Cardinality | Type | Binding | Documentation
IN | periodStart |  | 1..1 | date |  | 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 available on the Server. The MeasureReport will be returned if there is an overlap of the two periods.
IN | periodEnd |  | 1..1 | date |  | The end of a clinical evaluation period.
IN | subject |  | 1..1 | string (reference) |  | Subject will be a reference to either Patient (US Core Patient) or Group (Patient Group). 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.
IN | measureId |  | 0..* | id |  | The id of a Measure resource for risk adjustment model, e.g., CMS HCC v24
IN | measureIdentifier |  | 0..* | string (token) |  | The business identifier of a Measure resource for risk adjustment model, e.g., CMS HCC v24.
IN | measureUrl |  | 0..* | canonical |  | This the URL of a Measure resource for risk adjustment model, e.g., CMS HCC v24
OUT | return |  | 0..1 | Bundle |  | The $ra.evaluate-measure operation will always return one Parameters whether the subject is a single patient or a group of patients. Risk Adjustment Coding Gap Report Bundle 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 will contain 10 `Parameters.parameter`elements, with each `Parameters.parameter` for a unique patient.