davinci_dtr_test_kit 0.17.0 → 0.18.0

data/lib/davinci_dtr_test_kit/requirements/generated/dtr_payer_server_v220_requirements_coverage.csv

@@ -0,0 +1,114 @@
+Req Set,ID,URL,Requirement,Conformance,Actors,Conditionality,Not Tested Reason,Not Tested Details,Da Vinci DTR Payer Server Test Suite v2.2.0 Short ID(s),Da Vinci DTR Payer Server Test Suite v2.2.0 Full ID(s)
+hl7.fhir.us.davinci-dtr_2.2.0,conf-1,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-1,"In order to conform to this implementation guide, in addition to adhering to any relevant 'SHALL' statements, a system **SHALL** conform to at least one of the appropriate CapabilityStatements listed here:",SHALL,"DTR Client,DTR Server",false,,,1.01,dtr_payer_server_v220-dtr_payer_v220_discovery-dtr_payer_server_v220_capability_statement_test
+hl7.fhir.us.davinci-dtr_2.2.0,conf-2,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-2,Da Vinci DTR implementations **SHALL** conform to the [HRex](http://hl7.org/fhir/us/davinci-hrex/1.2.0/conformance.html#mustsupport) and [US Core](http://hl7.org/fhir/us/core/STU7/must-support.html) Guidance where applicable.,SHALL,"DTR Client,DTR Server",false,,,"3.7.01, 3.7.02, 3.7.03, 3.7.04, 3.7.05, 3.7.06","dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_server_v220_must_support-dtr_v220_payer_questionnaire_package_output_parameters_must_support, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_server_v220_must_support-dtr_v220_payer_questionnaire_package_bundle_must_support, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_server_v220_must_support-dtr_v220_payer_questionnaire_base_must_support, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_server_v220_must_support-dtr_v220_payer_questionnaire_standard_must_support, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_server_v220_must_support-dtr_v220_payer_questionnaire_adaptive_must_support, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_server_v220_must_support-dtr_v220_payer_questionnaire_adaptive_search_must_support"
+hl7.fhir.us.davinci-dtr_2.2.0,conf-8,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-8,"When determining Questionnaire packages, processing adaptive forms via `$next-question`, or constructing population logic, DTR services **SHALL NOT** depend on or set expectations for the inclusion of resource instances not compliant with profiles defined in this guide, HRex, or US Core.",SHALL NOT,DTR Server,false,,,3.2.04,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_server_v220_no_custom_extension_test
+hl7.fhir.us.davinci-dtr_2.2.0,conf-9,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-9,"Similarly, they **SHALL NOT** depend on or set expectations for the inclusion of any data elements not marked as mandatory (min cardinality >= 1) or `mustSupport` in those profiles.",SHALL NOT,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,conf-10,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-10,DTR servers **SHALL NOT** set expectations for systems to support Questionnaire rendering or response validation capabilities above those established in the [DTR Questionnaire profiles](artifacts.html#structures-resource-profiles) and **SHALL** accept and successfully process any Questionnaire Response returned for a Questionnaire from that DTR server that is deemed valid against the rules expressed only as `mustSupport` in the Questionnaire profile.,SHALL NOT / SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,conf-11,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-11,"If the proposed change is adopted and published in the DTR continuous integration build or the CI build of one of its dependencies (e.g., US Core), implementations **MAY**, by mutual agreement, pre-adopt the use of those additional profiles and/or `mustSupport` data elements and not be considered in violation of #1 or #2 above.",MAY,"DTR Client,DTR Server",true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,conf-12,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-12,"Where cardinality and other constraints present in profiles allow data elements to be omitted, DTR compliant systems **SHALL NOT** treat the omission of those elements as a conformance error - i.e., DTR services are expected to return appropriate questionnaire package responses, not system level errors (e.g., HTTP 4xx errors), and DTR clients are expected to render and allow completion of forms as normal.",SHALL NOT,"DTR Client,DTR Server",true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,conf-13,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-13,"DTR clients and services and **SHALL** use standard DTR data elements (i.e., elements found within DTR-defined or inherited profiles and marked as mandatory or `mustSupport`) to communicate needed data if such elements are intended to convey such information.",SHALL,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,conf-14,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-14,"Organizations implementing DTR **SHALL NOT** publish guidance setting expectations for where certain data elements are conveyed within DTR and inherited data structures, but **MAY** submit change requests to DTR, CRD, HRex, or US Core requesting that additional guidance be provided to implementers on data structure usage to increase consistency across implementations.",SHALL NOT / MAY,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,conf-15,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/confexpectations.html#ci-c-conf-15,Such enhancements **SHALL** be submitted as a ticket for consideration for inclusion in a future version of the implementation guide.,SHALL,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,oper-1,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-log-questionnaire-errors.html#ci-c-oper-1,This operation **SHALL** be supported by payers and DTR applications.,SHALL,"DTR Client,DTR Server",false,,,4.01,dtr_payer_server_v220-dtr_payer_v220_log_questionnaire_error_support-dtr_v220_payer_log_questionnaire_errors_support
+hl7.fhir.us.davinci-dtr_2.2.0,oper-5,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-DTR-ValueSet-expand.html#ci-c-oper-5,"Additionally, the valueset **SHALL** use the current date as the expansion date and **SHALL** include only active codes.",SHALL,DTR Server,false,,,3.5.01,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_valueset_expand_support-dtr_v220_payer_value_set_expansion
+hl7.fhir.us.davinci-dtr_2.2.0,oper-7,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-7,"If multiple versions of a questionnaire are returned, each **SHALL** be associated with distinct orders or coverages in the associated QuestionnaireResponses (see below).",SHALL,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,oper-8,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-8,"If this operation is invoked with a context id provided by CRD where the `coverage-information` extension indicated that additional documentation was required, but no questionnaires are returned by the operation, the operation **SHALL** return an OperationOutcome with clear instructions on how else to determine needed documentation or an indication that circumstances have changed and additional documentation is no longer necessary.",SHALL,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,oper-9,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-9,"If any of the explicitly requested questionnaires cannot be found, a warning **SHALL** be provided in the [Outcome](StructureDefinition-dtr-qpackage-output-parameters.html) element of the outer `Parameters` resource.",SHALL,DTR Server,true,,,3.6.01,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_error_handling-dtr_server_v220_payer_questionnaire_not_found
+hl7.fhir.us.davinci-dtr_2.2.0,oper-10,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-10,"If the operation is successful, the response **SHALL** be a `Parameters` resource conformant to the [DTRQuestionnairePackageOutputParameters](StructureDefinition-dtr-qpackage-output-parameters.html) profile.",SHALL,DTR Server,true,,,3.2.01,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_questionnaire_response_validation
+hl7.fhir.us.davinci-dtr_2.2.0,oper-11,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-11,"If the operation fails, the response payload **SHOULD** be an OperationOutcome.",SHOULD,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,oper-12,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-12,"The Bundle **SHALL** include the Questionnaire as the first entry along with all external Libraries referenced by the Questionnaire using the [cqf-library](https://build.fhir.org/ig/HL7/fhir-extensions/StructureDefinition-cqf-library.html) extension, as well as a recursive retrieval of all `relatedArtifact` references of type 'depends-on'.",SHALL,DTR Server,false,,,3.2.02,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_server_v220_payer_questionnaire_package_contents
+hl7.fhir.us.davinci-dtr_2.2.0,oper-13,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-13,All Libraries **SHALL** include both CQL and EML representations.,SHALL,DTR Server,false,,,3.4.05,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_cql_library_validation
+hl7.fhir.us.davinci-dtr_2.2.0,oper-14,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-14,The Bundle **SHALL** include all external ValueSet instances referenced by the Questionnaire.,SHALL,DTR Server,false,,,3.2.05,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_value_set_validation
+hl7.fhir.us.davinci-dtr_2.2.0,oper-15,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-15,All value sets with expansions under 40 entries **SHALL** be expanded as of the current date and using expansion parameters (such as SNOMED release) as deemed appropriate by the payer.,SHALL,DTR Server,false,,,3.2.06,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_small_value_set_expansion
+hl7.fhir.us.davinci-dtr_2.2.0,oper-16,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-16,"All references to Questionnaires, Libraries, and ValueSets within the Bundle **SHALL** be version specific, as breaking changes may occur between versions and would likely cause failures or inconsistent data.",SHALL,DTR Server,false,,,"3.2.07, 3.4.05","dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_questionnaire_references_version_specific, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_cql_library_validation"
+hl7.fhir.us.davinci-dtr_2.2.0,oper-17,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-17,"Multiple versions of a Library **MAY** be treated as an error, or **MAY** be handled by returning the 'most recent' version of the referenced versions.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,oper-18,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-18,"As well, the Questionnaire Bundle **SHALL** contain one initial draft `QuestionnaireResponse` that references the `Questionnaire` for that Bundle and populate the subject as well as repetitions of the Context extension that identify the Coverage(s) and Request or Encounter resources the `Questionnaire` is to be completed for.",SHALL,DTR Server,false,,,3.2.03,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_initial_questionnaire_response
+hl7.fhir.us.davinci-dtr_2.2.0,oper-19,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/OperationDefinition-questionnaire-package.html#ci-c-oper-19,The payer **MAY** opt to pre-populate some answers in the provided QuestionnaireResponses based on information the payer has in its own records or has from context from CRD or from other prior auth or claims submissions.,MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,prof-1,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/StructureDefinition-dtr-qpackage-input-parameters.html#ci-c-prof-1,"However, the system should check that the passed orders are the same as was processed at CRD time before presuming that the questionnaires needed will be the same and if the orders have changed, or there's a possibility that the rules governing which Questionnaires are needed might have changed, the system **SHOULD** re-check to determine the needed Questionnaires.",SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,sec-1,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/security.html#ci-c-sec-1,Implementers **SHALL** adhere to any security and privacy rules defined by:,SHALL,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,sec-2,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/security.html#ci-c-sec-2,This scope granted **MAY** provide the SMART on FHIR application access to more data than is needed for the specific situation.,MAY,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,sec-3,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/security.html#ci-c-sec-3,"For compliance with HIPAA Minimum Necessary, the CQL included in payer-defined Questionnaires **SHALL** limit requests for information from the EHR's API to only items that are relevant to the documentation requirements for which DTR was launched (e.g., documentation requirements for a service that does require prior authorization).",SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,sec-4,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/security.html#ci-c-sec-4,Compliant Questionnaires **SHALL NOT** include hidden or read-only questions where the data is populated from the EHR.,SHALL NOT,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,sec-9,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/security.html#ci-c-sec-9,"Payer systems **SHALL** use information received during execution of the DTR [$questionnaire-package](OperationDefinition-questionnaire-package.html) operation solely for the purpose of satisfying the operation invoked, for audit, and to satisfy metric reporting needs.",SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,sec-10,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/security.html#ci-c-sec-10,"If a payer uses adaptive forms to gather information, the payer **SHALL NOT** persist or use the information shared as part of the [$next-question](http://hl7.org/fhir/uv/sdc/STU3/OperationDefinition-Questionnaire-next-question.html) operation for any purpose other than:",SHALL NOT,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-1,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-1,"Payer DTR services SHALL NOT work preferentially with their own apps for IG-defined functionality, though clients and services MAY offer additional behavior above and beyond what's covered in this specification.",SHALL NOT / MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-5,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-5,Payers **MAY** have multiple back-end functions that handle different types of decision support and/or different types of services.,MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-6,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-6,"However, for the purpose of DTR conformance, payers **SHALL** have a single endpoint (managed by themselves or a delegate) that can handle responding to all DTR service calls.",SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-7,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-7,"This registration process **SHALL** ensure that the DTR app or Full EHR (i.e., Native App):",SHALL,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-8,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-8,"Implementers of this IG **SHOULD** support the [endpoint discovery](http://hl7.org/fhir/us/davinci-hrex/1.2.0/endpoint-discovery.html) mechanism defined in the HRex specification to allow discovery of the endpoints used in this IG - specifically the [$questionnaire-package](OperationDefinition-questionnaire-package.html) operation endpoint used to retrieve the Questionnaires and associated libraries, value sets, etc. to be completed.",SHOULD,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-9,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-9,"Even after an application has been successfully registered, payers and EHRs **SHOULD** monitor the application behavior and **MAY** suspend an application's access if it is suspected of malicious behavior.",SHOULD / MAY,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-10,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-10,"Some payers MAY create Questionnaires that rely on code systems that require licensing for use where there isn’t already a cross-U.S. license in place (e.g., UB, CPT).",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-11,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-11,The expectations around licensing requirements SHALL be established as part of the configuration process between the parties.,SHALL,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-12,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-12,"DTR services **SHOULD** have DTR questionnaires available for all covered items that require additional data collection to support prior auth submission, claim submission, or appropriate use documentation. (Future versions of this guide will likely tighten this expectation to a 'SHALL')",SHALL / SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-13,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-13,DTR server organizations **MAY** surface their Questionnaires via a registry or some similar mechanism that allows DTR client organizations to pre-examine/pre-process Questionnaires to allow for more optimal handling when those Questionnaires are actually solicited.,MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-15,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-15,Payers **MAY** support either approach or opt to provide some Questionnaires using one approach and others using the second based on the requirements of the form.,MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-17,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-17,"Questionnaires, whether standard or adaptive, **SHALL** also use logic that ensures that only questions and answer choices which are required for the intended clinical or administrative purposes are included, based on what answers have already been provided/populated using elements such as `enableWhen` or `enableWhenExpression`.",SHALL,DTR Server,false,,,3.4.01,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_questionnaire_relevance_logic
+hl7.fhir.us.davinci-dtr_2.2.0,spec-18,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-18,"When using elements with a data type of 'Expression' within Questionnaires to control flow or rendering, all logic **SHALL** be written in CQL.",SHALL,DTR Server,true,,,3.4.02,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_questionnaire_expression_language
+hl7.fhir.us.davinci-dtr_2.2.0,spec-21,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-21,"However, payers **SHALL NOT** rely on support for any of these elements in the design of their Questionnaire (i.e., a DTR client that ignores such elements cannot impact the successful collection of information acceptability of the information gathered).",SHALL NOT,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-22,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-22,"If there is a need to collect both patient or clinical data as well as administrative data, forms **SHALL** be designed in one of the two the following manners:",SHALL,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-23,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-23,"When a payer uses an Adaptive Form, they **SHALL** return a questionnaire instance compliant with the DTR [AdaptiveQuestionnaire-Search](StructureDefinition-dtr-questionnaire-adapt-search.html) profile.",SHALL,DTR Server,true,,,3.3.02,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_next_question_support-dtr_v220_payer_adaptive_questionnaire_response_validation
+hl7.fhir.us.davinci-dtr_2.2.0,spec-24,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-24,"If present, any `questionnaireAdaptive` url **SHALL** be a sub-url under the base for the payer and able to be accessed within the same SMART Backend Services connection as was established to make the [$questionnaire-package](OperationDefinition-questionnaire-package.html) call.",SHALL,DTR Server,true,,,3.3.05,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_next_question_support-dtr_v220_payer_adaptive_questionnaire_endpoint
+hl7.fhir.us.davinci-dtr_2.2.0,spec-25,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-25,The QuestionnaireResponse included in the [Questionnaire Package Bundle](StructureDefinition-DTR-QPackageBundle.html) accompanying an adaptive Questionnaire **SHALL** follow the convention of referencing a [contained](https://hl7.org/fhir/R4/references.html#contained) Questionnaire `derivedFrom` the canonical for the Questionnaire being completed.,SHALL,DTR Server,false,,,3.2.08,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_adaptive_questionnaire_response_contained_questionnaire
+hl7.fhir.us.davinci-dtr_2.2.0,spec-26,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-26,"Typically, the QuestionnaireResponse and [contained](https://hl7.org/fhir/R4/references.html#contained) Questionnaire will contain no answers (or corresponding questions), though the payer **MAY** opt to include a few pre-populated answers for user review prior to soliciting additional questions using the [$next-question](OperationDefinition-DTR-Questionnaire-next-question.html) operation.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-27,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-27,"Payers **MAY** define pre-populatable questions to extract such information, using CQL to access the Questionnaire's [launchContext](https://hl7.org/fhir/uv/sdc/STU3/StructureDefinition-sdc-questionnaire-launchContext.html) extension or performing any necessary data retrieval.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-28,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-28,There are three strategies payers can use – and payers **MAY** opt to combine strategies within a single Questionnaire:,MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-29,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-29,"The payer **MAY** opt to include CQL [Libraries](http://hl7.org/fhir/R4/library.html) and ValueSets in the package that are not actually referenced by any questions, on the prospect that they *might* be (or are likely to be) referenced by one of the questions at some point.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-30,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-30,"The payer **MAY** add CQL [Libraries](http://hl7.org/fhir/R4/library.html) and ValueSets as ['contained'](https://hl7.org/fhir/R4/references.html#contained) resources inside the QuestionnaireResponse that are relevant to the questions that are part of the Questionnaire for each [$next-question](OperationDefinition-DTR-Questionnaire-next-question.html) call, slowly building up the set of resources that happen to be relevant to the questions actually asked.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-31,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-31,"Finally, the payer **MAY** opt to specify the CQL and codes without using [Libraries](http://hl7.org/fhir/R4/library.html) or ValueSets at all – the CQL can be sent in-line within the various Expression elements, and the codes can be listed directly as answerOption Codings.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-32,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-32,Payers needing full resources to be returned **SHOULD** use the [containedReference](StructureDefinition-containedReference.html) extension to indicate that the selected resource(s) for an answer of type reference should be included as [contained](https://hl7.org/fhir/R4/references.html#contained) resources within the QuestionnaireResponse.,SHOULD,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-33,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-33,Implementers that support Adaptive Questionnaires **SHOULD** always include a [coverage-information](https://build.fhir.org/ig/HL7/davinci-crd/StructureDefinition-ext-coverage-information.html) extension when the QuestionnaireResponse is deemed complete. (Future versions of this guide will likely tighten this expectation to a 'SHALL'),SHALL / SHOULD,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-34,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-34,The package returned by the [$questionnaire-package](OperationDefinition-questionnaire-package.html) operation **MAY** include Library and/or ValueSet instances that are not referenced by any of the returned questionnaires if at least one of those questionnaires is adaptive.,MAY,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-36,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-36,"When using adaptive forms, DTR servers **SHOULD** return as many items in a single call as possible (within reason), including questions that can be determined as enabled or disabled using simple 'enableWhen' logic.",SHOULD,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-38,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-38,Conformant systems **SHALL** meet these timing expectations at least 90% of the time.,SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-39,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-39,"In an adaptive Questionnaire with clinical or patient questions, systems that know that, after submitting the answers to the current unanswered questions, there will be no further questions targeted to patient or clinician, those systems **SHALL** provide a display item indicating that patient/clinical questions are complete.",SHALL,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-40,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-40,"Wherever possible, DTR services **SHOULD** leverage data retrieved from CRD and other mechanisms (claims data, PDex, etc.) to pre-populate answers in the QuestionnaireResponse returned to the client (regardless of whether the forms used are adaptive or standard).",SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-41,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-41,"If Adaptive Forms are being used, and a DTR service determines that prior authorization is both necessary and the requirements have been satisfied, then the final question in the form **SHALL** be a question that asks the user if they would like the prior authorization identifier to be issued, and indicate the appropriate response options.",SHALL,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-42,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-42,DTR Servers **SHALL NOT** provide a `satisfied-pa-id` in response to a DTR invocation that was triggered by a PAS request.,SHALL NOT,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-43,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-43,DTR payers **SHALL** ONLY use DTR adaptive forms to return a [coverage-information](https://build.fhir.org/ig/HL7/davinci-crd/StructureDefinition-ext-coverage-information.html) extension when:,SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-45,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-45,"If a payer receives a new invocation of an adaptive form for the same order, they **SHALL** treat the result of the new completion as replacing any previous completion from a prior coverage determination process.",SHALL,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-50,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-50,"In some cases, if there isn't specific data that can be retrieved computably from the EHR, it **MAY** be sufficient for a payer to merely have an attestation by the provider that certain documentation exists, that a certain patient condition exists, or that certain actions have been completed.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-51,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-51,Payers **SHOULD** design questionnaires to support attestation rather than discrete data where this is sufficient for the business requirements.,SHOULD,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-52,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-52,"Questionnaires **MAY** also support attaching reports or other supporting documentation (e.g., images, pathology reports, etc.) where providing question answers is not sufficient.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-53,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-53,Payers **SHOULD** use the `Questionnaire.effectivePeriod` element to describe the period over which the documentation templates and rules are valid.,SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-54,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-54,Questionnaires **SHALL** include logic that supports population from the EHR where possible.,SHALL,DTR Server,false,,,3.4.04,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_questionnaire_prepopulation
+hl7.fhir.us.davinci-dtr_2.2.0,spec-55,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-55,"Such logic **SHOULD** rely exclusively on data elements and search parameters defined either in US Core or [HRex](http://hl7.org/fhir/us/davinci-hrex/1.2.0/index.html) (including simple calculations there-on - e.g., age from birthdate).",SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-56,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-56,"Ideally, the design of questions in payer forms **SHOULD** consider what data is likely to be available for pre-population purposes, with an objective of minimizing provider data entry effort.",SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-57,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-57,"Due to differences in workflows or information systems, clinical information **MAY** be represented in different FHIR resources or with different codes or code systems.",MAY,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-58,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-58,"Therefore, payer CQL **MAY** have to examine different resources or use value sets to find patient information.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-61,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-61,DTR servers **SHOULD** identify inline expressions that are valid FHIRPath as FHIRPath rather than CQL.,SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-83,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-83,The table below is guidance that **SHOULD** be used when constructing questions with coded answers:,SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-85,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-85,"This CQL **MAY** query for patient observations, conditions, or other discrete information within the EHR to use as part of the population process or logic.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-86,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-86,"The mime type that **SHOULD** be used for a CQL Identifier is ""text/cql-identifier"" and CQL expressions embedded in the Questionnaire **SHOULD** use this type and reference CQL found in libraries rather than including CQL inline. (See supporting information [here](https://build.fhir.org/ig/HL7/cql/03-developersguide.html#identifiers))",SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-87,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-87,All [Libraries](http://hl7.org/fhir/R4/library.html) needed by a questionnaire **SHALL** be referenced by the [cqf-library](https://hl7.org/fhir/extensions/StructureDefinition-cqf-library.html) extension and included as part of the [$questionnaire-package](OperationDefinition-questionnaire-package.html) operation.,SHALL,DTR Server,false,,,3.4.05,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_cql_library_validation
+hl7.fhir.us.davinci-dtr_2.2.0,spec-88,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-88,"CQL logic **SHOULD** be partitioned to be specific to groups/questions/etc., when doing so will allow it to be more efficient - though consideration should also be given to whether performing significant data gathering at the outset (even if the data is unneeded) will produce a more positive experience than intermittent data retrieval 'on demand', when such retrieval **MAY** introduce user-interface delays.",SHOULD / MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-90,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-90,"When constructing this CQL for DTR, these statements **SHOULD** be nested in conditionals to first check if the patient has diabetes before checking for information dependent on that condition.",SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-91,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-91,"While CQL can either be embedded inline in Expression elements or packaged in [Libraries](http://hl7.org/fhir/R4/library.html), This guide strongly recommends that implementers **SHOULD** place CQL logic in libraries as it is much easier to edit and debug such logic when it is all in one place, rather than when it's scattered through many different expression elements throughout the Questionnaire.",SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-92,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-92,The CQL **SHALL** be compatible with version [CQL 1.5](http://cql.hl7.org/N1/).,SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-93,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-93,"CQL **SHALL** have a context of ""Patient"".",SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-94,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-94,"Within the Questionnaire, CQL **SHALL** follow SDC rules for determining [context](https://hl7.org/fhir/uv/sdc/STU3/populate.html).",SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-95,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-95,"Within [Libraries](http://hl7.org/fhir/R4/library.html), both raw CQL and compiled ELM (in JSON syntax – i.e., application/elm+json) **SHALL** be provided as separate content repetitions within the library.",SHALL,DTR Server,false,,,3.4.05,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_cql_library_validation
+hl7.fhir.us.davinci-dtr_2.2.0,spec-96,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-96,"Within Expression elements, the base expression CQL **SHALL** be accompanied by an [Alternative Expression Extension](StructureDefinition-alternativeExpression.html) containing the compiled JSON ELM for the expression.",SHALL,DTR Server,false,,,3.4.03,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_questionnaire_expression_elm
+hl7.fhir.us.davinci-dtr_2.2.0,spec-97,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-97,"If the Questionnaire depends on multiple [Libraries](http://hl7.org/fhir/R4/library.html) (has multiple [cqf-library](https://hl7.org/fhir/extensions/StructureDefinition-cqf-library.html) elements), then any [valueExpression](https://hl7.org/fhir/extensions/StructureDefinition-variable.html) referring to defined variables **SHALL** specify the library name as well as the statement name as follows: ""LibraryName"".statementName.",SHALL,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-98,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-98,"Library names **SHALL** be unique within a Questionnaire package and **SHOULD** be unique across all Libraries made available by the payer (e.g., ""expression"": ""LowerLimbProsthesis"".PhysicalExaminationType where LowerLimbProsthesis is the library name and PhysicalExaminationType is the expression name).",SHALL / SHOULD,DTR Server,false,,,3.4.05,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_cql_library_validation
+hl7.fhir.us.davinci-dtr_2.2.0,spec-99,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-99,FHIR [Libraries](http://hl7.org/fhir/R4/library.html) **SHALL** send CQL and ELM using the `content.data` element.,SHALL,DTR Server,false,,,3.4.05,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_cql_library_validation
+hl7.fhir.us.davinci-dtr_2.2.0,spec-106,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-106,Accessing the endpoint will be by a simple GET with an Accept header of application/json and **SHALL** be performed over TLS.,SHALL,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-115,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-115,Payer-provided Questionnaires **MAY** require access to a wide range of resources.,MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-116,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-116,"At a minimum, the DTR app and the HIT server **SHALL** support search access to the following resources via their FHIR RESTful API using the profiles defined by or referenced by this guide:",SHALL,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-120,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-120,Payers **SHALL** require DTR apps and EHRs connecting to their endpoint to authenticate using [SMART on FHIR Backend Services](https://www.hl7.org/fhir/smart-app-launch/backend-services.html).,SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-122,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-122,The `QuestionnaireResponse.questionnaire` **SHALL** point to the same canonical URL as the Questionnaire provided in the package Bundle.,SHALL,DTR Server,true,,,3.2.09,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_questionnaire_response_questionnaire_canonical
+hl7.fhir.us.davinci-dtr_2.2.0,spec-128,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-128,"DTR servers **SHALL** allow for the possibility of minor changes in the order between CRD and DTR (e.g., changes to status, adding notes, etc.) that mean that the instances don't have to be identical to be considered the same order.",SHALL,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-129,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-129,DTR servers **MAY** raise an error if they receive an order that is unrelated to the provided context id.,MAY,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-130,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-130,"If DTR is invoked and there are issues with the source data (e.g., the coverage cannot be found, the context id can't be found, etc.), then the DTR service **SHALL** return a 4xx error with an accompanying OperationOutcome.",SHALL,DTR Server,true,,,3.6.02,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_error_handling-dtr_v220_payer_source_data_error
+hl7.fhir.us.davinci-dtr_2.2.0,spec-133,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-133,"Implementers **SHOULD** review the advanced rendering, advanced behavior, population and adaptive forms portions of the SDC implementation guide, focusing on the elements and extensions included in the DTR profiles.",SHOULD,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-134,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-134,Implementers **SHOULD** also be familiar with the documentation about the Questionnaire and QuestionnaireResponse resources from the core FHIR specification.,SHOULD,"DTR Client,DTR Server",false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-139,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-139,All references within the QuestionnaireResponse **SHALL** only point to either contained resources or to resources that reside on the DTR client's FHIR endpoint.,SHALL,DTR Server,false,,,"3.2.10, 3.3.03","dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_questionnaire_response_references, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_next_question_support-dtr_v220_payer_next_question_response_references"
+hl7.fhir.us.davinci-dtr_2.2.0,spec-140,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-140,The only situation where a resource can be ['contained'](https://hl7.org/fhir/R4/references.html#contained) **SHALL** be if the contained instance is provided by the payer either:,SHALL,DTR Server,false,,,"3.2.11, 3.3.04","dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_contained_questionnaire_response_references, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_next_question_support-dtr_v220_payer_next_question_contained_response_references"
+hl7.fhir.us.davinci-dtr_2.2.0,spec-141,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-141,The only place ['contained'](https://hl7.org/fhir/R4/references.html#contained) resource references are permitted **SHALL** be in `item.answer` references.,SHALL,DTR Server,false,,,"3.2.11, 3.3.04","dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_package_support-dtr_v220_payer_contained_questionnaire_response_references, dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_next_question_support-dtr_v220_payer_next_question_contained_response_references"
+hl7.fhir.us.davinci-dtr_2.2.0,spec-147,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-147,"If [$next-question](OperationDefinition-DTR-Questionnaire-next-question.html) is invoked with a QuestionnaireResponse the payer determines is invalid based on the rules in the [contained](https://hl7.org/fhir/R4/references.html#contained) Questionnaire, it **SHALL** return an HTTP 400 error with an OperationOutcome indicating the circumstances where the QuestionnaireResponse is invalid.",SHALL,DTR Server,true,,,3.6.03,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_error_handling-dtr_v220_payer_invalid_questionnaire_response
+hl7.fhir.us.davinci-dtr_2.2.0,spec-148,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-148,"However, the QuestionnaireResponse **MAY** have a [coverage-information](https://build.fhir.org/ig/HL7/davinci-crd/StructureDefinition-ext-coverage-information.html) extension added reflecting the payer's coverage assessment based on the information gathered in the QuestionnaireResponse.",MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-159,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-159,"If the initial `QuestionnaireResponse` has multiple purposes (e.g., for prior authorization, claim submission, and performer transmission), the DTR server organization **SHALL** ensure that the full completed [QuestionnaireResponse package](StructureDefinition-DTR-QPackageBundle.html) is appropriate for all uses. If there is a need to send different information to different recipients for different purposes, the DTR server organization **SHALL** produce distinct Questionnaires such that QuestionnaireResponses only contain information that can be shared without redaction for their listed purposes.",SHALL,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-160,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-160,Such resources **SHALL** either be PDFs or XHTML pages that adhere to FHIR's ['safe' HTML rules](https://hl7.org/fhir/R4/security.html#narrative) (no active content or scripts),SHALL,DTR Server,true,,,3.4.06,dtr_payer_server_v220-dtr_payer_server_v220_questionnaire_operations-dtr_payer_v220_questionnaire_design-dtr_v220_payer_contained_binary
+hl7.fhir.us.davinci-dtr_2.2.0,spec-161,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-161,Some payers **MAY** require that attestations or other answers be 'signed' (the electronic equivalent of 'initialing' the answer).,MAY,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-164,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-164,"Payers SHOULD design their questionnaires, value sets, and libraries with the knowledge that content which is too large may cause DTR clients to fail.",SHOULD,DTR Server,false,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-165,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-165,Such contained Binary pages **SHALL NOT** point to other contained resources unless those resources are pointed to directly by other elements in the Questionnaire.,SHALL NOT,DTR Server,true,,,"",""
+hl7.fhir.us.davinci-dtr_2.2.0,spec-166,https://hl7.org/fhir/us/davinci-dtr/2.2.0/en/specification.html#ci-c-spec-166,"Implementers **MAY** embed images or other content using the 'data' mechanism, or may opt to combine multiple files into a single instance to eliminate the need for inter-linking.",MAY,DTR Server,true,,,"",""

data/lib/davinci_dtr_test_kit/requirements/generated/dtr_smart_app_requirements_coverage.csv

@@ -1,4 +1,4 @@
-Req Set,ID,URL,Requirement,Conformance,Actors,Conditionality,Not Tested Reason,Not Tested Details,Da Vinci DTR SMART App Test Suite Short ID(s),Da Vinci DTR SMART App Test Suite Full ID(s)
+Req Set,ID,URL,Requirement,Conformance,Actors,Conditionality,Not Tested Reason,Not Tested Details,Da Vinci DTR SMART App Test Suite v2.0.1 Short ID(s),Da Vinci DTR SMART App Test Suite v2.0.1 Full ID(s)
 hl7.fhir.us.davinci-dtr_2.0.1,3,https://hl7.org/fhir/us/davinci-dtr/STU2/specification.html#must-support,Da Vinci DTR [SMART Client] implementations **SHALL** conform to the US Core IG [Must Support](http://hl7.org/fhir/us/core/STU3.1.1/general-guidance.html#must-support) [Requestor] Guidance  where US Core IG resources are used.,SHALL,SMART Client,false,,,"",""
 hl7.fhir.us.davinci-dtr_2.0.1,4,https://hl7.org/fhir/us/davinci-dtr/STU2/specification.html#must-support,DTR apps and EHRs that take on DTR app responsibility **SHALL** be able to render Questionnaires,SHALL,"Full EHR,SMART Client",false,,,1.1.2.01,dtr_smart_app-dtr_smart_app_basic_workflows-dtr_smart_app_custom_static_workflow-dtr_smart_app_custom_static_rendering-dtr_rendering_attest
 hl7.fhir.us.davinci-dtr_2.0.1,5,https://hl7.org/fhir/us/davinci-dtr/STU2/specification.html#must-support,DTR apps and EHRs that take on DTR app responsibility **SHALL** be able to render ... QuestionnaireResponses.,SHALL,"Full EHR,SMART Client",false,,,"",""

data/lib/davinci_dtr_test_kit/{endpoints/mock_payer → server/endpoints}/next_question_proxy_endpoint.rb

@@ -1,3 +1,5 @@
+require_relative '../../tags'
+
 module DaVinciDTRTestKit
   module MockPayer
     class NextQuestionProxyEndpoint < Inferno::DSL::SuiteEndpoint

data/lib/davinci_dtr_test_kit/{endpoints/mock_payer → server/endpoints}/questionnaire_package_proxy_endpoint.rb

@@ -1,3 +1,5 @@
+require_relative '../../tags'
+
 module DaVinciDTRTestKit
   module MockPayer
     class QuestionnairePackageProxyEndpoint < Inferno::DSL::SuiteEndpoint

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/adaptive_form_libraries_test.rb

@@ -1,4 +1,5 @@
-require_relative '../cql_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormLibrariesTest < Inferno::Test
     include DaVinciDTRTestKit::CQLTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/adaptive_form_questionnaire_expressions_test.rb

@@ -1,4 +1,5 @@
-require_relative '../cql_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormExpressionsTest < Inferno::Test
     include DaVinciDTRTestKit::CQLTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/adaptive_form_questionnaire_extensions_test.rb

@@ -1,4 +1,5 @@
-require_relative '../cql_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormExtensionsTest < Inferno::Test
     include DaVinciDTRTestKit::CQLTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/adaptive_next_questionnaire_expressions_test.rb

@@ -1,4 +1,5 @@
-require_relative '../cql_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveNextQuestionExpressionsTest < Inferno::Test
     include DaVinciDTRTestKit::CQLTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/adaptive_next_questionnaire_extensions_test.rb

@@ -1,4 +1,5 @@
-require_relative '../cql_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveNexQuestionExtensionsTest < Inferno::Test
     include DaVinciDTRTestKit::CQLTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/payer_server_adaptive_request_test.rb

@@ -1,8 +1,9 @@
-require_relative '../urls'
+require_relative '../../../urls'
 
 module DaVinciDTRTestKit
   class AdaptiveFormTest < Inferno::Test
     include URLs
+
     title 'Confirm the client completes the DTR Adaptive Questionnaire work flow'
     description %(
       Inferno will wait for a DTR questionnaire package request from the client. Upon receipt, Inferno will generate and

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/payer_server_adaptive_request_validation_test.rb

@@ -1,8 +1,10 @@
-require_relative '../validation_test'
+require_relative '../../validation_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormRequestTest < Inferno::Test
     include URLs
     include DaVinciDTRTestKit::ValidationTest
+
     title 'User Input Validation: Questionnaire Package request is valid'
     description %(
       This test validates the conformance of the client's request to the

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/payer_server_adaptive_response_bundles_validation_test.rb

@@ -1,7 +1,9 @@
-require_relative '../validation_test'
+require_relative '../../validation_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormResponseBundlesTest < Inferno::Test
     include DaVinciDTRTestKit::ValidationTest
+
     id :payer_server_adaptive_response_bundles_validation_test
     title 'Validate that the adaptive response contains valid Questionnaire Bundle resources'
     description %(

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/payer_server_adaptive_response_search_validation_test.rb

@@ -1,7 +1,9 @@
-require_relative '../validation_test'
+require_relative '../../validation_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormResponseSearchTest < Inferno::Test
     include DaVinciDTRTestKit::ValidationTest
+
     id :payer_server_adaptive_response_search_validation_test
     title 'Validate that the adaptive response contains a valid Adaptive Form Search resource'
     description %(

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/payer_server_adaptive_response_validation_test.rb

@@ -1,9 +1,11 @@
-require_relative '../validation_test'
-require_relative '../cql_test'
+require_relative '../../validation_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormQuestionnaireResponseTest < Inferno::Test
     include DaVinciDTRTestKit::ValidationTest
     include DaVinciDTRTestKit::CQLTest
+
     id :payer_server_adaptive_response_validation_test
     title 'Validate that the adaptive response conforms to the DTR Questionnaire Package operation definition'
     # output :questionnaire_response

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/payer_server_next_request_validation_test.rb

@@ -1,8 +1,10 @@
-require_relative '../validation_test'
+require_relative '../../validation_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormNextRequestTest < Inferno::Test
     include URLs
     include DaVinciDTRTestKit::ValidationTest
+
     title 'User Input Validation:  Next Question request is valid'
     description %(
       This test validates the conformance of the client's request to the

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/adaptive_forms}/payer_server_next_response_validation_test.rb

@@ -1,7 +1,9 @@
-require_relative '../validation_test'
+require_relative '../../validation_test'
+
 module DaVinciDTRTestKit
   class PayerAdaptiveFormNextResponseTest < Inferno::Test
     include DaVinciDTRTestKit::ValidationTest
+
     id :payer_server_next_response_validation_test
     title 'Inferno sends payer server a request for subsequent adaptive forms - validate the responses'
     description %(

data/lib/davinci_dtr_test_kit/{dtr_payer_server_suite.rb → server/v2.0.1/dtr_payer_server_suite.rb}

@@ -1,19 +1,18 @@
-require_relative 'payer_server_groups/payer_server_static_group'
-require_relative 'payer_server_groups/payer_server_adaptive_group'
-require_relative 'tags'
-require_relative 'endpoints/cors'
-require_relative 'endpoints/mock_authorization/simple_token_endpoint'
-require_relative 'endpoints/mock_payer/questionnaire_package_proxy_endpoint'
-require_relative 'endpoints/mock_payer/next_question_proxy_endpoint'
-require_relative 'version'
+require_relative 'payer_server_static_group'
+require_relative 'payer_server_adaptive_group'
+require_relative '../../tags'
+require_relative '../../cross_suite/cors'
+require_relative '../endpoints/simple_token_endpoint'
+require_relative '../endpoints/questionnaire_package_proxy_endpoint'
+require_relative '../endpoints/next_question_proxy_endpoint'
 
 module DaVinciDTRTestKit
   class DTRPayerServerSuite < Inferno::TestSuite
     extend CORS
 
     id :dtr_payer_server
-    title 'Da Vinci DTR Payer Server Test Suite'
-    description File.read(File.join(__dir__, 'docs', 'dtr_payer_server_suite_description_v201.md'))
+    title 'Da Vinci DTR Payer Server Test Suite v2.0.1'
+    description File.read(File.join(__dir__, 'dtr_payer_server_suite_description_v201.md'))
 
     links [
       {
@@ -106,6 +105,10 @@ module DaVinciDTRTestKit
       exclude_message do |message|
         message.message.match?(/\A\S+: \S+: URL value '.*' does not resolve/)
       end
+
+      validation_context do
+        snomedCT '731000124108'
+      end
     end
 
     allow_cors QUESTIONNAIRE_PACKAGE_PATH, NEXT_PATH

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1}/payer_server_adaptive_group.rb

@@ -1,16 +1,16 @@
-require_relative 'payer_server_adaptive_request_test'
-require_relative 'payer_server_adaptive_request_validation_test'
-require_relative 'payer_server_adaptive_response_bundles_validation_test'
-require_relative 'payer_server_adaptive_response_search_validation_test'
-require_relative 'payer_server_adaptive_response_validation_test'
-require_relative 'payer_server_next_request_validation_test'
-require_relative 'payer_server_next_response_validation_test'
-require_relative 'payer_server_next_response_complete_test'
-require_relative 'adaptive_form_libraries_test'
-require_relative 'adaptive_form_questionnaire_extensions_test'
-require_relative 'adaptive_form_questionnaire_expressions_test'
-require_relative 'adaptive_next_questionnaire_extensions_test'
-require_relative 'adaptive_next_questionnaire_expressions_test'
+require_relative 'adaptive_forms/payer_server_adaptive_request_test'
+require_relative 'adaptive_forms/payer_server_adaptive_request_validation_test'
+require_relative 'adaptive_forms/payer_server_adaptive_response_bundles_validation_test'
+require_relative 'adaptive_forms/payer_server_adaptive_response_search_validation_test'
+require_relative 'adaptive_forms/payer_server_adaptive_response_validation_test'
+require_relative 'adaptive_forms/payer_server_next_request_validation_test'
+require_relative 'adaptive_forms/payer_server_next_response_validation_test'
+require_relative 'adaptive_forms/payer_server_next_response_complete_test'
+require_relative 'adaptive_forms/adaptive_form_libraries_test'
+require_relative 'adaptive_forms/adaptive_form_questionnaire_expressions_test'
+require_relative 'adaptive_forms/adaptive_form_questionnaire_extensions_test'
+require_relative 'adaptive_forms/adaptive_next_questionnaire_extensions_test'
+require_relative 'adaptive_forms/adaptive_next_questionnaire_expressions_test'
 
 module DaVinciDTRTestKit
   class DTRPayerServerAdaptiveQuestionnairePackageGroup < Inferno::TestGroup

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1}/payer_server_static_group.rb

@@ -1,9 +1,9 @@
-require_relative 'static_form_request_test'
-require_relative 'static_form_request_validation_test'
-require_relative 'static_form_response_validation_test'
-require_relative 'static_form_libraries_test'
-require_relative 'static_form_questionnaire_extensions_test'
-require_relative 'static_form_questionnaire_expressions_test'
+require_relative 'static_forms/static_form_request_test'
+require_relative 'static_forms/static_form_request_validation_test'
+require_relative 'static_forms/static_form_response_validation_test'
+require_relative 'static_forms/static_form_libraries_test'
+require_relative 'static_forms/static_form_questionnaire_extensions_test'
+require_relative 'static_forms/static_form_questionnaire_expressions_test'
 
 module DaVinciDTRTestKit
   class DTRPayerServerQuestionnairePackageGroup < Inferno::TestGroup

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/static_forms}/static_form_libraries_test.rb

@@ -1,4 +1,5 @@
-require_relative '../cql_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerStaticFormLibrariesTest < Inferno::Test
     include DaVinciDTRTestKit::CQLTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/static_forms}/static_form_questionnaire_expressions_test.rb

@@ -1,4 +1,5 @@
-require_relative '../cql_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerStaticFormExpressionsTest < Inferno::Test
     include DaVinciDTRTestKit::CQLTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/static_forms}/static_form_questionnaire_extensions_test.rb

@@ -1,4 +1,5 @@
-require_relative '../cql_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerStaticFormExtensionsTest < Inferno::Test
     include DaVinciDTRTestKit::CQLTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/static_forms}/static_form_request_test.rb

@@ -1,8 +1,10 @@
-require_relative '../urls'
-require_relative '../validation_test'
+require_relative '../../../urls'
+require_relative '../../validation_test'
+
 module DaVinciDTRTestKit
   class StaticRFormRequestTest < Inferno::Test
     include URLs
+
     title 'Validate the questionnaires returned by the payer server'
     description %(
       Inferno will validate questionnaires returned by the payer server.

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/static_forms}/static_form_request_validation_test.rb

@@ -1,5 +1,6 @@
-require_relative '../urls'
-require_relative '../validation_test'
+require_relative '../../../urls'
+require_relative '../../validation_test'
+
 module DaVinciDTRTestKit
   class PayerStaticFormRequestValidationTest < Inferno::Test
     include DaVinciDTRTestKit::ValidationTest

data/lib/davinci_dtr_test_kit/{payer_server_groups → server/v2.0.1/static_forms}/static_form_response_validation_test.rb

@@ -1,11 +1,13 @@
-require_relative '../urls'
-require_relative '../validation_test'
-require_relative '../cql_test'
+require_relative '../../../urls'
+require_relative '../../validation_test'
+require_relative '../../../cross_suite/v2.0.1/cql_test'
+
 module DaVinciDTRTestKit
   class PayerStaticFormResponseTest < Inferno::Test
     include URLs
     include DaVinciDTRTestKit::ValidationTest
     include DaVinciDTRTestKit::CQLTest
+
     id :dtr_v201_payer_static_form_response_test
     title 'Validate that the static response conforms to the DTR Questionnaire Package operation definition.'
     description %(