Repository navigation
Overview
This document provides a high-level overview of the Da Vinci Prior Authorization Support (PAS) Test Kit, its purpose, and general testing approach.
The Da Vinci PAS Test Kit is designed to validate the conformance of healthcare IT systems against the HL7 FHIR Da Vinci Prior Authorization Support (PAS) Implementation Guide (IG) and includes suites for both v2.0.1 and v2.2.1 of the specification. It helps implementers ensure their systems can correctly participate in electronic prior authorization scenarios as defined by the PAS IG.
The test kit is built using the Inferno Framework, an open-source platform for building FHIR-based test kits.
The PAS Test Kit includes two main test suites:
- Server Test Suite: For systems acting as payers (see Server Details for more information)
- Client Test Suite: For systems acting as providers (see Client Details for more information)
The test kit validates systems through:
-
Scenario Simulation: Tests guide the system through key PAS scenarios including:
- Prior authorization request submission and response handling
- Approval, denial, and pended decision flows
- Error condition handling
-
Data Conformance:
- Validation of must-support elements in PAS-defined FHIR profiles
- FHIR resource validation using the official FHIR validator
- Verification of proper Bundle structure and references
-
Authentication:
- Support for SMART Backend Services
- UDAP B2B client credentials flow
- Other authentication methods via attestation
This test kit is a DRAFT. While it covers core aspects of the PAS IG, there are known limitations.
The test kit currently focuses on validating core end-to-end prior authorization scenarios, including the submission and handling of responses for prior authorization requests (approval, denial, pended) and claim updates. It also covers FHIR profile conformance, validation of must-support elements as defined in PAS IG profiles, basic subscription mechanics for pended request notifications, and core authentication flows like SMART Backend Services and UDAP B2B.
Several areas are generally considered out of scope for automated testing. This includes the proprietary details of X12 transactions, such as X12-based terminology validation and X12-based matching logic. Additionally, not all scenarios and requirements are covered by all suites in this test kit.
For details on specific limitations, detailed requirements, and known issues, please consult the following resources:
- Client Testing Limitations
- Server Testing Limitations
- Relevant requirements including those in the PAS Requirements Spreadsheets
- PAS Test Kit GitHub Issues page.
A test run is considered successful if all mandatory tests pass:
- Passing Tests: Indicate expected behavior for specific scenarios
- Failing Tests: Indicate deviations from PAS IG requirements
- Warnings: Highlight potential concerns that require manual review
- Skipped Tests: Occur when prerequisites are not met
Given the known limitations, especially regarding X12, passing all automated tests does not solely constitute full PAS IG conformance.
For specific testing prerequisites and detailed test descriptions, refer to:
Test kit documentation is stored within the ./docs folder of
this repository and is automatically synchronized to this wiki with each update
to the main branch using the Publish Docs Wiki
workflow. Do not change content
within this wiki directly as changes will be overwritten.
Using this Test Kit
Client Suite
- Client Testing Details
- Client v2.0.1 Testing Walkthrough
- Client v2.2.1 Testing Instructions
- Controlling Inferno's Simulated Responses
- Simulated Subscriptions and Notifications
- Client Must Support Tests
Server Suite
Contributing to this Test Kit
Reference Documents & External Links