BioEcko Docs
Advanced

Integration Hub (HL7/FHIR)

The Integration Hub manages all external system integrations via HL7 v2, FHIR R4, and REST APIs. It provides endpoint configuration, message routing...

February 2026 · 4 min

Manual area

Advanced

Coverage

5 sections

Operator notes

2 implementation notes

Overview

The Integration Hub manages all external system integrations via HL7 v2, FHIR R4, and REST APIs. It provides endpoint configuration, message routing, transformation mappings, and real-time logging for data exchange with lab analyzers, PACS systems, insurance portals, government health registries (ABDM), and third-party applications. Access at /dashboard/integration-hub.

Endpoints

The Endpoints page at /dashboard/integration-hub/endpoints configures external system connections:

  • Endpoint Types -- HL7 TCP/IP listeners, FHIR REST endpoints, DICOM connections, custom REST APIs, SFTP file exchange
  • Configuration -- URL/IP, port, authentication (API key, OAuth, certificate), timeout, retry policy
  • Health Monitoring -- Real-time connection status with auto-reconnect and downtime alerts
  • Direction -- Inbound (receive data from external systems), outbound (send data to external systems), or bidirectional

Message Types

Supported message types include:

  • ADT (Admission/Discharge/Transfer) -- Patient demographics and movement events
  • ORM/OML (Orders) -- Lab and radiology order messages
  • ORU (Results) -- Lab results and radiology reports from external systems
  • DFT (Charges) -- Financial transaction messages
  • SIU (Scheduling) -- Appointment scheduling messages
  • FHIR Resources -- Patient, Encounter, Observation, DiagnosticReport, MedicationRequest, and more
  • Custom -- Configurable message templates for non-standard integrations

Integration Logs

The Logs page at /dashboard/integration-hub/logs provides complete visibility:

  • Real-time Log Stream -- All inbound and outbound messages with timestamps and status
  • Message Viewer -- Click any log entry to view the full message payload (HL7 segments or FHIR JSON)
  • Error Tracking -- Failed messages highlighted with error details and retry options
  • Statistics -- Message volume, success rate, average processing time by endpoint
  • Retention -- Configurable log retention period (default: 90 days)

Common Integrations

Pre-built integration templates for:

  • Lab Analyzers -- Bi-directional interface for automated result capture and order download
  • PACS/DICOM -- Image archiving and study retrieval
  • ABDM -- Ayushman Bharat Digital Mission (ABHA ID creation, Health Information Exchange)
  • Insurance Portals -- E-claims submission and status tracking
  • Government Registries -- Birth/death registration, notifiable disease reporting
  • Pharmacy Chains -- External pharmacy e-prescription routing
  • Accounting Software -- Financial data synchronization (Tally, QuickBooks)

Notes

Warning

Always test new integrations in a sandbox environment before going live. A misconfigured endpoint can flood external systems with erroneous data.

Tip

Enable message logging for at least 30 days to troubleshoot integration issues. Most external system problems surface within the first few weeks.

On this page