davinci_pas_test_kit 0.15.0 → 0.15.2

data/lib/davinci_pas_test_kit/server/v2.2.1/claim_inquiry/server_claim_inquiry_response_tests.rb

@@ -0,0 +1,89 @@
+require_relative '../../../parameters_helper'
+require_relative '../../../cross_suite/pas_constants'
+require_relative '../../../cross_suite/tags'
+
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    module ServerClaimInquiryResponseValidation
+      include ParametersHelper
+
+      def inquiry_response_requests
+        load_tagged_requests(INQUIRE_TAG)
+      end
+
+      def response_bundles
+        inquiry_response_requests.flat_map do |request|
+          parsed_resource = parsed_response_resource(request)
+          next [] unless parsed_resource.is_a?(FHIR::Parameters)
+
+          extract_bundles_from_pas_inquiry_response_parameters(parsed_resource)
+        end
+      end
+
+      def parsed_response_resource(request)
+        return if request&.response_body.blank?
+
+        FHIR.from_contents(request.response_body)
+      rescue StandardError
+        nil
+      end
+
+      def claim_inquiry_responses
+        response_bundles.flat_map { |bundle| Array(bundle.entry).filter_map { |entry| entry&.resource } }
+          .grep(FHIR::ClaimResponse)
+      end
+
+      def claim_reference?(claim_response)
+        claim_response.request&.reference.present?
+      end
+
+      def data_absent_reason?(claim_response)
+        Array(claim_response.request&.extension).any? do |extension|
+          extension.url == PASConstants::DATA_ABSENT_REASON_EXTENSION_URL && extension.valueCode.present?
+        end
+      end
+
+      def claim_reference_or_data_absent_reason?(claim_response)
+        claim_reference?(claim_response) || data_absent_reason?(claim_response)
+      end
+
+      def claim_response_label(claim_response, index)
+        claim_response.id.present? ? "ClaimResponse/#{claim_response.id}" : "ClaimResponse at index #{index + 1}"
+      end
+    end
+
+    class PASServerClaimInquiryResponseClaimReferenceTest < Inferno::Test
+      include ServerClaimInquiryResponseValidation
+
+      id :pas_server_v221_claim_inquiry_response_claim_reference_test
+      title 'Server returns Claim Inquiry Responses with a Claim reference or Data Absent Reason'
+      description %(
+        The PAS IG [requires](https://hl7.org/fhir/us/davinci-pas/2.2.1/en/conformancedetails.html#ci-c-spec-44)
+        each Claim Inquiry Response to either reference the Claim that triggered adjudication or carry
+        a Data Absent Reason extension explaining why the Claim cannot be referenced.
+
+        This test examines ClaimResponse resources returned by prior `$inquire` requests and verifies that
+        each one includes either `ClaimResponse.request.reference` or the
+        `data-absent-reason` extension on `ClaimResponse.request`.
+      )
+      verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@spec-44'
+
+      run do
+        claim_responses = claim_inquiry_responses
+        skip_if claim_responses.empty?,
+                'No Claim Inquiry Response ClaimResponse resources were returned by prior $inquire requests.'
+
+        nonconformant = claim_responses.each_with_index.filter_map do |claim_response, index|
+          next if claim_reference_or_data_absent_reason?(claim_response)
+
+          claim_response_label(claim_response, index)
+        end
+
+        assert nonconformant.empty?,
+               'The following Claim Inquiry Response resources did not include either ' \
+               '`ClaimResponse.request.reference` or a Data Absent Reason extension on ' \
+               "`ClaimResponse.request`: #{nonconformant.join(', ')}."
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/v2.2.1/pas_error_group.rb

@@ -13,6 +13,8 @@ module DaVinciPASTestKit
       id :pas_v221_error_group
       run_as_group
 
+      verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@spec-39'
+
       test from: :pas_server_v221_prior_auth_submission_error
       test from: :pas_server_v221_prior_auth_inquiry_error
     end

data/lib/davinci_pas_test_kit/server/v2.2.1/pas_server_claim_inquiry_responses_group.rb

@@ -0,0 +1,17 @@
+require_relative 'claim_inquiry/server_claim_inquiry_response_tests'
+
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    class PASServerClaimInquiryResponsesGroup < Inferno::TestGroup
+      id :pas_server_v221_claim_inquiry_responses
+      title 'Additional $inquire Response Requirements'
+      description %(
+        Verify additional PAS Claim Inquiry Response rules against the ClaimResponse resources returned
+        by prior `$inquire` interactions. This group uses the inquiry responses already collected during
+        the server suite, including the Must Support inquiry workflow.
+      )
+
+      test from: :pas_server_v221_claim_inquiry_response_claim_reference_test
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/v2.2.1/pas_server_no_custom_extensions_test.rb

@@ -0,0 +1,241 @@
+require_relative '../../cross_suite/tags'
+
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    class PasNoCustomExtensionsTest < Inferno::Test
+      US_CORE_EXTENSION_URLS = [
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-birthsex',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-direct',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-race',
+        'http://hl7.org/fhir/us/core/StructureDefinition/uscdi-requirement',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-extension-questionnaire-uri',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-genderIdentity',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-jurisdiction',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-sex',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-tribal-affiliation',
+        'http://hl7.org/fhir/us/core/StructureDefinition/us-core-medication-adherence',
+        'http://hl7.org/fhir/StructureDefinition/condition-assertedDate'
+      ].freeze
+
+      CRD_EXTENSION_URLS = [
+        'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/ext-coverage-information',
+        'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/ext-billing-options',
+        'http://hl7.org/fhir/us/davinci-crd/StructureDefinition/ext-request-category',
+        'http://hl7.org/fhir/StructureDefinition/codeOptions',
+        'http://hl7.org/fhir/StructureDefinition/alternate-reference',
+        'http://hl7.org/fhir/5.0/StructureDefinition/extension-CommunicationRequest.payload.content',
+        'http://hl7.org/fhir/5.0/StructureDefinition/extension-Task.requestedPeriod',
+        'http://hl7.org/fhir/5.0/StructureDefinition/extension-Task.requestedPerformer',
+        'http://hl7.org/fhir/5.0/StructureDefinition/extension-Task.performer',
+        'http://hl7.org/fhir/StructureDefinition/request-doNotPerform',
+        'http://hl7.org/fhir/5.0/StructureDefinition/extension-Task.input.value',
+        'http://hl7.org/fhir/5.0/StructureDefinition/extension-Task.output.value',
+        'http://hl7.org/fhir/5.0/StructureDefinition/extension-Task.statusReason'
+      ].freeze
+
+      HREX_EXTENSION_URLS = [
+        'http://hl7.org/fhir/us/davinci-hrex/StructureDefinition/extension-CoverageDavinciWellknownLocation'
+      ].freeze
+
+      DTR_EXTENSION_URLS = [
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/activeRole',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/alternativeExpression',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/containedReference',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/information-origin',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/intendedUse',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/qr-context',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/estimated-completion-time',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/questionnaireAudience',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/qr-coverage',
+        'http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/request-specific'
+      ].freeze
+
+      PAS_EXTENSION_URLS = [
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-TransmissionIdentifiers',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-administrationReferenceNumber',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-admissionDates',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-authorizationNumber',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-authorizedProviderType',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-careTeamClaimScope',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-certificationType',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-claimResponseReviewer',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-communicatedDiagnosis',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-conditionCode',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-contentModifier',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-diagnosisRecordedDate',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-dischargeDate',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-documentInformation',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-epsdtIndicator',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-errorElement',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-errorFollowupAction',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-errorPath',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-homeHealthCareInformation',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-identifierJurisdiction',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-identifierSubDepartment',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-infoChanged',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemAuthorizedDetail',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemAuthorizedProvider',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemCategory',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemCertificationEffectiveDate',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemCertificationExpirationDate',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemCertificationIssueDate',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemPreAuthIssueDate',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemPreAuthPeriod',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemRequestedServiceDate',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-itemTraceNumber',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-levelOfServiceCode',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-militaryStatus',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-nursingHomeLevelOfCare',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-nursingHomeResidentialStatus',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-patientStatus',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-productOrServiceCodeEnd',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-requestedService',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-revenueCode',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-revenueUnitRateLimit',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-reviewAction',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-reviewActionCode',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-serviceItemRequestType',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-serviceLineNumber',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-timingcalendarpattern',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-timingdeliverypattern',
+        'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/modifierextension-infoCancelled',
+        'http://hl7.org/fhir/5.0/StructureDefinition/extension-Claim.encounter',
+        'http://hl7.org/fhir/StructureDefinition/data-absent-reason',
+        'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-filter-criteria',
+        'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-heartbeat-period',
+        'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-timeout',
+        'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-max-count',
+        'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-channel-type',
+        'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-payload-content',
+        'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/capabilitystatement-subscriptiontopic-canonical'
+      ].freeze
+
+      SDC_EXTENSION_URLS = [
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-answerExpression',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-answerOptionsToggleExpression',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-assemble-expectation',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-assembleContext',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-assembleDefinitionRoot',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-assembledFrom',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-calculatedExpression',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-candidateExpression',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-choiceColumn',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-collapsible',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-columnCount',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-contextExpression',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-definitionExtract',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-definitionExtractValue',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-enableWhenExpression',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-endpoint',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-entryMode',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-extractAllocateId',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-initialExpression',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-isSubject',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-itemAnswerMedia',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-itemExtractionContext',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-itemMedia',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-itemPopulationContext',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-keyboard',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-launchContext',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-lookupQuestionnaire',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-maxQuantity',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-minQuantity',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observation-extract-category',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtractEntry',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationLinkPeriod',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-openLabel',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-optionalDisplay',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-performerType',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-preferredTerminologyServer',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-questionnaireAdaptive',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-shortText',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-sourceQueries',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-sourceStructureMap',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-subQuestionnaire',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-targetStructureMap',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-templateExtract',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-templateExtractBundle',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-templateExtractContext',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-templateExtractValue',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-unitOpen',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-unitSupplementalSystem',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-width',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse-isSubject',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-rendering-criticalExtension',
+        'http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-servicerequest-questionnaire'
+      ].freeze
+
+      VALID_EXTENSION_URLS = (US_CORE_EXTENSION_URLS + CRD_EXTENSION_URLS + HREX_EXTENSION_URLS \
+        + SDC_EXTENSION_URLS + DTR_EXTENSION_URLS + PAS_EXTENSION_URLS).freeze
+
+      id :pas_server_v221_no_custom_extensions_test
+      title 'Server processes $submit without custom extensions'
+      description %(
+        This test verifies that the server is capable of responding to a client
+        without the use of any custom extensions. It inspects each successful
+        PAS submission, and if it finds one which doesn't use any extensions
+        not defined by FHIR, US Core, PAS, CRD, DTR, or HRex it passes.
+      )
+
+      verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@conf-11'
+
+      run do
+        requests = load_tagged_requests(SUBMIT_TAG)
+        skip_if requests.blank?, 'No requests were made in a previous test as expected.'
+
+        successful_requests = requests.select { |request| request.status == 200 }
+        skip_if successful_requests.empty?, 'All service requests were unsuccessful.'
+
+        bundles = successful_requests.filter_map { |request| bundle_from_request(request) }
+        skip_if bundles.empty?, 'No PAS Request Bundles were found in successful submissions.'
+
+        request_with_no_custom_extensions = bundles.any? { |bundle| no_custom_extensions?(bundle) }
+
+        pass_if request_with_no_custom_extensions
+
+        custom_extensions_string =
+          bundles
+            .flat_map { |bundle| custom_extensions(bundle) }
+            .uniq
+            .map { |extension| "\n- `#{extension}`" }
+            .join
+
+        skip 'No requests were made without custom extensions. The following custom extensions were found: ' \
+             "#{custom_extensions_string}"
+      end
+
+      def bundle_from_request(request)
+        resource = FHIR.from_contents(request.request_body)
+        resource if resource.is_a?(FHIR::Bundle)
+      rescue JSON::ParserError
+        nil
+      end
+
+      def no_custom_extensions?(bundle)
+        bundle.each_element do |value, _metadata, path|
+          next unless value.is_a?(FHIR::Extension)
+
+          next if path.to_s.scan('extension').length > 1
+
+          return false unless VALID_EXTENSION_URLS.include?(value.url.to_s)
+        end
+
+        true
+      end
+
+      def custom_extensions(bundle)
+        [].tap do |custom_extensions|
+          bundle.each_element do |value, _metadata, path|
+            next unless value.is_a?(FHIR::Extension)
+
+            next if path.to_s.scan('extension').length > 1
+
+            custom_extensions << value.url.to_s unless VALID_EXTENSION_URLS.include?(value.url.to_s)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/v2.2.1/pas_server_subscription_capability_statement_test.rb

@@ -0,0 +1,40 @@
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    class PASServerSubscriptionCapabilityStatementTest < Inferno::Test
+      id :pas_server_v221_subscription_capability_statement_test
+      title 'Server Capability Statement declares Subscription create, update, and delete support'
+      description %(
+          The PAS IG [requires](https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-55)
+          servers that support subscriptions to expose that support in their CapabilityStatement. This test retrieves
+          the CapabilityStatement and verifies that its server-mode Subscription resource declares the create, update,
+          and delete interactions.
+        )
+
+      verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@spec-55'
+
+      REQUIRED_INTERACTIONS = ['create', 'update', 'delete'].freeze
+
+      run do
+        fhir_get_capability_statement
+
+        assert_response_status(200)
+        assert_resource_type(:capability_statement)
+        assert_valid_resource
+
+        server_rest = resource.rest.find { |rest| rest.mode == 'server' }
+        assert server_rest.present?, 'CapabilityStatement is missing a `rest` entry with `mode` set to `server`.'
+
+        subscription_resource = server_rest.resource.find { |entry| entry.type == 'Subscription' }
+        assert subscription_resource.present?,
+               'CapabilityStatement is missing a `Subscription` resource entry in its server-mode `rest` section.'
+
+        supported_interactions = subscription_resource.interaction.map(&:code)
+
+        missing_interactions = REQUIRED_INTERACTIONS - supported_interactions
+
+        assert missing_interactions.empty?,
+               "Missing interactions in the subscription: #{missing_interactions.join(', ')}"
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/v2.2.1/pas_server_subscription_setup.rb

@@ -1,4 +1,5 @@
 require 'subscriptions_test_kit'
+require_relative 'pas_server_subscription_capability_statement_test'
 require_relative 'pas_server_subscription_input_conformance'
 
 module DaVinciPASTestKit
@@ -15,6 +16,8 @@ module DaVinciPASTestKit
       input_order :server_endpoint, :smart_credentials, :access_token, :subscription_resource
       run_as_group
 
+      test from: :pas_server_v221_subscription_capability_statement_test
+
       test from: :pas_server_v221_subscription_input_conformance do
         input :subscription_resource,
               title: 'Pended Prior Authorization Subscription',
@@ -26,15 +29,17 @@ module DaVinciPASTestKit
                      modify the Subscription before submission, e.g., to point to Inferno's notification endpoint.
                    )
       end
