Getting Started with LISBridge

Five steps to your first result

This is the complete path from zero to results flowing into your HIS. Each step is covered in detail further down this page.

Where to download

License revocation notifications

When an admin revokes a device from the web dashboard, the LISBridge app receives an automatic in-app notification and the license status updates without requiring a restart. Active connections stay open until the session ends, but new connections will be blocked.

To transfer to a new machine: revoke the old device in your dashboard (Subscriptions → Manage → Devices → Revoke), then repeat the 4-step registration on the new machine. The slot is immediately available for re-binding.

Used by most haematology and chemistry analysers. Connect the serial cable from your instrument to a COM port on your computer (or USB-to-serial adapter).

Used by network-capable instruments. The computer and instrument must be on the same network (or accessible via a routed network).

Configuration — Settings → FTP Transport

Configuration — Settings → Connection

Receive orders from your HIS (Order Pull)

Instead of your HIS pushing orders to LISBridge (which often fails through NAT and firewalls), Order Pull lets LISBridge poll your HIS on a regular interval to fetch new worklist orders. LISBridge makes the outbound connection — so there is nothing to open in your firewall.

Step 1 — Configure in LISBridge

Go to Settings → HIS/HMS Order Pull (Poll) and fill in three fields:

Step 2 — What your HIS endpoint must do

LISBridge sends a POST to your endpoint on every poll cycle. The request body includes confirmations from the previous batch:

// Request body LISBridge sends each poll
{
  "source":    "LISBridge",
  "device_id": "abc123",
  "ack": [
    {
      "his_order_id": "ORD-2026-001",
      "lis_id":       42,           // internal LISBridge ID
      "status":       "recorded",   // "recorded" | "duplicate" | "rejected"
      "error":        null
    }
  ]
}

Your endpoint validates the token, marks the acknowledged orders as received, and responds with the next batch of pending orders:

// Response your HIS must return
{
  "orders": [
    {
      "his_order_id":      "ORD-2026-002",   // unique, stable ID from your HIS
      "target_instrument": "Sysmex XN-550",  // instrument name
      "priority":          "ROUTINE",        // "ROUTINE" | "URGENT"
      "patient": {
        "id":     "P-10045",
        "name":   "Ahmed Rahman",
        "age":    34,
        "gender": "M"                        // "M" | "F" | "U"
      },
      "tests": ["CBC", "WBC DIFF"]           // test codes or names
    }
  ]
}

Parameter mapping & custom parameters

Raw parameter names from an instrument (e.g. WBC) may not match what your HIS or report expects. Parameter Mapping lets you translate names, set custom reference ranges, and define derived calculations — without touching any instrument settings.

How to configure

Parser auto-updates

Every 15 minutes, LISBridge silently checks for WASM parser updates. If a new version is available (new instrument support, protocol fix, etc.), it downloads and applies in the background. No restart. No notification. Your connections stay active throughout.