carin_for_blue_button_test_kit 0.12.1 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64361067f120249c1ee01c85806474242013e54242635f81b5f7cf2f2e0b1992
-  data.tar.gz: 796e6f5f879a90a7cb8e0fd885852f177d98fd88780c31590a7fc4090e0eecf5
+  metadata.gz: b975a4081bc825131e5c1ba84dbebf4a20ce7d95e494ba9d83bec8448c6b2510
+  data.tar.gz: 1d3f165ba5a3c5786af032b27c59f5fd338c98c43905666889a1357cc096ec09
 SHA512:
-  metadata.gz: 80496d24d7473e13e90e9485f494454aa3a90b67047663cfb69298bb4e41f96c2c3800a31a6b099b4077d2a935e6da18475db91baabcf9cc69684857619b7eb4
-  data.tar.gz: 2d0e6083bf8e6e78292c69d3a6a6968ad680564cead0ba4f3bc34aeafaa4950bb834b2aab15070167cae3988790442b4039c1fd4f126ce8ca0b1b76dcc292c4f
+  metadata.gz: 1b4e98e70806496adc7a6aa48dd4894ca8aeb3b5da2ba322d50022410eb2f25b4e2dcc26b0e86da4bb1eb65671f03c54ac2665496c2f0930059297219a80c33f
+  data.tar.gz: 6d70082e44ba1534d1dbd1496b99fb6618aa74ae12726f8881b06efed10c9647c4da4de3e0cb6023d82a27264d116f3c08d89d62197cf55e27ed5a9facd6a6d7

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/c4bb_client_test_suite.rb

