Connect an Analyzer

Integrate laboratory analyzers with EaseLab to automatically import test results via HL7, ASTM, or JSON protocols.

Permissions: Tenant admin, or plan with analyzer integration feature

Prerequisites

Requirement	Detail
Plan feature	Analyzer integration enabled on subscription
Network	Analyzer middleware PC can reach API over HTTPS
Protocol	HL7 v2.x, ASTM E1394, or EaseLab JSON
Barcodes	Samples labeled with EaseLab invoice barcodes

Step 1: Create analyzer device

1. Go to Admin → Analyzers → Add Device.
2. Configure:

Field	Example
Name	Chemistry Analyzer 1
Protocol	Hl7
Description	Room 2, Mindray BC-5150

3. Save and copy the API key — shown only once.

API: POST /lab/analyzers

Step 2: Configure analyzer middleware

On the PC connected to the analyzer, configure the LIS middleware to POST results to:

POST https://api.yourdomain.com/integrations/v1/results
Header: X-Analyzer-Key: <your-api-key>
Content-Type: text/plain (or application/hl7)
Body: raw analyzer message

See API: Analyzer Integration.

Step 3: Test connectivity

curl https://api.yourdomain.com/integrations/v1/health \
  -H "X-Analyzer-Key: your-key"

Expected: { "status": "ok", "device": "...", "protocol": "Hl7" }

Step 4: Send test result

1. Create a test invoice with a known barcode.
2. Run a sample on the analyzer with that barcode.
3. Check Analyzers → Logs for import status.

Log status	Meaning
Success	Results matched and saved
Error	Check message and barcode

Protocol-specific notes

HL7

Setting	Value
Message type	ORU^R01
Barcode field	Usually OBR-3 or PID-3 (device-dependent)
Content-Type	application/hl7 or text/plain

ASTM

Setting	Value
Record types	H, P, O, R, L
Barcode	O record sample ID

JSON

Use EaseLab's simplified JSON schema for custom integrations. Contact support for schema details.

Barcode matching

Results match to invoices by sample barcode. Ensure:

1. Barcode stickers are printed from EaseLab (stickers.pdf).
2. Scanner reads barcode correctly into the analyzer.
3. No leading/trailing spaces in barcode field.

Revoke and rotate keys

If a key is compromised:

1. Analyzers → Device → Revoke.
2. Create a new device with a new key.
3. Update middleware configuration.

API: DELETE /lab/analyzers/{id}

Troubleshooting

Issue	Check
401 Unauthorized	API key header name and value
422 Unprocessable	Barcode not found; check logs
No results appear	Invoice status allows result entry
403 on device list	Plan feature or permission

See Troubleshooting: Analyzers.

Related links

• Laboratory: Analyzers
• API: POST /integrations/v1/results
• FAQ: Technical