Skip to main content

Outside Patient Coverage

Use the Outside Patient Coverage screen to alert doctors when a selected appointment time exceeds the patient’s insurance or service coverage window. The screen prevents submission and provides a support path via embedded chat.

The screen appears automatically based on backend validation and applies only to logged-in, authorized doctors. It loads as a redirect from scheduling or review flows when the proposed session time violates the defined coverage period.


This screen includes:

  • A static message:

    The proposed time is outside the patient’s coverage. Please contact support to book the appointment within the patient’s coverage period.

  • A Chat now button that launches a support session with Air Doctor assistance.
  • Conditional appearance triggered by server-side validation.
  • No editable fields, calendar options, or input controls.
  • Blocks all standard scheduling or approval pathways.

Workflow​

  1. The doctor attempts to schedule or confirm an appointment using any supported flow (e.g., Review and Approve, Offer Appointment).
  2. The backend checks whether the proposed time fits within the patient’s valid coverage window.
  3. If validation fails, the app redirects to the Outside Patient Coverage screen.
  4. The doctor selects Chat now to request guidance or initiate a manual override.

Validations​

  • Triggers this screen when the proposed date or time exceeds the insured coverage period.
  • Blocks all other appointment actions, including:
    • Approval
    • Scheduling
    • Suggesting alternatives
  • Ignores user input; no editable values or dynamic fields appear.
  • Ensures the doctor cannot proceed without support interaction.

Actions​

  • Chat now: Launches a real-time support session using the embedded Air Doctor support module.
  • No submission buttons, navigation options, or dismiss controls appear.
  • The screen remains until the doctor either contacts support or closes the tab.

SDK and API References​

GET 

/profile/appointments/{id}/outside-patient-coverage

Returns a coverage warning screen when the selected appointment time falls outside the patient’s insurance or service agreement. The screen displays a static message and blocks further interaction.

UI Element Types​

LevelReferenceTypeValuePlacement
1outside-patient-coverageRegularThe proposed time is outside the patient's coverage. Please contact support to book the appointment within the patient's coverage period.
1chat-nowButtonApprove