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 Server Capability Statement

Official URL: http://hl7.org/fhir/us/davinci-ra/CapabilityStatement/ra-reporting-server Version: 2.0.0
Standards status: Trial-use Maturity Level: 2 Computable Name: RAServerCapabilityStatement
Other Identifiers: OID:2.16.840.1.113883.4.642.40.29.13.4

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 Server when conforming to the Da Vinci Risk Adjustment Implementation Guide for interactions between Reporting Clients and Reporting Servers. Servers are the actors receiving 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 Server could support. Servers 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-server

Risk Adjustment Reporting Server 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: server

Da Vinci Risk Adjustment Reporting Server 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 TypeProfileRV-RSUPCDH-IH-TSearches_include_revincludeOperations
MeasureSupported Profiles
  Risk Adjustment Model Measure
y$ra.evaluate-measure
MeasureReportSupported Profiles
  Risk Adjustment Coding Gap MeasureReport
yyyyyyyyydate, evaluatedResource, identifier, measure, patient, period, reporter, status, subject, measurereport-categoryMeasureReport.evaluatedResources
BundleSupported Profiles
  Risk Adjustment Coding Gap Report Bundle
yyyyyyyyy

Resource Conformance: MAY Measure

Core FHIR Resource
Measure
Reference Policy
Interaction summary
  • SHALL support read.

Extended Operations
ConformanceOperationDocumentation
MAY$ra.evaluate-measure

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

    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

    delete

    Delete allows maintainers of the MeasureReports to delete the logical definition of a MeasureReport

    create

    Create allows maintainers of the MeasureReports to create the logical definition of a MeasureReport

    search-type

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

  • MAY support vread, history-instance, history-type.

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

    update

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

    patch

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

    delete

    Delete allows maintainers of the Bundles to delete the logical definition of a Bundles

    create

    Create allows maintainers of the Bundles to create the logical definition of a Bundle

    search-type

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

  • MAY support vread, history-instance, history-type.