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

CapabilityStatement: Risk Adjustment Reporting Client Capability Statement

Official URL: http://hl7.org/fhir/us/davinci-ra/CapabilityStatement/ra-reporting-client Version: 2.0.0-preview
Active as of 2024-04-18 Computable Name: RAClientCapabilityStatement

Copyright/Legal: Used by permission of HL7 International - Clinical Quality Information Work Group, all rights reserved Creative Commons License

This profile defines the expected capabilities of a Da Vinci Risk Adjustment Reporting Client when conforming to the Da Vinci Risk Adjustment Implementation Guide for interactions between Reporting Clients and Reporting Servers. Clients are the actors making the request for Risk Adjustment Coding Gap Reports for patient(s) and for Risk Adjustmenet Models that are available on the Server. This CapabilityStatement resource includes the complete list of the recommended Da Vinci Risk Adjustment profiles and RESTful operations that a Risk Adjustment Reporting Client could support. Clients have the option of choosing from this list based on their local use cases and other contextual requirements.

Raw OpenAPI-Swagger Definition file | Download

Risk Adjustment Reporting Client Capability Statement

  • Implementation Guide Version: 2.0.0-preview
  • FHIR Version: 4.0.1
  • Supported Formats: xml, json
  • Supported Patch Formats: application/json-patch+json
  • Published on: 2024-04-18 18:37:33+0000
  • Published by: HL7 International / Clinical Quality Information

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as "SHALL NOT". A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

SHALL Support the Following Implementation Guides

  • http://hl7.org/fhir/us/davinci-ra/ImplementationGuide/fhir.us.davinci-ra

FHIR RESTful Capabilities

Mode: client

Da Vinci Risk Adjustment Reporting Client SHALL support the operation and profiles specified in this implementation guide.

Security

For general security consideration refer to the Security and Privacy Considerations.

Summary of System-wide Interactions
  • SHOULD support the batch interaction.
  • MAY support the transaction interaction.
  • MAY support the search-system interaction.
  • MAY support the history-system interaction.

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUPCH-IH-TSearches_include_revincludeOperations
MeasureReportSupported profiles:
  Risk Adjustment Coding Gap MeasureReport		yyyyyydate, evaluatedResource, identifier, measure, patient, period, reporter, status, subjectMeasureReport:evaluatedResources
BundleSupported profiles:
  Risk Adjustment Coding Gap Report Bundle		yyyy

Resource Conformance: SHALLMeasureReport

Core FHIR Resource
MeasureReport
Reference Policy
literal, logical
Interaction summary
  • SHALL support read, search-type.
  • MAY support history-instance, history-type, update, patch.

Supported Profiles

http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-measurereport

Search Parameters
ConformanceParameterTypeDocumentation
SHALLdatedate
SHALLmeasurereference
SHALLpatientreference
SHALLperioddate
SHALLstatustoken
SHALLsubjectreference
SHOULDevaluatedResourcereference
MAYidentifiertoken
MAYreporterreference
 

Resource Conformance: MAYBundle

Core FHIR Resource
Bundle
Reference Policy
literal, logical
Interaction summary
  • SHALL support read, search-type.
  • MAY support history-instance, history-type.

Supported Profiles

http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-measurereport-bundle