davinci_pas_test_kit 0.9.0

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_approval_submit_test.rb

@@ -0,0 +1,38 @@
+require_relative '../../../urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientApprovalSubmitTest < Inferno::Test
+      include URLs
+
+      id :pas_client_v201_approval_submit_test
+      title 'Client submits a claim using the $submit operation'
+      description %(
+        Inferno will wait for a prior authorization submission request
+        from the client. Upon receipt, Inferno will generate and send a
+        response with an approved status.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+
+      run do
+        wait(
+          identifier: access_token,
+          message: %(
+            **Approval Workflow Test**:
+
+            Submit a PAS request to
+
+            `#{submit_url}`
+
+            An approved response generated by Inferno will be returned.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_denial_submit_response_attest.rb

@@ -0,0 +1,38 @@
+require_relative '../../../urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientDenialSubmitResponseAttest < Inferno::Test
+      include URLs
+
+      id :pas_client_v201_denial_submit_response_attest
+      title 'Check that the client registers the request as denied (Attestation)'
+      description %(
+        This test provides the tester an opportunity to observe their client following
+        the receipt of the denied response and attest that users are able to determine
+        that the response has been denied.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+
+      run do
+        wait(
+          identifier: access_token,
+          message: %(
+            **Denial Workflow Test**:
+
+            I attest that the client system displays the submitted claim as 'denied'.
+
+            [Click here](#{resume_pass_url}?token=#{access_token}) if the above statement is true.
+
+            [Click here](#{resume_fail_url}?token=#{access_token}) if the above statement is false.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_denial_submit_test.rb

@@ -0,0 +1,43 @@
+require_relative '../../../urls'
+require_relative '../../../user_input_response'
+require_relative '../../../pas_bundle_validation'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientDenialSubmitTest < Inferno::Test
+      include URLs
+      include UserInputResponse
+      include PasBundleValidation
+
+      id :pas_client_v201_denial_submit_test
+      title 'Client submits a claim using the $submit operation'
+      description %(
+        Inferno will wait for a prior authorization submission request
+        from the client. Upon receipt, Inferno will respond with the
+        provided denial response.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+
+      run do
+        check_user_inputted_response :denial_json_response
+        wait(
+          identifier: access_token,
+          message: %(
+            **Denial Workflow Test**:
+
+            Submit a PAS request to
+
+            `#{submit_url}`
+
+            The denial response provided in the '**#{input_title(:denial_json_response)}**' input will be returned.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_inquire_must_support_test.rb

@@ -0,0 +1,51 @@
+require_relative '../../../urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientInquireMustSupportTest < Inferno::Test
+      include URLs
+
+      id :pas_client_inquire_v201_must_support_test
+      title 'Client inquires about claims using the $inquire operation to demonstrate coverage of must support elements'
+      description %(
+        This test allows the client to send $inquire requests in addition to any already sent in previous test groups
+        for Inferno to evaluate coverage of must support elements.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+      config options: { accepts_multiple_requests: true }
+
+      run do
+        wait(
+          identifier: access_token,
+          message: %(
+            The client system may now make multiple $inquire requests before continuing. These requests should
+            cumulatively demonstrate coverage of all required profiles and all must support elements within those
+            profiles, as specified by the DaVince Prior Authorization Support implementation guide.
+
+            For the $inquire operation the required profiles include:
+            - PAS Inquiry Request Bundle
+            - PAS Claim Inquiry
+            - PAS Coverage
+            - PAS Beneficiary Patient
+            - PAS Subscriber Patient
+            - PAS Insurer Organization
+            - PAS Requestor Organization
+            - PAS Practitioner
+            - PAS PractitionerRole
+
+            Submit PAS requests to
+
+            `#{inquire_url}`
+
+            and [click here](#{resume_pass_url}?token=#{access_token}) when done.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_pended_inquire_response_attest.rb

@@ -0,0 +1,39 @@
+require_relative '../../../urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientPendedInquireResponseAttest < Inferno::Test
+      include URLs
+
+      id :pas_client_v201_pended_inquire_response_attest
+      title 'Check that the client registers the request as approved (Attestation)'
+      description %(
+        This test provides the tester an opportunity to observe their client following
+        the receipt of the inquiry response with a final decision and attest that users
+        are able to determine that the response has been approved in full.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+
+      run do
+        wait(
+          identifier: access_token,
+          message: %(
+            **Pended Workflow Test**:
+
+            I attest that the client system displays the submitted claim as 'approved' meaning that
+            the user can proceed with ordering or providing the requested service.
+
+            [Click here](#{resume_pass_url}?token=#{access_token}) if the above statement is **true**.
+
+            [Click here](#{resume_fail_url}?token=#{access_token}) if the above statement is **false**.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_pended_inquire_test.rb

@@ -0,0 +1,35 @@
+require_relative '../../../urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientPendedInquireTest < Inferno::Test
+      include URLs
+
+      id :pas_client_v201_pended_inquire_test
+      title 'Client inquires about a pended claim using the $inquire operation'
+      description %(
+        Inferno will wait for a prior authorization inquiry request
+        from the client. Upon receipt, Inferno will generate a response
+        with an approved status and respond with it.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+
+      run do
+        wait(
+          identifier: access_token,
+          message: %(
+            **Pended Workflow Test**:
+
+            Submit a PAS claim inquiry request for the pended prior authorization request to `#{inquire_url}`.
+            An approval response generated by Inferno will be returned.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_pended_submit_response_attest.rb

@@ -0,0 +1,39 @@
+require_relative '../../../urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientPendedSubmitResponseAttest < Inferno::Test
+      include URLs
+
+      id :pas_client_v201_pended_submit_response_attest
+      title 'Check that the client registers the request as pended (Attestation)'
+      description %(
+        This test provides the tester an opportunity to observe their client following
+        the receipt of the pended response and attest that users are able to determine
+        that the response has been pended and a decision will be forth coming.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+
+      run do
+        wait(
+          identifier: access_token,
+          message: %(
+            **Pended Workflow Test**:
+
+            I attest that the client system displays the submitted claim as 'pended' meaning that
+            a final decision has not yet been made.
+
+            [Click here](#{resume_pass_url}?token=#{access_token}) if the above statement is **true**.
+
+            [Click here](#{resume_fail_url}?token=#{access_token}) if the above statement is **false**.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_pended_submit_test.rb

@@ -0,0 +1,43 @@
+require_relative '../../../urls'
+require_relative '../../../user_input_response'
+require_relative '../../../pas_bundle_validation'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientPendedSubmitTest < Inferno::Test
+      include URLs
+      include UserInputResponse
+      include PasBundleValidation
+
+      id :pas_client_v201_pended_submit_test
+      title 'Client submits a claim using the $submit operation'
+      description %(
+        Inferno will wait for a prior authorization submission request
+        from the client. Upon receipt, Inferno will respond with the
+        provided pended response.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+
+      run do
+        check_user_inputted_response :pended_json_response
+        wait(
+          identifier: access_token,
+          message: %(
+            **Pended Workflow Test**:
+
+            Submit a PAS request to
+
+            `#{submit_url}`
+
+            The pended response provided in the '**#{input_title(:pended_json_response)}**' input will be returned.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_submit_must_support_test.rb

@@ -0,0 +1,57 @@
+require_relative '../../../urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientSubmitMustSupportTest < Inferno::Test
+      include URLs
+
+      id :pas_client_submit_v201_must_support_test
+      title 'Client submits claims using the $submit operation to demonstrate coverage of must support elements'
+      description %(
+        This test allows the client to send $submit requests in addition to any already sent in previous test groups
+        for Inferno to evaluate coverage of must support elements.
+      )
+      input :access_token,
+            title: 'Access Token',
+            description: %(
+              Access token that the client will provide in the Authorization header of each request
+              made during this test.
+            )
+      config options: { accepts_multiple_requests: true }
+
+      run do
+        wait(
+          identifier: access_token,
+          message: %(
+            The client system may now make multiple $submit requests before continuing. These requests should
+            cumulatively demonstrate coverage of all required profiles and all must support elements within those
+            profiles, as specified by the DaVince Prior Authorization Support implementation guide.
+
+            For the $submit operation the required profiles include:
+            - PAS Request Bundle
+            - PAS Claim Update
+            - PAS Coverage
+            - PAS Beneficiary Patient
+            - PAS Subscriber Patient
+            - PAS Insurer Organization
+            - PAS Requestor Organization
+            - PAS Practitioner
+            - PAS PractitionerRole
+            - PAS Encounter
+            - At least one of the following request profiles
+              - PAS Device Request
+              - PAS Medication Request
+              - PAS Nutrition Order
+              - PAS Service Request
+
+            Submit PAS requests to
+
+            `#{submit_url}`
+
+            and [click here](#{resume_pass_url}?token=#{access_token}) when done.
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_token_request_test.rb

@@ -0,0 +1,31 @@
+require_relative '../../../urls'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientTokenRequestTest < Inferno::Test
+      include URLs
+
+      id :pas_client_v201_token_request_test
+      title 'Client makes token request'
+      description %(
+        Inferno will wait for the client to make a token request.
+      )
+      input :client_id,
+            title: 'Client ID',
+            description: %(
+              Client ID that the client will use to request an access token.
+            )
+
+      run do
+        wait(
+          identifier: client_id,
+          message: %(
+            Submit your token request with client id `#{client_id}` to
+
+            `#{token_url}`
+          )
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/client_tests/pas_client_token_validation_test.rb

@@ -0,0 +1,18 @@
+require_relative '../../../tags'
+
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PASClientTokentRequestTest < Inferno::Test
+      id :pas_client_v201_token_validation_test
+      title 'Client token request is valid'
+      description 'Inferno will verify that an access token was successfully returned to the client under test.'
+      output :access_token
+
+      run do
+        load_tagged_requests(AUTH_TAG)
+        skip_if requests.empty?, 'No token requests were received'
+        output access_token: JSON.parse(requests.last.response_body)['access_token']
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/error_tests/nonconformant_pas_bundle.json

@@ -0,0 +1,16 @@
+{
+  "resourceType" : "Bundle",
+  "id" : "ReferralAuthorizationBundleExample",
+  "meta" : {
+    "profile" : [
+      "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-pas-request-bundle"
+    ]
+  },
+  "identifier" : {
+    "system" : "http://example.org/SUBMITTER_TRANSACTION_IDENTIFIER",
+    "value" : "A12345"
+  },
+  "type" : "collection",
+  "timestamp" : "2005-05-02T11:01:00+05:00",
+  "entry" : []
+}

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/error_tests/pas_inquiry_error_test.rb

@@ -0,0 +1,38 @@
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PasInquiryErrorTest < Inferno::Test
+      id :prior_auth_inquiry_error
+      title %(
+        Server returns OperationOutcome instance when invoking the $inquire operation on the Claim endpoint
+        (/Claim/$inquire) with nonconformant PAS Request Bundle
+      )
+      description %(
+        A server SHALL support PAS Inquiry requests (a POST interaction to the /Claim/$inquire endpoint).
+        This test submits a Prior Authorization Inquiry request containing an empty Bundle
+        to the server and verifies that an OperationOutcome instance is returned with request
+        status 400 when a nonconformant PAS Inquiry Bundle is submitted.
+
+        It is possible that the incoming prior authorization Bundle can not be processed due to validation errors or
+        other non-business-errors. In these instances, the receiving system SHALL return OperationOutcome instances
+        that detail why the Bundle could not be processed and no ClaimResponse will be returned. These errors are NOT
+        the errors that are detected by the system processing the request and that can be conveyed in a ClaimResponse
+        via the error capability.
+      )
+      makes_request :pa_invalid_inquiry
+
+      run do
+        file_path = File.join(File.dirname(__FILE__), 'nonconformant_pas_bundle.json')
+
+        begin
+          invalid_bundle_json = JSON.parse(File.read(file_path))
+          fhir_operation('/Claim/$inquire', body: invalid_bundle_json, name: :pa_invalid_inquiry)
+
+          assert !(200..299).include?(response[:status]), 'HTTP status code should not be within the 2xx range'
+          assert_resource_type(:operation_outcome)
+        rescue JSON::ParserError => e
+          skip "Internal error parsing the invalid bundle JSON: #{e.message}"
+        end
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/error_tests/pas_submission_error_test.rb

@@ -0,0 +1,56 @@
+module DaVinciPASTestKit
+  module DaVinciPASV201
+    class PasSubmissionErrorTest < Inferno::Test
+      id :prior_auth_submission_error
+      title %(
+        Server returns OperationOutcome instance when invoking the $submit operation on the Claim endpoint
+        (/Claim/$submit) with nonconformant PAS Request Bundle
+      )
+      description %{
+        A server SHALL support PAS prior authorization requests (a POST interaction to the /Claim/$submit endpoint).
+        This test submits a Prior Authorization (PA) request containing an empty Bundle
+        to the server and verifies that an OperationOutcome instance is returned with request
+        status 400 when a nonconformant PAS Request Bundle is submitted.
+
+        It is possible that the incoming prior authorization Bundle can not be processed due to validation errors or
+        other non-business-errors. In these instances, the receiving system SHALL return OperationOutcome instances
+        that detail why the Bundle could not be processed and no ClaimResponse will be returned. These errors are NOT
+        the errors that are detected by the system processing the request and that can be conveyed in a ClaimResponse
+        via the error capability.
+
+        The server SHOULD respond within 15 seconds.
+      }
+
+      output :response_time
+      makes_request :pa_invalid_request
+
+      run do
+        file_path = File.join(File.dirname(__FILE__), 'nonconformant_pas_bundle.json')
+
+        begin
+          invalid_bundle_json = JSON.parse(File.read(file_path))
+          start_time = Time.now
+          fhir_operation('/Claim/$submit', body: invalid_bundle_json, name: :pa_invalid_request)
+          end_time = Time.now
+          response_time = end_time - start_time
+
+          if response_time > 15
+            warning %(
+              The server took more that 15 seconds to respond to the Prior Authorization
+              request.
+
+              Response Time: #{response_time}
+            )
+          end
+
+          assert !(200..299).include?(response[:status]), 'HTTP status code should not be within the 2xx range'
+          assert_resource_type(:operation_outcome)
+
+          output response_time:
+        rescue JSON::ParserError => e
+          skip "Internal error parsing the invalid bundle JSON: #{e.message}"
+        end
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/custom_groups/v2.0.1/must_support/device_request_metadata.yml

@@ -0,0 +1,112 @@
+---
+:name: profile_devicerequest
+:class_name: ProfileDevicerequestSequence
+:version: v2.0.1
+:reformatted_version: v201
+:resource: DeviceRequest
+:profile_url: http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-devicerequest
+:profile_name: PAS Device Request
+:profile_version: 2.0.1
+:title: Device Request
+:short_description: Verify support for the server capabilities required by the PAS
+  Device Request.
+:interactions: []
+:operations: []
+:required_concepts:
+- codeCodeableConcept
+:must_supports:
+  :extensions:
+  - :id: DeviceRequest.extension:coverage
+    :path: extension
+    :url: http://hl7.org/fhir/us/davinci-crd/StructureDefinition/ext-coverage-information
+  :slices: []
+  :elements:
+  - :path: code[x]
+  - :path: subject
+    :types:
+    - Reference
+  - :path: occurrence[x]
+:mandatory_elements:
+- DeviceRequest.intent
+- DeviceRequest.code[x]
+- DeviceRequest.subject
+:bindings:
+- :type: code
+  :strength: preferred
+  :system: http://hl7.org/fhir/ValueSet/languages
+  :path: language
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/request-status
+  :path: status
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/request-priority
+  :path: priority
+- :type: CodeableConcept
+  :strength: required
+  :system: http://hl7.org/fhir/us/davinci-pas/ValueSet/X12278RequestedServiceType
+  :path: code
+- :type: CodeableConcept
+  :strength: example
+  :system:
+  :path: parameter.code
+- :type: CodeableConcept
+  :strength: example
+  :system: http://hl7.org/fhir/ValueSet/participant-role
+  :path: performerType
+- :type: CodeableConcept
+  :strength: example
+  :system: http://hl7.org/fhir/ValueSet/condition-code
+  :path: reasonCode
+:references:
+- :path: DeviceRequest.basedOn
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Resource
+- :path: DeviceRequest.priorRequest
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Resource
+- :path: DeviceRequest.subject
+  :profiles:
+  - http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-beneficiary
+- :path: DeviceRequest.encounter
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Encounter
+- :path: DeviceRequest.requester
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Device
+  - http://hl7.org/fhir/StructureDefinition/Practitioner
+  - http://hl7.org/fhir/StructureDefinition/PractitionerRole
+  - http://hl7.org/fhir/StructureDefinition/Organization
+- :path: DeviceRequest.performer
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Practitioner
+  - http://hl7.org/fhir/StructureDefinition/PractitionerRole
+  - http://hl7.org/fhir/StructureDefinition/Organization
+  - http://hl7.org/fhir/StructureDefinition/CareTeam
+  - http://hl7.org/fhir/StructureDefinition/HealthcareService
+  - http://hl7.org/fhir/StructureDefinition/Patient
+  - http://hl7.org/fhir/StructureDefinition/Device
+  - http://hl7.org/fhir/StructureDefinition/RelatedPerson
+- :path: DeviceRequest.reasonReference
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Condition
+  - http://hl7.org/fhir/StructureDefinition/Observation
+  - http://hl7.org/fhir/StructureDefinition/DiagnosticReport
+  - http://hl7.org/fhir/StructureDefinition/DocumentReference
+- :path: DeviceRequest.insurance
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Coverage
+  - http://hl7.org/fhir/StructureDefinition/ClaimResponse
+- :path: DeviceRequest.supportingInfo
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Resource
+- :path: DeviceRequest.relevantHistory
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Provenance
+:tests:
+- :id: pas_server_submit_request_v201_device_request_must_support_test
+  :file_name: server_submit_request_device_request_must_support_test.rb
+- :id: pas_client_submit_request_v201_device_request_must_support_test
+  :file_name: client_submit_request_device_request_must_support_test.rb
+:delayed_references: []