Da Vinci Risk Adjustment Implementation Guide
2.0.0 - 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 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
Standards status: Trial-use Maturity Level: 2 Computable Name: RAClientCapabilityStatement
Other Identifiers: OID:2.16.840.1.113883.4.642.40.29.13.3

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

Generated Narrative: CapabilityStatement ra-reporting-client

Risk Adjustment Reporting Client Capability Statement

  • Implementation Guide Version: 2.0.0
  • FHIR Version: 4.0.1
  • Supported Formats: xml, json
  • Supported Patch Formats: application/json-patch+json
  • Published on: 2024-12-10 22:27:38+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 batchinteraction.
  • MAY support the transactioninteraction.
  • MAY support the search-systeminteraction.
  • MAY support the history-systeminteraction.

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, subject, measurereport-categoryMeasureReport:evaluatedResources
BundleSupported Profiles
  Risk Adjustment Coding Gap Report Bundle		yyyy

Resource Conformance: SHALL MeasureReport

Core FHIR Resource
MeasureReport
Reference Policy
literal, logical
Interaction summary
  • SHALL support
    read

    Read allows maintainers of the MeasureReports to get the logical definitions of the MeasureReports

    search-type

    Search allows maintainers of the MeasureReports to find the logical definition of a MeasureReport

  • MAY support history-instance, history-type
    update

    Update allows maintainers of the MeasureReports to update the logical definitions of a MeasureReport by its id or create a new one if it is new

    patch

    Patch allows maintainers of the MeasureReports to update the logical definition of a MeasureReport by posting a set of changes to it

Supported Profiles

Risk Adjustment Coding Gap MeasureReport

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

Resource Conformance: MAY Bundle

Core FHIR Resource
Bundle
Reference Policy
literal, logical
Interaction summary
  • SHALL support
    read

    Read allows maintainers of the Bundles to get the logical definitions of the Bundle

    search-type

    Search allows maintainers of the Bundles to find the logical definition of a Bundle

  • MAY support history-instance, history-type.

Supported Profiles

Risk Adjustment Coding Gap Report Bundle