@@ -0,0 +1,227 @@
+require 'inferno/dsl/oauth_credentials'
+require_relative 'endpoints/resource_api_endpoint'
+require_relative 'endpoints/token_endpoint'
+require_relative 'endpoints/next_page_endpoint'
+require_relative 'endpoints/resource_id_endpoint'
+
+require_relative 'urls'
+require_relative 'mock_server'
+require_relative 'tags'
+require_relative 'collection'
+require_relative 'client_validation_test'
+
+require_relative 'initial_wait_test'
+
+require_relative 'claim_data_request_tests/patient_claims_data_request_test'
+require_relative 'claim_data_request_tests/coverage_claims_data_request_test'
+require_relative 'claim_data_request_tests/organization_claims_data_request_test'
+require_relative 'claim_data_request_tests/practitioner_claims_data_request_test'
+require_relative 'claim_data_request_tests/relatedperson_claims_data_request_test'
+require_relative 'claim_data_request_tests/eob_inpatient_claims_data_request_test'
+require_relative 'claim_data_request_tests/eob_outpatient_claims_data_request_test'
+require_relative 'claim_data_request_tests/eob_oral_claims_data_request_test'
+require_relative 'claim_data_request_tests/eob_pharmacy_claims_data_request_test'
+require_relative 'claim_data_request_tests/eob_professional_claims_data_request_test'
+
+require_relative 'required_searches_tests/patient_required_searches'
+require_relative 'required_searches_tests/coverage_required_searches'
+require_relative 'required_searches_tests/organization_required_searches'
+require_relative 'required_searches_tests/practitioner_required_searches'
+require_relative 'required_searches_tests/relatedperson_required_searches'
+require_relative 'required_searches_tests/eob_required_searches'
+
+require_relative 'claim_data_request_tests/client_claims_data_attestation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBV200ClientSuite < Inferno::TestSuite
+    extend MockServer
+    extend ClientValidationTest
+
+    id :c4bb_v200_client
+    title 'CARIN IG for Blue Button® v2.0.0 Client Test Suite'
+    description File.read(File.join(__dir__, '..', '..', 'docs',
+                                    'carin_for_blue_button_v2.0.0_client_suite_description.md'))
+
+    def self.test_resumes?(test)
+      !test.config.options[:accepts_multiple_requests]
+    end
+
+    links [
+      {
+        label: 'Report Issue',
+        url: 'https://github.com/inferno-framework/carin-for-blue-button-test-kit/issues'
+      },
+      {
+        label: 'Open Source',
+        url: 'https://github.com/inferno-framework/carin-for-blue-button-test-kit'
+      },
+      {
+        label: 'Download',
+        url: 'https://github.com/inferno-framework/carin-for-blue-button-test-kit/releases'
+      },
+      {
+        label: 'Implementation Guide',
+        url: 'http://hl7.org/fhir/us/carin-bb/STU2'
+      }
+    ]
+
+    VALIDATION_MESSAGE_FILTERS = [
+      /\A\S+: \S+: URL value '.*' does not resolve/
+    ].freeze
+
+    fhir_resource_validator do
+      igs 'igs/carin4bb-200.tgz'
+
+      exclude_message do |message|
+        VALIDATION_MESSAGE_FILTERS.any? { |filter| filter.match? message.message }
+      end
+    end
+
+    suite_endpoint :post, TOKEN_PATH, TokenEndpoint
+
+    suite_endpoint :get, PATIENT_PATH, ResourceAPIEndpoint
+
+    suite_endpoint :get, RESOURCE_API_PATH, ResourceAPIEndpoint
+
+    suite_endpoint :get, RESOURCE_ID_PATH, ResourceIDEndpoint
+
+    suite_endpoint :get, BASE_FHIR_PATH, NextPageEndpoint
+
+    resume_test_route :get, RESUME_PASS_PATH do |request|
+      C4BBV200ClientSuite.extract_token_from_query_params(request)
+    end
+
+    resume_test_route :get, RESUME_CLAIMS_DATA_PATH do |request|
+      C4BBV200ClientSuite.extract_token_from_query_params(request)
+    end
+
+    resume_test_route :get, RESUME_FAIL_PATH, result: 'fail' do |request|
+      C4BBV200ClientSuite.extract_token_from_query_params(request)
+    end
+
+    route(:get, METADATA_PATH, get_metadata)
+
+    group do
+      run_as_group
+      title 'Wait for Claims Data and Search Requests'
+      description %(
+        This test will wait for the client system under test to submit requests for resources for each of the
+        [CARIN for Blue Button profiles](https://hl7.org/fhir/us/carin-bb/STU2/artifacts.html#structures-resource-profiles),
+        and for requests including all of the required search parameters for each resource type specified in the
+        [C4BB CapabilityStatement](https://hl7.org/fhir/us/carin-bb/STU2/CapabilityStatement-c4bb.html) and the
+        [US Core Client CapabilityStatement](https://hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-client.html).
+      )
+
+      test from: :initial_wait_test
+    end
+
+    group do
+      title 'C4BB Patient Profile claims data and search request tests'
+      description %(
+        These tests look through all the requests sent in from the client system to ensure a request was made that
+        returned a Patient resource implementing the CARIN for Blue Button [Patient profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-Patient.html).
+        It will also verify that the client made a request using each required search parameter for the Patient resource
+        specified in the [CARIN IG for Blue Button](https://hl7.org/fhir/us/carin-bb/STU2/CapabilityStatement-c4bb.html#patient)
+        and the [US Core Client](https://www.hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-client.html#patient)
+        Capability Statements.
+      )
+
+      test from: :patient_claims_data_request_test
+      test from: :patient_required_searches
+    end
+
+    group do
+      title 'C4BB Coverage Profile claims data and search request tests'
+      description %(
+        These tests look through all the requests sent in from the client system to ensure a request was made that
+        returned a Coverage resource implementing the CARIN for Blue Button [Coverage profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-Coverage.html).
+        It will also verify that the client made a request using each required search parameter for the Coverage
+        resource specified in the [CARIN IG for Blue Button](https://hl7.org/fhir/us/carin-bb/STU2/CapabilityStatement-c4bb.html#coverage)
+        and the [US Core Client](https://www.hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-client.html)
+        Capability Statements.
+      )
+
+      test from: :coverage_claims_data_request_test
+      test from: :coverage_required_searches
+    end
+
+    group do
+      title 'C4BB Organization Profile claims data and search request tests'
+      description %(
+        These tests look through all the requests sent in from the client system to ensure a request was made that
+        returned a Organization resource implementing the CARIN for Blue Button [Organization profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-Organization.html).
+        It will also verify that the client made a request using each required search parameter for the Organization
+        resource specified in the [CARIN IG for Blue Button](https://hl7.org/fhir/us/carin-bb/STU2/CapabilityStatement-c4bb.html#organization)
+        and the [US Core Client](https://www.hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-client.html#organization)
+        Capability Statements.
+      )
+      optional
+
+      test from: :organization_claims_data_request_test
+      test from: :organization_required_searches
+    end
+
+    group do
+      title 'C4BB Practitioner Profile claims data and search request tests'
+      description %(
+        These tests look through all the requests sent in from the client system to ensure a request was made that
+        returned a Practitioner resource implementing the CARIN for Blue Button [Practitioner profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-Practitioner.html).
+        It will also verify that the client made a request using each required search parameter for the Practitioner
+        resource specified in the [CARIN IG for Blue Button](https://hl7.org/fhir/us/carin-bb/STU2/CapabilityStatement-c4bb.html#practitioner)
+        and the [US Core Client](https://www.hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-client.html#practitioner)
+        Capability Statements.
+      )
+      optional
+
+      test from: :practitioner_claims_data_request_test
+      test from: :practitioner_required_searches
+    end
+
+    group do
+      title 'C4BB RelatedPerson Profile claims data and search request tests'
+      description %(
+        These tests look through all the requests sent in from the client system to ensure a request was made that
+        returned a RelatedPerson resource implementing the CARIN for Blue Button [RelatedPerson profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-RelatedPerson.html).
+        It will also verify that the client made a request using each required search parameter for the RelatedPerson
+        resource specified in the [CARIN IG for Blue Button](https://hl7.org/fhir/us/carin-bb/STU2/CapabilityStatement-c4bb.html#relatedperson)
+        and the [US Core Client](https://www.hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-client.html)
+        Capability Statements.
+      )
+      optional
+
+      test from: :relatedperson_claims_data_request_test
+      test from: :relatedperson_required_searches
+    end
+
+    group do
+      title 'C4BB ExplanationOfBenefit Profiles claims data and search request tests'
+      description %(
+        These tests look through all the requests sent in from the client system to ensure a request was made that
+        returned ExplanationOfBenefit resources implementing each of the
+        CARIN for Blue Button [ExplanationOfBenefit profiles](https://hl7.org/fhir/us/carin-bb/STU2/artifacts.html#structures-resource-profiles).
+        It will also verify that the client made a request using each required search parameter for the
+        ExplanationOfBenefit resource specified in the [CARIN IG for Blue Button](https://hl7.org/fhir/us/carin-bb/STU2/CapabilityStatement-c4bb.html#explanationofbenefit)
+        and the [US Core Client](https://www.hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-client.html)
+        Capability Statements.
+      )
+
+      test from: :eob_inpatient_claims_data_request_test
+      test from: :eob_outpatient_claims_data_request_test
+      test from: :eob_oral_claims_data_request_test
+      test from: :eob_pharmacy_claims_data_request_test
+      test from: :eob_professional_claims_data_request_test
+      test from: :eob_required_searches
+    end
+
+    group do
+      run_as_group
+      title 'CARIN For Blue Button Client Attestation'
+      description %(
+        Attest that the client system under test was able to sucessfully process all of the requested resources for
+        each of the CARIN for Blue Button profiles.
+      )
+
+      test from: :client_claims_data_attestation
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/client_claims_data_attestation_test.rb

@@ -0,0 +1,32 @@
+require_relative '../urls'
+
+module CarinForBlueButtonTestKit
+  class ClientAttestationTest < Inferno::Test
+    include URLs
+    title 'CARIN Claims Data Client Attestation'
+    description %(
+      Attest that the all claims data was able to be received and processed by the client.
+    )
+    id :client_claims_data_attestation
+
+    verifies_requirements 'hl7.fhir.us.carin-bb_2.0.0@3',
+                          'hl7.fhir.us.carin-bb_2.0.0@13'
+
+    run do
+      identifier = SecureRandom.hex(32)
+      wait(
+        identifier:,
+        message: %(
+          I attest that the client system under test was able to receive, process, and retain all of the requested
+          CARIN for Blue Button claims data, including all of the profile data elements that have a minimum cardinality
+          greater than or equal to 1 and/or flagged as Must Support as defined by that profiles StructureDefinition
+          for each resource.
+
+          [Click here](#{resume_pass_url}?token=#{identifier}) if the system **meets** this requirement.
+
+          [Click here](#{resume_fail_url}?token=#{identifier}) if the system **does not meet** this requirement.
+        )
+      )
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/coverage_claims_data_request_test.rb

@@ -0,0 +1,25 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientCoverageSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :coverage_claims_data_request_test
+    title 'Coverage resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is a Coverage resource
+      that conforms to the CARIN for Blue Button [Coverage profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-Coverage.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:Coverage)
+      skip_if resources.nil?, 'No requests made for Coverage resources'
+
+      assert resources.any? { |resource| resource.id == 'c4bb-Coverage' },
+             'Unable to find expected resource: c4bb-Coverage'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/eob_inpatient_claims_data_request_test.rb

@@ -0,0 +1,26 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientEOBInpatientSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :eob_inpatient_claims_data_request_test
+    title 'Inpatient Institutional ExplanationOfBenefit resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is an ExplanationOfBenefit resource
+      that conforms to the CARIN for Blue Button [Outpatient Institutional ExplanationOfBenefit profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-ExplanationOfBenefit-Outpatient-Institutional.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:ExplanationOfBenefit_Inpatient_Institutional)
+      skip_if resources.nil?,
+              'No requests made for ExplanationOfBenefit resources'
+
+      assert resources.any? { |resource| resource.id == 'c4bb-EOBInpatient' },
+             'Unable to find expected resource: c4bb-EOBInpatient'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/eob_oral_claims_data_request_test.rb

@@ -0,0 +1,25 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientEOBOralSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :eob_oral_claims_data_request_test
+    title 'Oral ExplanationOfBenefit resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is an ExplanationOfBenefit resource
+      that conforms to the CARIN for Blue Button [Oral ExplanationOfBenefit profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-ExplanationOfBenefit-Oral.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:ExplanationOfBenefit_Oral)
+      skip_if resources.nil?, 'No requests made for ExplanationOfBenefit resources'
+
+      assert resources.any? { |resource| resource.id == 'c4bb-EOBOral' },
+             'Unable to find expected resource: c4bb-EOBOral'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/eob_outpatient_claims_data_request_test.rb

@@ -0,0 +1,28 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientEOBOutpatientSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :eob_outpatient_claims_data_request_test
+    title 'Outpatient Institutional ExplanationOfBenefit resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is an ExplanationOfBenefit resource
+      that conforms to the CARIN for Blue Button [Outpatient Institutional ExplanationOfBenefit profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-ExplanationOfBenefit-Outpatient-Institutional.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:ExplanationOfBenefit_Outpatient_Institutional)
+      skip_if resources.nil?,
+              'No requests made for ExplanationOfBenefit resources'
+
+      assert resources.any? { |resource|
+        resource.id == 'c4bb-EOBOutpatient'
+      },
+             'Unable to find expected resource: c4bb-EOBOutpatient'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/eob_pharmacy_claims_data_request_test.rb

@@ -0,0 +1,25 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientEOBPharmacySubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :eob_pharmacy_claims_data_request_test
+    title 'Pharmacy ExplanationOfBenefit resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is an ExplanationOfBenefit resource
+      that conforms to the CARIN for Blue Button [Pharmacy ExplanationOfBenefit profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-ExplanationOfBenefit-Pharmacy.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:ExplanationOfBenefit_Pharmacy)
+      skip_if resources.nil?, 'No requests made for ExplanationOfBenefit resources'
+
+      assert resources.any? { |resource| resource.id == 'c4bb-EOBPharmacy' },
+             'Unable to find expected resource: c4bb-EOBPharmacyt'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/eob_professional_claims_data_request_test.rb

@@ -0,0 +1,27 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientEOBProfessionalSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :eob_professional_claims_data_request_test
+    title 'Professional NonClinician ExplanationOfBenefit resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is an ExplanationOfBenefit resource
+      that conforms to the CARIN for Blue Button [Professional NonClinician ExplanationOfBenefit profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-ExplanationOfBenefit-Professional-NonClinician.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:ExplanationOfBenefit_Professional_NonClinician)
+      skip_if resources.nil?,
+              'No requests made for ExplanationOfBenefit resources'
+
+      assert resources.any? { |resource|
+        resource.id == 'c4bb-EOBProfessional'
+      }, 'Unable to find expected resource: c4bb-EOBProfessional'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/organization_claims_data_request_test.rb

@@ -0,0 +1,26 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientOrganizationSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :organization_claims_data_request_test
+    title 'Organization resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is an Organization resource
+      that conforms to the CARIN for Blue Button [Organization profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-Organization.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:Organization)
+      skip_if resources.nil?, 'No requests made for Organization resources'
+
+      assert resources.any? { |resource|
+        resource.id == 'c4bb-Organization'
+      }, 'Unable to find expected resource: c4bb-Organization'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/patient_claims_data_request_test.rb

@@ -0,0 +1,24 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientPatientSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :patient_claims_data_request_test
+    title 'Patient resources related to the patient matched are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is a Patient resource
+      that conforms to the CARIN for Blue Button [Patient profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-Patient.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:Patient)
+      skip_if resources.nil?, 'No requests made for Patient resources'
+
+      assert resources.any? { |resource| resource.id == '888' }, 'Unable to find expected resource: 888'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/practitioner_claims_data_request_test.rb

@@ -0,0 +1,25 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientPractitionerSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :practitioner_claims_data_request_test
+    title 'Practitioner resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is a Practitioner resource
+      that conforms to the CARIN for Blue Button [Practitioner profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-Practitioner.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:Practitioner)
+      skip_if resources.nil?, 'No requests made for Practitioner resources'
+
+      assert resources.any? { |resource| resource.id == 'c4bb-Practitioner' },
+             'Unable to find expected resource: c4bb-Practitioner'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/claim_data_request_tests/relatedperson_claims_data_request_test.rb

@@ -0,0 +1,25 @@
+require_relative '../urls'
+require_relative '../client_validation_test'
+
+module CarinForBlueButtonTestKit
+  class C4BBClientRelatedPersonSubmitClaimsDataRequestTest < Inferno::Test
+    include URLs
+    include CarinForBlueButtonTestKit::ClientValidationTest
+
+    id :relatedperson_claims_data_request_test
+    title 'RelatedPerson resources related to CARIN claims data are gathered'
+    description %(
+      This test verifies that an instance returned by requests made by the client is a RelatedPerson resource
+      that conforms to the CARIN for Blue Button [RelatedPerson profile](https://hl7.org/fhir/us/carin-bb/STU2/StructureDefinition-C4BB-RelatedPerson.html).
+    )
+    input :access_token
+
+    run do
+      resources = previous_resource_requests(:RelatedPerson)
+      skip_if resources.nil?, 'No requests made for RelatedPerson resources'
+
+      assert resources.any? { |resource| resource.id == 'c4bb-RelatedPerson' },
+             'Unable to find expected resource: c4bb-RelatedPerson'
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/client_validation_test.rb

@@ -0,0 +1,93 @@
+module CarinForBlueButtonTestKit
+  module ClientValidationTest
+    def all_resource_types
+      ['Patient', 'Coverage', 'Organization', 'Practitioner', 'RelatedPerson',
+       'ExplanationOfBenefit_Inpatient_Institutional', 'ExplanationOfBenefit_Outpatient_Institutional',
+       'ExplanationOfBenefit_Oral', 'ExplanationOfBenefit_Pharmacy', 'ExplanationOfBenefit_Professional_NonClinician']
+    end
+
+    def previous_claims_data_request_resources(resource_type_tag)
+      hash = Hash.new { |hash, key| hash[key] = [] }
+      previous_claims_data_requests(resource_type_tag).each_with_object(hash) do |request, request_resource_hash|
+        request_resources =
+          if request.status == 200
+            request.resource.entry.map(&:resource)
+          else
+            []
+          end
+        request_resource_hash[request].concat(request_resources)
+      end
+    end
+
+    def extract_eob_profile(resource)
+      profile_url = resource.meta.profile.find do |profile|
+        profile.include?('StructureDefinition/C4BB-ExplanationOfBenefit')
+      end
+      match = %r{http://hl7.org/fhir/us/carin-bb/StructureDefinition/(.*)}.match(profile_url)
+      return unless match.present?
+
+      match[1].delete_prefix('C4BB-ExplanationOfBenefit-').split('|')[0].gsub('-', '_')
+    end
+
+    def previous_claims_data_request_resources_scratch(resource_type_tag)
+      previous_claims_data_request_resources(resource_type_tag).each do |request, resources|
+        resources.each do |resource|
+          next unless resource_type_tag.to_s.include?(resource.resourceType)
+
+          if resource.resourceType == 'ExplanationOfBenefit'
+            profile = extract_eob_profile(resource)
+            identifier = "#{resource.resourceType}_#{profile}"
+            scratch[identifier.to_sym] ||= []
+            scratch[identifier.to_sym] |= [resource]
+          end
+          scratch[resource.resourceType.to_sym] ||= []
+          scratch[resource.resourceType.to_sym] |= [resource]
+        end
+      end
+    end
+
+    def previous_resource_requests(resource_type_tag)
+      previous_claims_data_request_resources_scratch(resource_type_tag)
+      scratch[resource_type_tag]
+    end
+
+    def previous_claims_data_search_parameters_scratch(resource_type_tag)
+      previous_claims_data_request_resources(resource_type_tag).each_key do |request|
+        endpoint_resource = resource_type_endpoint(request.url)
+        search_params = request.tags - [RESOURCE_API_TAG, resource_type_tag.to_s] - all_resource_types
+
+        scratch[:"#{endpoint_resource}Search"] ||= []
+        search_params.each do |search_param|
+          unless scratch[:"#{endpoint_resource}Search"].include?(search_param)
+            scratch[:"#{endpoint_resource}Search"].append(search_param)
+          end
+        end
+      end
+      scratch[:SavedSearchParams] = true
+    end
+
+    def resource_previous_search_params(resource_tag)
+      previous_claims_data_search_parameters_scratch(resource_tag)
+      scratch[resource_tag]
+    end
+
+    def resource_type_endpoint(url)
+      return unless url.start_with?('http://', 'https://')
+
+      match = %r{custom/c4bb_v200_client/fhir/(.*)\?}.match(url)
+      match[1] if match.present?
+    end
+
+    def connect_bundle(export_binary)
+      export_binary.split(/(?<=}\n)(?={)/).map { |str| FHIR.from_contents(str) }
+    end
+
+    def previous_claims_data_requests(resource_type_tag = nil)
+      load_tagged_requests(RESOURCE_API_TAG, resource_type_tag.to_s)
+    end
+
+    def flattened_all_resources
+      @flattened_all_resources ||= previous_claims_data_request_resources.values.flatten
+    end
+  end
+end

data/lib/carin_for_blue_button_test_kit/client/v2.0.0/collection.rb

@@ -0,0 +1,19 @@
+module CarinForBlueButtonTestKit
+  SET_TO_BE_GATHERED = { Coverage: ['c4bb-Coverage'],
+                         ExplanationOfBenefit: ['c4bb-EOBInpatient', 'c4bb-EOBOral', 'c4bb-EOBOutpatient',
+                                                'c4bb-EOBPharmacy', 'c4bb-EOBProfessional'],
+                         Organization: ['c4bb-Organization'],
+                         Patient: ['888'],
+                         Practitioner: ['c4bb-Practitioner'],
+                         RelatedPerson: ['c4bb-RelatedPerson'] }.freeze
+
+  SEARCHES_BY_PRIORITY = { Coverage: [['_id'], ['_lastUpdated'], ['patient']],
+                           ExplanationOfBenefit: [['_id'], ['patient'], ['identifier'], ['_lastUpdated'],
+                                                  ['service-date'], ['service-start-date'], ['billable-period-start'],
+                                                  ['type'], ['_include']],
+                           Organization: [['_id'], ['_lastUpdated'], ['name'], ['address']],
+                           Patient: [['_id'], ['_lastUpdated'], ['birthdate'], ['family'], ['gender'], ['given'],
+                                     ['identifier'], ['name']],
+                           Practitioner: [['_id'], ['_lastUpdated'], ['name'], ['identifier']],
+                           RelatedPerson: [['_id'], ['_lastUpdated'], ['patient']] }.freeze
+end