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: Risk Gap

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.

### Custom Header: contextId

#### Purpose

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.

#### Usage

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.

#### Syntax

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

### Parameters

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