Search
K
< Back

Lab Network iFrame

The Lab Network iFrame provides an embedded ordering experience that allows people with appropriate permissions to place diagnostic orders within your application using Health Gorilla’s ordering interface. It supports laboratory testing, imaging, and other supported diagnostic services without requiring you to build or maintain a custom ordering UI.

The iFrame supports order placement only and does not display or retrieve results.

Ordering Capabilities

The primary function of the Lab Network iFrame is embedded order entry. Your application initiates an order request and launches the Health Gorilla ordering interface within your workflow, allowing order placement to occur without redirecting to a separate system.

Order entry through the iFrame supports selecting the ordering facility, ordering provider, patient context, and requested tests. Orders placed through the iFrame follow the same validation, compendium alignment, routing, and fulfillment rules as orders submitted through API-based or UI-based workflows.

Prerequisites

iFrame access requires Lab Network ordering to be enabled for your tenant and OAuth 2.0 credentials with ordering scopes. Results handling requires API-based integration or use of the Health Gorilla UI.

The iFrame relies on the same Lab Network tenant configuration as API-based ordering, including enabled laboratory connections and compendium alignment. OAuth 2.0 credentials are required to initiate ordering sessions.

Results handling is not supported through the iFrame and requires API-based integration or operational review in the Health Gorilla UI.

Session Scope and Authentication

The iFrame uses OAuth 2.0 authentication, consistent with Lab Network APIs. Your system generates an access token and appends it to the iFrame URL returned by the ordering endpoint.

Each embedded session is scoped to a single patient and a single order. The session does not expose navigation to other patients, orders, or administrative functionality.

Ordering Flow Overview

Ordering through the iFrame follows a defined handoff pattern between your system and Health Gorilla. At a high level:

  • Your system submits an order initiation request to the Lab Network ordering endpoint.
  • Health Gorilla returns a callback URL for order entry.
  • Your system appends the OAuth 2.0 access token to the URL.
  • The URL is loaded in an embedded frame or browser window.
  • After the order is completed or canceled, Health Gorilla redirects back to your application.

This approach keeps order entry embedded in your workflow while delegating ordering interactions to UI.

Results Handling

The iFrame does not display results or provide access to result data. Results generated from orders placed through the iFrame must be handled through other access models:

  • API-based integration for structured or unstructured result retrieval.
  • Review in the Health Gorilla UI for operational confirmation.

When to Use the iFrame

iFrame access fits scenarios where your organization wants to embed order placement within an existing application while relying on APIs or the UI for results handling.

The iFrame is appropriate when:

  • Order placement must occur within your application workflow.
  • Building and maintaining a custom ordering interface is not desirable.
  • Results will be consumed through API-based integration or reviewed operationally in the UI.

Relationship to Other Access Models

The Lab Network iFrame complements API and UI access models by simplifying embedded order entry. API access remains the primary method for structured results ingestion and downstream processing, while UI access supports manual ordering and operational tracking.