Qliva receives structured pathology results and clinical correspondence from Australian labs and radiology providers via HL7 v2 messaging.
What is HL7?
HL7 (Health Level 7) is a messaging standard used by Australian pathology labs, radiology providers, and hospitals to send test results and clinical documents electronically. When a lab processes a blood test, they send an HL7 message to your clinic system — and Qliva can receive and display those results automatically.
What Qliva supports
Qliva supports HL7 v2.x messages delivered via the Medical Objects / Capricorn routing network — the most widely used clinical messaging infrastructure in Australia.
What arrives via HL7
| Content type | How it arrives | Where it appears in Qliva |
|---|---|---|
| Structured pathology results | OBX segments with coded values | Pathology Inbox |
| Clinical correspondence / letters | FT (formatted text) OBX segments | Clinical Mail Inbox |
| PDF reports | ED (encapsulated data) segments | Attached in pathology or clinical mail |
Most labs send a mix of these — for example, a blood panel might include both structured OBX values and a PDF summary.
Connecting your clinic
Step 1 — Register with Medical Objects
If your clinic isn't already registered, sign up at medicalobjects.com.au as a healthcare provider. Medical Objects is the network that routes HL7 messages between labs and clinic software.
Step 2 — Get your Qliva HL7 endpoint
Contact Qliva support to obtain:
- Your clinic's HL7 endpoint URL
- The authentication secret for that endpoint
These are unique to your clinic and are not published publicly.
Step 3 — Configure routing with Medical Objects
Provide your Qliva HL7 endpoint URL to Medical Objects. They'll configure the routing on their side so that messages addressed to your clinic are forwarded to Qliva.
Step 4 — Test with a known result
Ask the lab to send a known test result. It should appear in your Pathology Inbox within a few minutes. If it doesn't arrive, contact Qliva support with the message timestamp so we can check the endpoint logs.
Your HL7 endpoint
https://{yourclinic}.qliva.com.au/api/hl7/process
This endpoint is server-to-server only and is authenticated via a shared secret header. It is not intended to be called from a browser or by end users.
The HL7 endpoint URL and authentication secret are not published in this documentation for security reasons. Contact Qliva support to obtain your clinic's credentials.
Message routing logic
Qliva inspects the content of each incoming HL7 message and routes it accordingly:
| Message content | Routed to |
|---|---|
| OBX segments with structured values | Pathology Inbox |
| OBX segments with FT (formatted text) | Clinical Mail Inbox |
| ED segments (embedded PDF) | Clinical Mail Inbox as attachment |
| Mixed content | Routed based on primary content type |
Functional reference ranges
Australian labs include their own reference ranges in HL7 results. Qliva displays these, but your admin can also configure functional (optimal) reference ranges for any test panel — separate from the lab-issued values. This is useful for longevity and integrative medicine practices that interpret results differently from conventional medicine.
To configure functional ranges: Admin Portal → Settings → Pathology Panels
Do not share your HL7 authentication secret. It grants the ability to receive clinical data into your clinic's Qliva account. Treat it like a password.