Da Vinci Risk Adjustment Implementation Guide
2.0.0-ballot - STU2 Ballot United States of America flag

This page is part of the Da Vinci Risk Adjustment FHIR Implementation Guide (v2.0.0-ballot: STU2 (v2.0.0) Ballot 1) based on FHIR R4. The current version which supercedes this version is 1.0.0. For a full list of available versions, see the Directory of published versions

OperationDefinition: Evaluate Measure

Official URL: http://hl7.org/fhir/us/davinci-ra/OperationDefinition/ra.evaluate-measure Version: 2.0.0-ballot
Draft as of 2023-03-28 Computable Name: RAEvaluateMeasure

Copyright/Legal: Used by permission of HL7 International - Clinical Quality Information Work Group, 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

UseNameScopeCardinalityTypeBindingDocumentation
INperiodStart1..1date

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.

INperiodEnd1..1date

The end of a clinical evaluation period.

INsubject1..1string
(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.

INmeasureId0..*id

The id of a Measure resource for risk adjustment model, e.g., CMS HCC v24

INmeasureIdentifier0..*string
(token)

The business identifier of a Measure resource for risk adjustment model, e.g., CMS HCC v24.

INmeasureUrl0..*canonical

This the URL of a Measure resource for risk adjustment model, e.g., CMS HCC v24

OUTreturn0..1Bundle

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.parameterelements, with each Parameters.parameter for a unique patient.