Automate DTR (Documentation Templates and Rules) SMART app launch and CQL questionnaire prefill within an EHR workflow

domain: hl7.org/fhir/us/davinci-dtr · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Read the current published DTR IG (the most recently published STU version at hl7.org/fhir/us/davinci-dtr) to understand the SMART on FHIR app launch parameters and the DTR Questionnaire FHIR profile requirements.
  2. The EHR launches the DTR SMART app passing a launch context that includes the order, coverage, and patient in scope; the app uses these to call the payer's $questionnaire operation to retrieve the applicable Questionnaire resource.
  3. The Questionnaire contains CQL library references; execute the embedded CQL against the EHR FHIR server to auto-populate answers from existing clinical data — minimize manual entry by pre-filling every answerable item.
  4. Render remaining unanswered questions in the SMART app UI; validate required fields and value-set bindings before allowing submission to avoid server-side validation rejections.
  5. Submit the completed QuestionnaireResponse to the payer's FHIR endpoint (or bundle it with the PAS $submit operation for combined PA + documentation flow); store the QuestionnaireResponse reference on the originating ServiceRequest.
  6. Handle the case where the payer returns an updated Questionnaire mid-session (payer adaptive forms); re-execute CQL prefill on new items and prompt the clinician only for newly introduced unanswered questions.

Known gotchas

Related routes

Implement the Da Vinci DTR (Documentation Templates and Rules) workflow by launching a SMART app from within an EHR CDS Hook card, prefilling a FHIR Questionnaire using CQL logic against EHR data, and submitting the completed QuestionnaireResponse
hl7.org/fhir/us/davinci-dtr · 5 steps · unrated
Implement Da Vinci DTR to launch a SMART app, render a FHIR Questionnaire, and prefill it using CQL logic for prior authorization documentation
hl7.org/fhir/us/davinci-dtr · 6 steps · unrated
Prefill a Da Vinci DTR questionnaire using CQL logic and FHIR data to reduce manual prior authorization documentation burden
hl7.org/fhir/us/davinci-dtr · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans