Da Vinci Risk Adjustment Implementation Guide
2.1.0 - STU 2.1
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
| Official URL: http://hl7.org/fhir/us/davinci-ra/OperationDefinition/risk-gap | Version: 2.1.0 | |||
| Standards status: Draft | Maturity Level: 1 | Computable Name: RiskGap | ||
| Other Identifiers: OID:2.16.840.1.113883.4.642.40.29.33.2 | ||||
Copyright/Legal: Used by permission of HL7 International, all rights reserved Creative Commons License |
||||
The risk-gap operation is used to determine condition Category (CC) gaps for a patient/member.
The contextId header is an optional, non-standard HTTP header used to transmit an internal or system-specific identifier associated with the current request context. For example, a contextId maybe a 'gap-request-id' that is used by some systems to track an appointment that later is morphed into an encounter, and this "gap-request-id" can then be used by the server system to produce a Risk Adjustment Coding Gap Report.
Include the contextId header in FHIR API POST operations. Implementers are expected to document the meaning of contextId used in their implementation and expected format if any constraints apply.
contextId: <string>
<string>: A system-specific identifier, such as an internal request id, gap-request-id, or similar identifier used for internal tracking.
POST [base]/MeasureReport/$risk-gap
Host: example.org
Content-Type: application/fhir+json
contextId: gap-request-id-123
Servers receiving the contextId should log, propagate, or process the header according to their internal policies.
URL: [base]/MeasureReport/$risk-gap
URL: [base]/MeasureReport/[id]/$risk-gap
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | periodStart | 1..1 | date | The start of a clinical evaluation period. | ||
| IN | periodEnd | 1..1 | date | The end of a clinical evaluation period. | ||
| IN | subject | 1..1 | Patient (US Core Patient Profile) | Patient resource as input parameter, which provides data such as patient's first name, last name, date of birth | ||
| IN | coverage | 1..1 | Coverage (US Core Coverage Profile) | This is a reference to the Coverage resource, which provides information such as the subscriberId | ||
| IN | TIN | 0..1 | string (token) | This is the provider rganization's TIN | ||
| IN | ccType | 0..* | code | Condition Category Type (Extensible) | This Condition Category (CC) gaps will be filterd based on the CC type code, whether it is suspected, historic, and/or net-new. | |
| IN | evidenceStatus | 0..* | code | Evidence Status (Extensible) | This Condition Category (CC) gaps will be filterd based on the evidence status, whether the gap is an open-gap, invalid-gap, closed-gap, and/or pending. | |
| IN | providerTaxonomy | 0..* | code | ProviderTaxonomy (Extensible) | This Condition Category (CC) gaps will be filterd based on provider taxonomy. | |
| IN | encounter | 0..1 | Encounter (US Core Encounter Profile) | This is a reference to the Encounter resource, which provides information such as the encounter id and date of service. | ||
| IN | referenced | 0..* | Resource | Resources that are referenced by other input parameters, specifically Coverage and Encounter, defined in this operation. | ||
| OUT | return | 0..1 | Bundle | This operation returns a Bundle of MeasureReports and associated resources |
IG © 2021+ HL7 International / Clinical Quality Information. Package hl7.fhir.us.davinci-ra#2.1.0 based on FHIR 4.0.1. Generated 2025-11-20
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change