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

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.0.0-preview 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.0.0-preview
Draft as of 2024-09-05 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

Generated Narrative: OperationDefinition ra.evaluate-measure

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.