# HL7 v2 és FHIR klinikai irányítópultokhoz

> Egy HL7 v2 ORU^R01 laborüzenettől egy irányítópult csempéjéig: FHIR megfigyelések (Observations) tartományokkal és jelzőkkel, aláírt webhookok, duplikátumok nélkül – és miért nem ez az ágy melletti monitorozás.

Source: https://developers.anpheros.com/hu/guides/clinical-dashboard-hl7-fhir

**Egy klinikai irányítópultnak a strukturált, kódolt adatok formájában érkező eredményekre van szüksége abban a pillanatban, amikor azokat jelentik – teszt, érték, mértékegység, referencia tartomány és jelző –, nem pedig PDF-ekre, amelyeket el kell olvasnia.** A laboratóriumok továbbra is a legtöbb eredményt HL7 v2 ORU^R01 üzenetként küldik, míg az irányítópultokat a legegyszerűbb FHIR R4 Observations alapján felépíteni. Az Anpheros a kettő között helyezkedik el: egy laboratóriumi rendszer HTTPS-en keresztül közzéteszi a HL7 v2 üzenetet (vagy CSV vagy JSON jelentést), minden egyes eredmény FHIR Observation-né válik a kódjával (LOINC, ha a labor elküldi), értékével és referencia tartományával, és egy aláírt webhook tájékoztatja az irányítópultot az új eredmények érkezéséről.

<!-- visual:dashboard-pipeline -->

## Amit a műszerfal fogad

Az üzenet minden OBX szegmense egy laboratóriumi megfigyelést (Observation) eredményez:

| HL7 v2 OBX mező | FHIR R4 Observation | A műszerfalon |
|---|---|---|
| OBX-3 teszt kód | `code` (LOINC, ha a labor küldi; helyi kódként a labor kódja marad) | Teszt neve; a LOINC teszi összehasonlíthatóvá a laborok között |
| OBX-5 érték, OBX-6 egység | `valueQuantity` (UCUM egység) | A szám és az egysége |
| OBX-7 referencia tartomány | `referenceRange` | A normál tartomány |
| OBX-8 abnormalitási jelző | `interpretation` (H, L, …) | A piros vagy kék jelző |
| OBX-14 időpont | `effectiveDateTime` | Mikor vették a mintát |

<!-- visual:dashboard-mock -->

## Üzenet importálása és reagálás rá

Küldje el az üzenetet egy általuk létrehozott (vagy Ön által birtokolt) beteg számára:

```ts
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
```

Ezután hagyja, hogy a platform a lekérdezés helyett a dashboard backendjét hívja meg:

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

Minden kézbesítés alá van írva (ellenőrizze a `verifyWebhookSignature` segítségével az SDK-ból), és újra megpróbálkozik, ha a szervere nem válaszol. Az esemény tartalmazza az erőforrás típusát, azonosítóját és a beteget; olvassa el az új megfigyeléseket (Observations) és frissítse a csempét. Az újra küldött jelentéseket a rendszer kihagyja, így egy laboratórium, amely időtúllépés esetén újra továbbít, nem hoz létre duplikált sorokat a képernyőn.

## HL7 v2 vagy FHIR kiválasztása minden kapcsolathoz

| Kapcsolat | Használat | Miért |
|---|---|---|
| Laboratórium → adatréteg | HL7 v2 ORU^R01 (vagy CSV/JSON) | Amit a laboratóriumi rendszerek már kibocsátanak; nincs változás az ő oldalukon |
| Adatréteg → irányítópult | FHIR R4 Observation + webhookok | Kódolt, verziózott JSON, amit a frontend közvetlenül tud olvasni |
| Irányítópult → más alkalmazások | FHIR R4, a beteg beleegyezése alapján | Egy szabvány minden fogyasztó számára |

## Mi ez nem

- **Nem intenzív ápolási monitor adatáradat.** Az Anpheros laboratóriumi jelentéseket fogad HTTPS protokollon keresztül. Nem fogad folyamatos hullámformokat vagy eszközadatfolyamokat intenzív ápolási monitorokról, és nem riasztórendszer: a ellátást befolyásoló riasztásokhoz tanúsított klinikai rendszer szükséges.
- **Nem MLLP interfész motor.** Az üzenetek HTTPS protokollon érkeznek; ha a laboratóriuma csak MLLP-t beszél TCP-n keresztül, egy interfész motor továbbítja azokat.
- **Egy HL7 v2 üzenettípus.** ORU^R01 laboratóriumi eredményeket fogadunk; megrendeléseket (ORM/OML) és ADT üzeneteket nem.

## Gyakran ismételt kérdések

### Tud-e egy irányítópult közvetlenül HL7 v2 laboreredményeket olvasni?
Meg tudja, de minden irányítópultnak szüksége van saját HL7 v2 elemzőre, kódleképezésre és ismétlődések eltávolítására. Egyszeri konverzió FHIR R4 Observations-re LOINC kódokkal minden képernyőnek ugyanazt a tiszta adatot biztosítja.

### Milyen gyorsan érnek el az importált eredmények az irányítópulthoz?
Az import kérés akkor tér vissza, amikor az Observations tárolásra kerülnek, és egyidejűleg `resource.created` webhook kerül sorra minden egyes eredményhez. A kézbesítés újra megpróbálkozik, ha az Ön végpontja nem elérhető.

### Hogyan vannak megjelölve a rendellenes eredmények?
Az OBX-8 lesz az Observation `interpretation`-e (például H vagy L), és az OBX-7 a `referenceRange`-e, így az irányítópult mind a jelölést, mind a normál tartományt meg tudja jeleníteni.

### Támogatja az Anpheros az intenzív osztályok monitorozását?
Nem. Laboratóriumi és klinikai eredményeket tárol, és értesíti rendszereit az új adatokról; a folyamatos ágy melletti monitorozás és a klinikai riasztások a tanúsított orvosi eszközökkel maradnak.

<!-- visual:cta-dashboard -->

## Kapcsolódó

- [Lab eredmények API: HL7 v2, FHIR és LOINC](https://developers.anpheros.com/hu/guides/lab-results-api)
- [Laboratóriumi eredmények importálása FHIR rekordba](https://developers.anpheros.com/hu/guides/import-lab-results-fhir)
- [Lab összekötő](https://developers.anpheros.com/hu/guides/lab-connector): az endpoint referencia
- [FHIR vs HL7 v2: gyakorlati különbségek](https://developers.anpheros.com/hu/guides/fhir-vs-hl7-v2)
- [Távoli betegmegfigyelés FHIR-rel](https://developers.anpheros.com/hu/guides/remote-patient-monitoring-fhir)
- [Webhookok](https://developers.anpheros.com/hu/guides/webhooks)