Eligibility Verification

Explains how insurance eligibility verification works and how the system integrates with external insurance processors.

Overview

The Insurance Eligibility Verification workflow validates whether a patient’s insurance policy is active and determines the financial responsibility applicable to the patient.

Currently the eligibility verification feature is implemented for the Inmediata vendor.

Future integrations may include additional eligibility providers such as Waystar.


What the Eligibility Check Verifies

The eligibility verification process validates several aspects of the patient’s insurance information.

These include:

Insurance Validity

Confirms whether the patient’s insurance policy is active and valid for the date of service.

Coverage Details

Fetches financial responsibility information such as:

  • Co-insurance percentage
  • Copay amount
  • Deductible details

Patient Information Validation

Verifies patient demographic and insurance-related information and compares it with the data returned by the eligibility vendor.

The system displays:

  • Current values stored in LIMS
  • Suggested or updated values returned by the eligibility vendor
  • Ability to update patient information directly from the eligibility response to improve claim acceptance rates
Verify eligibility button Insurance eligibility modal

Billing After Eligibility Verification

Once valid insurance details are successfully fetched, the billing process can continue using the verified information.

Billing Application
The retrieved financial responsibility values are automatically applied in the billing module.

These include:

  • Co-insurance
  • Copay
  • Deductible

Manual Overrides
The fetched eligibility values can still be overridden in the billing modal if manual adjustments are required before finalizing the bill.

Database Changes
To store these values, the following columns have been introduced:

  • copay_amount
  • deductible_amount

These columns are available in both the billing and billingInfo tables.

Insurance eligibility billing

Technical Requirements for Eligibility Check

To make the eligibility check work, the system requires valid patient information along with proper integration configuration.

Prerequisites

The following prerequisites must be satisfied for eligibility verification to function correctly:

  • Valid patient demographic and insurance information
  • Proper vendor integration setup
  • Required database configuration

Required Valid Data for Integration to Work

The eligibility check will work only when the following data is present and valid:

  • A referral with a valid referring doctor containing an authentic docRegNo
  • A valid group_number in insurance_data
  • A valid member_policy in insurance_data
  • A valid insurance_code in insurance_data
  • A valid Date of Birth in patientRegistrationData

If any of the above information is missing or incorrect, the eligibility request may fail.

Required Database Configuration

Eligibility verification requires proper entries in the following tables:

  • labIntegration
  • developerAuthantication

Reference
For a working example configuration, refer to Lab 33 on the E2E environment.

labIntegration Table Configuration

In the labIntegration table, the column integrationExtraDetails must contain vendor configuration in the following format:

{
  "sender_id": "660964025",
  "sender_code": "30",
  "receiver_id": "660610220",
  "receiver_code": "30",
  "edi_url": "https://www.inmediata.com/ws/EdiFileTransfer/",
  "username": "username",
  "password": "password",
  "auth_token": "Basic {token}=",
  "request_url": "https://www.inmediata.com/webservices/EdiTransfer/EdiFileTransfer.asmx",
  "insurance_with_group_number": ["660396197P"]
}

On this page