-      test from: :subscriptions_r4_server_notification_delivery,
-           title: 'Send Subscription and Receive Handshake Notification from Server',
-           description: %(
-               This test sends a request to create the Subscription resource to the Subscriptions Backport FHIR Server.
-               If successful, it then waits for a handshake
-               [notification](https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/notifications.html#notifications).
-               Other types of notifications, including heartbeat and event notifications, will be accepted by Inferno
-               but ignored by this test group.
-             )
+      test from: :subscriptions_r4_server_notification_delivery do
+        title 'Send Subscription and Receive Handshake Notification from Server'
+        description %(
+            This test sends a request to create the Subscription resource to the Subscriptions Backport FHIR Server.
+            If successful, it then waits for a handshake
+            [notification](https://hl7.org/fhir/uv/subscriptions-backport/STU1.1/notifications.html#notifications).
+            Other types of notifications, including heartbeat and event notifications, will be accepted by Inferno
+            but ignored by this test group.
+          )
+        verifies_requirements(*(verifies_requirements + ['hl7.fhir.us.davinci-pas_2.2.1@spec-54']))
+      end
       test from: :subscriptions_r4_server_creation_response_conformance
       test from: :subscriptions_r4_server_handshake_conformance
     end

data/lib/davinci_pas_test_kit/server/v2.2.1/server_replaced_pa_inquire_reference_input_test.rb

@@ -0,0 +1,63 @@
+require_relative '../../cross_suite/pas_constants'
+
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    class PASServerReplacedPAInquireReferenceInputTest < Inferno::Test
+      include PASConstants
+
+      id :pas_server_v221_replaced_pa_inquire_reference_input_test
+      title 'Provided $inquire Request contains a replaced prior authorization reference'
+      description %(
+        Provide one or more PAS Inquiry Request Bundles, at least one of which contains
+        an authorization number or administration reference number.
+      )
+
+      simulation_verification
+
+      input :must_support_pa_inquire_request_payload,
+            title: 'Additional $inquire Request Payloads',
+            description: 'Insert an additional request bundle or a list of bundles (e.g. [bundle_1, bundle_2])'
+
+      run do
+        skip_if must_support_pa_inquire_request_payload.blank?,
+                'No inquiry request body was provided.'
+
+        assert_valid_json(
+          must_support_pa_inquire_request_payload,
+          'Provide a valid JSON PAS Inquiry Request Bundle.'
+        )
+
+        parsed_payload = JSON.parse(must_support_pa_inquire_request_payload)
+        request_payloads = Array.wrap(parsed_payload)
+
+        assert request_payloads.present?,
+               'No inquiry Request Bundles were provided.'
+
+        request_bundles = request_payloads.map do |request_payload|
+          FHIR.from_contents(request_payload.to_json)
+        end
+
+        assert request_bundles.all?(FHIR::Bundle),
+               'Each inquiry request body must be a FHIR Bundle.'
+
+        assert request_bundles.any? { |request_bundle| reference_numbers(request_bundle).present? },
+               'The inquiry requests did not contain an authorization number or ' \
+               'administration reference number.'
+      end
+
+      def reference_numbers(bundle)
+        bundle.entry.flat_map do |entry|
+          resource = entry.resource
+          next [] unless resource.respond_to?(:item)
+
+          resource.item.flat_map do |item|
+            item.extension.filter_map do |extension|
+              extension.valueString if REFERENCE_NUMBER_EXTENSIONS.value?(extension.url) &&
+                                       extension.valueString.present?
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/server/v2.2.1/server_replaced_pa_inquire_reference_test.rb

@@ -0,0 +1,109 @@
+require_relative '../../parameters_helper'
+require_relative '../../cross_suite/pas_constants'
+
+module DaVinciPASTestKit
+  module DaVinciPASV221
+    class PASServerReplacedPAInquireReferenceTest < Inferno::Test
+      include ParametersHelper
+      include PASConstants
+
+      id :pas_server_v221_replaced_pa_inquire_reference_test
+      title 'Server returns a different reference number for a replaced prior authorization'
+      description %(
+        This test submits a tester provided Request Bundle containing a
+        reference number. The request should result in a response that returns a
+        different reference number, indicating that the original prior authorization
+        has been replaced.
+      )
+
+      verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@spec-47'
+
+      makes_request :pa_inquire_request
+
+      input :must_support_pa_inquire_request_payload,
+            title: 'Additional $inquire Request Payloads',
+            description: 'Insert an additional request bundle or a list of bundles (e.g. [bundle_1, bundle_2])'
+
+      run do
+        skip_if must_support_pa_inquire_request_payload.blank?,
+                'No inquiry request body was provided.'
+
+        assert_valid_json(
+          must_support_pa_inquire_request_payload,
+          'Provide a valid JSON PAS Inquiry Request Bundle.'
+        )
+        parsed_payload = JSON.parse(must_support_pa_inquire_request_payload)
+        request_payloads = Array.wrap(parsed_payload)
+
+        reference_comparisons = request_payloads.map do |request_payload|
+          request_resource = FHIR.from_contents(request_payload.to_json)
+
+          submitted_references = extract_references([request_resource])
+
+          fhir_operation(
+            '/Claim/$inquire',
+            body: request_resource,
+            name: :pa_inquire_request
+          )
+
+          assert_response_status(200)
+
+          response_bundles =
+            if resource.is_a?(FHIR::Parameters)
+              extract_bundles_from_pas_inquiry_response_parameters(resource)
+            elsif resource.is_a?(FHIR::Bundle)
+              [resource]
+            else
+              assert false, '$inquire response is neither Parameters or Bundle'
+            end
+
+          assert response_bundles.any?,
+                 'The $inquire response did not contain a response Bundle.'
+
+          returned_references = extract_references(response_bundles)
+
+          different_reference?(submitted_references, returned_references)
+        end
+
+        assert reference_comparisons.any?,
+               'Expected an inquiry response to contain a different authorization number or ' \
+               'administration reference number, but it did not.'
+      end
+
+      def extract_references(bundles)
+        bundles.each_with_object(
+          Hash.new { |hash, url| hash[url] = [] }
+        ) do |bundle, references|
+          next unless bundle.is_a?(FHIR::Bundle)
+
+          bundle.entry.each do |entry|
+            resource = entry.resource
+            next unless resource.respond_to?(:item)
+
+            resource.item.each do |item|
+              item.extension.each do |extension|
+                next unless REFERENCE_NUMBER_EXTENSIONS.value?(extension.url)
+                next if extension.valueString.blank?
+
+                references[extension.url] << extension.valueString
+              end
+            end
+          end
+        end
+      end
+
+      def different_reference?(submitted, returned)
+        REFERENCE_NUMBER_EXTENSIONS.each_value.any? do |extension_url|
+          submitted_values = submitted[extension_url]
+          returned_values = returned[extension_url]
+
+          next false if submitted_values.empty? || returned_values.empty?
+
+          returned_values.any? do |returned_value|
+            submitted_values.exclude?(returned_value)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module DaVinciPASTestKit
-  VERSION = '0.15.0'
-  LAST_UPDATED = '2025-07-13'
+  VERSION = '0.15.2'
+  LAST_UPDATED = '2026-09-08'
 end