Implement Da Vinci DTR Documentation Templates and Rules using Questionnaire $populate with CQL

In-depth guide

Steps

1. Launch the DTR SMART app from a CRD Card link or standalone; the app receives the launch context including patient, encounter, and a reference to the Questionnaire (or Questionnaire package) required for prior authorization documentation
2. Retrieve the FHIR Questionnaire resource from the payer's FHIR endpoint; the Questionnaire will embed CQL Library references (via the cqf-library extension) containing the logic to prefill answers from EHR data
3. Invoke Questionnaire/$populate (a type-level or instance-level operation on the Questionnaire resource) with the QuestionnaireResponse draft and EHR FHIR context; the server or DTR app evaluates the embedded CQL against the patient's data to pre-populate answers
4. Render the (partially pre-filled) Questionnaire to the clinician; highlight auto-filled answers with their data source so the clinician can verify and complete remaining required fields
5. On clinician completion, submit the QuestionnaireResponse to the EHR FHIR server for storage; also package it into the PAS Claim/$submit Bundle if the prior authorization request is being submitted immediately
6. Store the completed QuestionnaireResponse in the EHR and optionally in the payer's system; reference it from the associated Task or CommunicationRequest to maintain the documentation audit trail