This page is part of the Da Vinci Clinical Documentation Exchange (v2.0.0: STU2) based on FHIR R4. This is the current published version. For a full list of available versions, see the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
Profiles Associated with CDex Attachments Transactions
CDex Patient Demographics Profile |
This Profile is defined to be contained within the CDex Task Attachment Request Profile or CDex Task Data Request Profile. It is referenced when additional patient demographic data is communicated for a clinical data request (for example, to verify patient identity for HIPAA compliance regulations). It constrains the following elements to be mandatory (min=1):
and the following element to be must support (min=0):
|
CDex PractitionerRole Profile |
This Profile is defined to be contained within the CDex Task Attachment Request Profile. It is referenced by
At least a practitioner identifier or organization identifier SHALL be present. |
CDex Task Attachment Request Profile |
Payers use the Task based profile to request additional documentation (“attachments”) for claims or prior authorizations. It constrains the Task resource to minimal necessary data elements needed to request attachments and respond in a way that is compatible with existing X12 277 RFAI and 278 response transactions to allow for association and requests for (typically PDF and CCDA) documents using LOINC as the standard. It also supports requests for more detailed missing data using Questionnaire, CQL, and QuestionnaireResponse, as supported by Da Vinci DTR. It constrains the following elements to be mandatory (min=1):
It constrains following elements to be must support (min=0):
It defines the following elements to be optional:
* Either a “code” or a “questionnaire” Task.input element is required |
Operations Associated with CDex Attachments Transactions
Submit Attachment Operation |
Providers use this operation to submit solicited and unsolicited attachments or additional information for claims or prior authorization. The $submit-attachment operation accepts the clinical/administrative attachments and the necessary information to associate them with the claim or prior authorization and returns an HTTP response. For unsolicited attachments, the Provider invokes this operation before, concurrently, or after the claim or pre-authorization transaction. For solicited attachments, the Provider invokes it when responding to a Payer request for attachments or additional information. Any HTTP endpoint can use $submit-attachment, not just FHIR RESTful server endpoints. The input parameters are:
There are no output parameters. |
ValueSets Associated with CDex Attachments Transactions
CDex Attachment Task Code Value Set |
Codes used to identify the type of attachment request and control the payer system’s behavior. |
CDex Claim Use Value Set |
The purpose of a Claim resource and the reason for attachments. It includes the codes “preauthorization” and “claim”. |
Examples Associated with CDex Attachments Transactions
CDex Parameters Example1 |
CCDA Attachment Example: Parameters Resource example showing how it is used to submit attachments using the |
CDex Parameters Example 2 |
Signed FHIR Document Attachment Example: Parameters Resource example showing how it is used to submit attachments using the |
CDex Parameters Example 3 |
PDF Attachment Example: Parameters Resource example showing how it is used to submit attachments using the |
CDex Parameters Example 4 |
Laboratory Results Attachment Example: Parameters Resource example showing how it is used to submit multiple attachments using the |
CDex Parameters Example 5 |
Completed QuestionnaireResponse Attachment Example: Parameters Resource example showing how it is used to submit a solicited attachment using the |
CDex Task Example 19 |
Claim Attachment Request Example: Claim Attachment Request sent by payer to a provider requesting a signed Progress note (H&P) note |
CDex Task Example 20 |
Prior-Auth Attachment Request Example: Prior Authorization Attachment Request with a POU of “coverage authorization” sent by payer to a provider requesting a signed History and physical (H&P) note. |
CDex Task Example 22 |
Request Additional Data using a Questionnaire: Prior Authorization Attachment Request with a POU of “coverage authorization” sent by payer to a provider requesting a data request questionnaire be completed. |
CDex Task Example 23 |
Request Additional Data using an Adaptive Questionnaire: Prior Authorization Attachment Request with a POU of “coverage authorization” sent by payer to a provider requesting an adaptive questionnaire be completed. |
CDex Task Example 24 |
Completed Request for Additional Data using a Questionnaire: Completed Task for CDex Task Example 22. This example has a status of “completed” and a “lastModified” date of 6/17/2022. The “reasonCode” is “request additional data” and the “output” is a QuestionnaireResponse. |
CDex Task Example 25 |
Completed Request for Additional Data Using an Adaptive Questionnaire: Completed Task for CDex Task Example 23. This example has a status of “completed” and a “lastModified” date of 6/17/2022. The “reasonCode” is “request additional data” and the “output” is a QuestionnaireResponse. |
CDex Task Example 28 |
Request Additional Data Requiring a Verification Signature Using a Questionnaire: Prior Authorization Attachment Request with a POU of “coverage authorization” and Signature required sent by payer to a provider requesting a data request questionnaire be completed and signed. |
CDex Task Example 29 |
Completed Request for Additional Data Requiring a Verification Signature Using a Questionnaire: Completed Prior Authorization Attachment Request (CDex Task Example 28) with a status of “completed” and output referencing the digitally signed QuestionnaireResponse. |
Profiles Associated with CDex Task Based Approach Transactions
CDex Task Data Request Profile |
This Task profile is used to solicit information from a system. The Data Consumer uses it when direct query transactions are not an option, and the transaction may require human intervention. It represents both the data request and the returned “data request”. Data requests are supplied as codes, free-text, or FHIR Restful queries. It can also support requests for more detailed missing data using Questionnaire, CQL, and QuestionnaireResponse as supported by Da Vinci DTR. It constrains the following elements to be mandatory (min=1):
It constrains following elements to be must support (min=0):
It defines the following elements to be optional:
It prohibits the following elements (max=0):
* Either a “query”, “code”, or “questionnaire” Task.input element is required |
ValueSets Associated with CDex Task Based Approach Transactions
CDex Data Request Task Code Value Set |
Codes used to identify the type of data request and control the payer system’s behavior. |
CDex Work Queue Value Set |
The set work queue tags that the provider may use in their workflow to process requests. This code set is composed of codes defined by this Guide. |
Examples Associated with CDex Task Based Approach Transactions
CDex Task Example 1 |
Query String Request for Condition: Task to seek a patient’s active conditions using the CDex Profile query input. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 10 |
Coded Request for A1C Results: Task to seek a patient’s HbA1c test results using the CDex Profile query input. This example illustrates the use of FHIR resource references to the various actors. |
CDex Task Example 11 |
Query String Request for Condition with Authorization: In this provider to provider request, a Task is used to request a patient active conditions using the CDex Profile query input. A reference to a formal authorization is provided. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 12 |
Completed Query String Request for Condition with Authorization: In this completed provider to provider request, a Task is used to request a patient active conditions using the CDex Profile query input. A reference to a formal authorization is provided. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 13 |
Free Text Request for Condition with Provenance: Task to seek a patient active conditions and its provenance using free text in the CDex Profile code input. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 14 |
Completed Free Text Request for Condition with Provenance: Completed Task to seek a patient active conditions and its provenance using free text in the CDex Profile code input. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 15 |
Query String Request for Condition with Provenance: Task to seek a patient active conditions and its provenance using query string in the CDex Profile query input. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 16 |
Completed Query String Request for Condition with Provenance: Completed Task to seek a patient active conditions their provenance using the CDex Profile query input. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 17 |
Query String Request for Signed Condition Data: Task to seek a patient active conditions using the CDex Profile query input and using the signature input to indicate a signature is required. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 18 |
Completed Query String Request for Signed Condition Data: Completed Task to seek a signed patient active conditions. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 2 |
Completed Query String Request for Condition: Completed Task to seek a patient active conditions using the CDex Profile query input. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 21 |
Coded Request for Surgical Operation Note: Task to seek a patient’s latest operative notes using the CDex Profile code input. This example illustrates the use of FHIR resource references to the various actors. |
CDex Task Example 26 |
Data Request Using a Questionnaire: Task to seek reason for home oxygen therapy using the CDex Profile questionnaire input. This example illustrates the use of Questionnaire to request data from a data source |
CDex Task Example 27 |
Completed Data Request Using a Questionnaire: Completed Task for CDex Task Example 26. This example has a status of “completed” and a “lastModified” date of 6/19/2022. The “output” is a QuestionnaireResponse.Task to seek reason for home oxygen therapy. |
CDex Task Example 3 |
Completed Query String Request for Condition with Contained Output: Completed Task to seek a patient active conditions using the CDex Profile query input and using a contained resource for the output data. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 30 |
Data Request Requiring a Verification Signature Using Questionnaire: Task to seek reason for home oxygen therapy using the CDex Profile questionnaire input. This example illustrates the use of Questionnaire to request data from a data source and requires a digitally signed QuestionnaireResponse. |
CDex Task Example 31 |
Completed Data Request Requiring a Verification Signature Using Questionnaire: Completed Task (CDex Task Example 30) with a status of “completed” and output referencing the digitally signed QuestionnaireResponse. |
CDex Task Example 4 |
Free Text Request for Condition: Task to seek a patient active conditions using free text in the CDex Profile code input. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 5 |
Completed Free Text Request for Condition: Completed Task to seek a patient active conditions using free text for the input in the CDex Profile code input. This example illustrates the use of business identifiers (instead of pointing to a FHIR resource) to references the various actors. |
CDex Task Example 6 |
Coded Request for Progress note: Task to seek a patient’s latest Progress notes using the CDex Profile code input. This example illustrates the use of FHIR resource references to the various actors. |
CDex Task Example 7 |
Completed Coded Request for Progress note - PDF: Completed Task to seek a patient’’'’s latest Progress notes using the CDex Profile code input. This example illustrates the use of FHIR resource references to the various actors. The output data is a contained DocumentReference with an inline base64 encoded PDF document. |
CDex Task Example 8 |
Completed Coded RequestOperative note -CCDA: Completed Task to seek a patient’s Operative notes using the CDex Profile code input. This example illustrates the use of FHIR resource references to the various actors. The output data is a contained DocumentReference with an inline base64 encoded CCDA document. |
CDex Task Example 9 |
Failed Coded Request for A1C Results: Task to seek a patient’s HbA1c test results using the CDex Profile query input with a failed status. This example illustrates the use of FHIR resource references to the various actors. |
Profiles Associated with CDex Signatures
CDex SDC QuestionnaireResponse Profile |
This extension is derived from the SDC Questionnaire Response profile and enforces the various elements of signature documented in the CDex guide to represent an enveloped signature. It adds the following constraints:
|
CDex Signature Bundle Profile |
This Bundle profile enforces the various elements of signature documented in the CDex guide to represent an enveloped signature. It adds the following mandatory (min=1) constraint:
|
CDex Signature Profile |
This Signature DataType profile enforces the various elements of signature documented in the CDex guide. It adds the following mandatory (min=1) constraints:
In addition, the following mandatory (min=1) element is inherited from the base standard:
|
ValueSets Associated with CDex Signatures
CDex Identifier Types Value Set |
Identifiers type for providers and organizations limited to NPI or US Tax id. |
Examples Associated with CDex Signatures (Several examples are in Task Based and Attachments Examples groupings as well)
CDEX Document with Digital Signature Example |
Digital signature example showing how it is used to sign a FHIR Document. The CDEX use case would be the target resource in response to a Task-based request where a digital signature was required. If no signature was required, the response would typically be in the form of an individual resource. |
CDEX Document with Electronic Signature Example |
Electronic signature example showing how an image file can be used to sign a document Bundle. The CDEX use case would be the target resource in response to a Task-based request where an electronic signature was required. If no signature was required, the response would typically be in the form of an individual resource. |
CDex Questionnaire Example2 |
This example is a simple data request Questionnaire used in the Task Based and Attachments transactions. It indicates that a verification signature is needed when completing the QuestionnaireResponse. It is adapted from the Da Vinci DTR IG. |
CDex QuestionnaireResponse Example3 |
This Questionnaire Response example demonstrates the response to a CDEX Data Query or Attachments that uses a Questionnaire to request the data when an electronic verification signature is required. It is adapted from the Da Vinci DTR IG. The electronic signature is an image file in the QuestionnaireResponse signature extension. This example is adapted from the Da Vinci DTR IG. |
CDex QuestionnaireResponse Example4 |
This Questionnaire Response example demonstrates the response to a CDEX Data Query or Attachments that uses a Questionnaire to request the data and an electronic digital Verification signature is required. It is adapted from the Da Vinci DTR IG. The digital signature is a JSON FHIR Signature in the QuestionnaireResponse signature extension. This example is adapted from the Da Vinci DTR IG. |
CDEX SearchSet Bundle with Digital Signature Example |
Digital signature example showing how it is used to sign a search set Bundle. The CDEX use case would be a response to a Direct Query where a digital signature was required. |
ValueSets and CodeSystems used in both CDex Attachments and Task Based Approach Transactions
CDex Temporary Code System |
Codes temporarily defined as part of the CDex implementation guide. These will eventually migrate into an officially maintained terminology (likely HL7’s UTG code systems). |
CDex Purpose of Use Value Set |
The set of purpose of use codes for the requested data (the output of the task). This code set is composed of FHIR core Purpose of Use security labels and additional codes defined by this Guide. |
Examples used in both CDex Attachments and Task Based Approach Transactions
CDex Questionnaire Example1 |
This example is a simple data request Questionnaire used in the Task Based and Attachments transactions. It is adapted from the Da Vinci DTR IG. |
CDex QuestionnaireResponse Example1 |
This Questionnaire Response example demonstrates the response to a CDEX Data Query or Attachments that uses a Questionnaire to request the data. It is adapted from the Da Vinci DTR IG. |
CDex QuestionnaireResponse Example2 |
This Questionnaire Response example demonstrates the response to a CDEX Data Query or Attachments that uses a Questionnaire to request the data. The Questionnaire is an adaptive questionnaire and the resulting QuestionnaireResponse contains the generated Questionnaire instance. This example is adapted from the Da Vinci DTR IG. For more information about adaptive questionnaires in FHIR see the SDC Implementation Guide. |
The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.
Data Consumer Client CapabilityStatement |
This CapabilityStatement describes the expected capabilities of a Da Vinci CDex Data Consumer in Client mode when requesting clinical data from the Data Source during clinical data exchange. The capabilities include one or more of the following interactions:
|
Data Consumer Server CapabilityStatement |
This CapabilityStatement describes the expected capabilities of a Da Vinci CDex Data Consumer in Server mode when responding to a Data Source or one of its proxies during clinical data exchange. The capabilities include one or more of the following interactions:
|
Data Source Client CapabilityStatement |
This CapabilityStatement describes the expected capabilities of a Da Vinci CDex Data Source in Client mode during clinical data exchange with a Data Consumer. The capabilities include one or more of the following interactions:
|
Data Source Server CapabilityStatement |
This CapabilityStatement describes the expected capabilities of a Da Vinci CDex Data Source in Server mode when responding to a Data Consumer during clinical data exchange. The capabilities include one or more of the following interactions:
|