Results Inbox

The Results screen (/results) aggregates analyte values from manual entry and automated analyzer imports. Technicians review, complete partial panels, and route verified data to report generation.

Permission modules: results_entry, result_verification

Results data flow

flowchart TB
    subgraph Sources
        MAN[Manual entry]
        HL7[HL7 ORU]
        ASTM[ASTM records]
        JSON[JSON REST]
    end
    subgraph EaseLab
        INBOX[Results inbox]
        MAP[Catalog mapping]
        VER[Verification queue]
        PDF[Report PDF]
    end
    MAN --> INBOX
    HL7 --> INBOX
    ASTM --> INBOX
    JSON --> INBOX
    INBOX --> MAP --> VER --> PDF

Inbox views

View	Contents
Pending import	Machine messages awaiting match
Partial panels	Some parameters filled, others missing
Ready for verification	All required fields complete
Verified	Signed reports
Failed ingest	Barcode or mapping errors

Filter by date, department, patient, barcode, or analyzer device.

Imported vs manual results

Source	Indicator	Action
Analyzer	Device name, ingest log ID	Review flags, auto-reference range
Manual	Entering user	Full QC per parameter
Mixed	Partial auto	Complete missing analytes manually

Each ingest creates a log entry with payload reference for troubleshooting.

Reviewing analyzer imports

1. Open result row from inbox.
2. Confirm patient and sample match barcode.
3. Review abnormal flags against catalog reference ranges.
4. Correct mapping errors (wrong analyte code) via catalog parameters.
5. Save and advance to verification if complete.

Failed ingest log

When ingest returns 422, check log ID in API response. Common causes: unknown barcode, unmapped OBX code, empty payload.

Verification workflow

result_verification.edit grants sign-off authority:

sequenceDiagram
    participant Tech as Technician
    participant EaseLab
    participant Path as Verifier
    participant Pat as Patient
    Tech->>EaseLab: Complete parameters
    EaseLab->>Path: Verification queue
    Path->>EaseLab: Approve
    EaseLab->>Pat: SMS / public link optional

Step	Permission
Enter values	results_entry.create/edit
Verify	result_verification.edit or quick.verify_results
Deliver	report_delivery.create

Some labs enforce two-person separation — enterers cannot verify own work.

Critical and abnormal values

Parameters may flag:

Flag	Typical action
High / Low	Highlight on PDF
Critical	Callback SOP + quick.send_sms
Delta check	Compare prior visit if available

Document callback procedures in lab SOPs outside EaseLab.

Report generation

Verified results feed:

• Printable PDF with letterhead
• Public report lookup
• Email and WhatsApp attachments (when enabled)

Report layout respects department and profile templates from catalog configuration.

Permissions

Task	Code
View inbox	results_entry.view
Enter/edit values	results_entry.create/edit
Delete draft entry	results_entry.delete
Verify	result_verification.edit
Quick verify shortcut	quick.verify_results

Analyzer integration reference

Protocol	Content-Type	Endpoint
HL7 v2	text/plain	POST /integrations/v1/results
ASTM	text/plain	Same
JSON REST	application/json	Same

Authentication: X-Analyzer-Key: mlk_... header.

Health check: GET /integrations/v1/health

Troubleshooting

Issue	Resolution
Results on wrong patient	Barcode collision — reject and recollect
Missing parameters	Incomplete machine transmission
Duplicate OBX	Middleware retry — dedupe in LIS bridge
403 ingest	Tenant locked or plan lacks analyzer feature
Cannot verify	Missing permission or read-only mode

Related documentation

• Result Entry & Verification
• Analyzers
• How-To: Send Report to Patient
• API: Analyzer Integration