Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

HL7 v2 a FHIR pro klinické dashboardy

Q: Jak jsou označeny abnormální výsledky?

OBX-8 se stane interpretation Observation (například H nebo L) a OBX-7 se stane jeho referenceRange, takže dashboard může zobrazit jak příznak, tak normální rozsah.

Od laboratorní zprávy HL7 v2 ORU^R01 k dlaždici na dashboardu: FHIR Observations s rozsahy a příznaky, podepsané webhooks, žádné duplikáty — a proč to není monitorování u lůžka.

Klinický dashboard potřebuje výsledky jako strukturovaná, kódovaná data v okamžiku jejich nahlášení — test, hodnota, jednotka, referenční rozsah a příznak — nikoli PDF, která musí číst. Laboratoře stále posílají většinu výsledků jako zprávy HL7 v2 ORU^R01, zatímco dashboardy se nejsnadněji vytvářejí na základě FHIR R4 Observations. Anpheros sedí mezi těmito dvěma: laboratorní systém odešle zprávu HL7 v2 (nebo zprávu CSV nebo JSON) přes HTTPS, každý výsledek se stane FHIR Observation s kódem (LOINC, pokud jej laboratoř pošle), hodnotou a referenčním rozsahem a podepsaný webhook informuje váš dashboard o příchozích nových výsledcích.

From the laboratory to a dashboard tile

Laboratory systemSends an HL7 v2 ORU^R01 message or a CSV report
Lab connectorPOST /v1/patients/{id}/labs/import over HTTPS
FHIR ObservationsLOINC code, value, unit, reference range, H/L flag
Signed webhookresource.created reaches your server, retried on failure
Your dashboardReads the new results and updates the tile

Co přijímá dashboard

Každý segment OBX zprávy se stává jedním laboratorním pozorováním (Observation):

Pole HL7 v2 OBX	FHIR R4 Observation	Na dashboardu
OBX-3 test code	`code` (LOINC, pokud jej laboratoř odešle; lokální kód je zachován jako kód laboratoře)	Název testu; LOINC jej činí srovnatelným napříč laboratořemi
OBX-5 value, OBX-6 unit	`valueQuantity` (jednotka UCUM)	Číslo a jeho jednotka
OBX-7 reference range	`referenceRange`	Normální rozmezí
OBX-8 abnormal flag	`interpretation` (H, L, …)	Červená nebo modrá značka
OBX-14 time	`effectiveDateTime`	Kdy byl vzorek odebrán

What a dashboard can build from imported results (illustrative data)

Bed 4 · latest laboratory resultsreceived 08:42 · HL7 v2 ORU^R01

TestValueReferenceFlag

Potassium5.9 mmol/L3.5–5.1H

Creatinine1.1 mg/dL0.7–1.3—

Haemoglobin10.8 g/dL13.0–17.0L

Glucose104 mg/dL70–99H

Import zprávy a reagujte na ni

Odešlete zprávu pro pacienta, kterého jste vytvořili (nebo pro kterého máte oprávnění):

import { readFile } from 'node:fs/promises';
import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });   // a sandbox key, sk_test_…
const message = await readFile('oru_r01.hl7', 'utf8');
const result = await anpheros.labs.importHl7(patientId, message, { sourceSystem: 'lab-lis' });
console.log(result);   // created, skipped and unmapped counts

Poté nechte platformu volat váš backend dashboardu místo jeho dotazování:

await anpheros.webhooks.create('https://dashboard.example.org/anpheros/hook', { events: ['resource.created'] });

Každé doručení je podepsáno (ověřte jej pomocí verifyWebhookSignature ze SDK) a opakuje se, pokud váš server neodpoví. Událost nese typ zdroje, ID a pacienta; přečtěte nové Observations a obnovte dlaždici. Opakovaně odeslané zprávy jsou přeskočeny, takže laboratoř, která znovu odešle při vypršení časového limitu, nevytváří duplicitní řádky na obrazovce.

Volba HL7 v2 nebo FHIR pro každý odkaz

Odkaz	Použití	Důvod
Laboratoř → datová vrstva	HL7 v2 ORU^R01 (nebo CSV/JSON)	Co již laboratorní systémy emitují; žádná změna na jejich straně
Datová vrstva → dashboard	FHIR R4 Observation + webhooks	Kódovaný, verzovaný JSON, který váš frontend může číst přímo
Dashboard → jiné aplikace	FHIR R4, pod souhlasem pacienta	Jeden standard pro každého spotřebitele

Čemu toto není

Není to přenos dat z monitoru u lůžka pacienta. Anpheros přijímá laboratorní zprávy přes HTTPS. Nepřijímá kontinuální průběhy vln nebo datové proudy z monitorů na jednotkách intenzivní péče a není to poplašný systém: upozornění, která ovlivňují péči, vyžadují certifikovaný klinický systém.
Není to MLLP rozhraní. Zprávy přicházejí přes HTTPS; pokud vaše laboratoř komunikuje pouze přes MLLP nad TCP, před ní umístěný rozhraní engine je přeposílá.
Jeden typ zprávy HL7 v2. Jsou přijímány laboratorní výsledky ORU^R01; objednávky (ORM/OML) a zprávy ADT nejsou akceptovány.

Často kladené dotazy

Může dashboard číst výsledky z laboratoře přímo ve formátu HL7 v2?

Ano, ale každý dashboard pak potřebuje vlastní parser HL7 v2, mapování kódů a deduplikaci. Jednorázový převod na FHIR R4 Observations s kódy LOINC poskytne všem obrazovkám stejná čistá data.

Jak rychle se importované výsledky dostanou na dashboard?

Požadavek na import se vrátí, když jsou Observations uloženy, a zároveň je zařazena do fronty resource.created webhook pro každou z nich. Doručení se opakuje, pokud je váš koncový bod nedostupný.

Jak jsou označeny abnormální výsledky?

OBX-8 se stane interpretation Observation (například H nebo L) a OBX-7 se stane jeho referenceRange, takže dashboard může zobrazit jak příznak, tak normální rozsah.

Podporuje Anpheros monitorování na JIP?

Ne. Anpheros ukládá laboratorní a klinické výsledky a upozorňuje vaše systémy na nová data; kontinuální monitorování u lůžka a klinické alarmy zůstávají certifikovaným lékařským zařízením.

Související

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card