Smile CDR v2024.08.PRE
On this page:

46.0.1Prior Auth DTR (Documentation Templates and Rules) Module Overview
Experimental

 
Please contact us if you would like to try out this experimental new feature.

46.0.1.1Prior Auth DTR Introduction

Da Vinci - Documentation Templates and Rules is an implementation guide that provides a mechanism for payers to express their documentation requirements computably in a way that allows clinicians and other EHR users to navigate and quickly specify the needed information in a context-specific way.

46.0.1.2Operations

Smile CDR supports the DTR IG with implementations of the following operations:

46.0.1.3Questionnaire Package

The Questionnare/$questionnaire-package operation returns one or more collection Bundles each consisting of a single Questionnaire resource as well as any dependency Library and ValueSet resources needed to allow a renderer to fully render and process the Questionnaire.

Smile CDR supports the use of $apply to generate the Questionnaire and package Bundle. This enables content written for the Prior Auth CRD module to be used with the Prior Auth DTR module.

46.0.1.3.1Parameters

The following parameters are supported for the Questionnaire/$questionnaire-package operation:

ParameterTypeDescription
coverageCoverageCoverage resource instances to establish the member and the coverage for which documentation is to be collected.
orderResourceOrder resource instances. e.g., DeviceRequest, ServiceRequest, MedicationRequest,... Encounter, Appointment, etc. to establish context for the information to be collected.
referencedResourceOrder-related referenced resources which are necessary to support stand-alone launch – specifically the Patient, requester, performer and location-related resources. (SHALL NOT include resources from 'supportingInformation').
questionnairecanonicalCanonical url for Questionnaire(s) (possibly version-specific) to return.
contextstringContext ID from CRD or CDex. May be used to determine what Questionnaires to return and/or to support pre-population.
changedsincedateTimeIf present, only Questionnaire bundles whose Questionnaire or associated artifacts have changed since the specified timestamp. If there are no changed artifacts the operation will simply return a 200 Ok indicating that nothing has changed since the specified timestamp.
usePutbooleanDetermines the type of method returned in the Bundle Entries: POST if False (the default), PUT if True.

46.0.1.4Log Questionnaire Errors

The Questionnare/$log-questionnaire-errors operation allows submission of issues encountered when working with DTR operations.

46.0.1.4.1Parameters

The following parameters are supported for the Questionnaire/$log-questionnaire-errors operation:

ParameterTypeDescription
questionnairecanonicalThe Questionnaire which generated the errors
operationOutcomeOperationOutcomeThe OperationOutcome documenting the Questionnaire/CQL errors and their location

46.0.1.5Next Question

The Questionnare/$next-question operation is used for adaptive questionnaires - forms where the next question (or set of questions) is based on the previous answers.

Smile CDR supports the use of $apply to process the QuestionnaireResponse and generate the next item(s) in the Questionnaire.

46.0.1.5.1Parameters

The following parameters are supported for the Questionnaire/$next-question operation:

ParameterTypeDescription
questionnaire-responseResourceThe QuestionnaireResponse resource with a contained Questionnaire. When invoking the operation for the first time, neither the QuestionnaireResponse nor the contained Questionnaire will have any items, as no questions are yet known. In subsequent calls, the QuestionnaireResponse will include answers to all required questions asked so far and the contained QuestionnaireResponse will remain the same as provided back from the operation in the preceding response.