# FHIR vs HL7 v2: praktické rozdiely

> Správy HL7 v2 a zdroje FHIR porovnané pre vývojárov: formát, transport, rovnaký laboratórny výsledok v oboch, nástrahy prekladu a kde Anpheros akceptuje v2.

Source: https://developers.anpheros.com/sk/guides/fhir-vs-hl7-v2

**HL7 v2 je formát správ, ktorý nemocničné systémy vymieňajú od konca 80. rokov – udalosti oddelené znakom pipe ( "|" ), ako napríklad „pacient prijatý“ alebo „laboratórny výsledok pripravený“, tlačené medzi systémami cez sieťové pripojenie – zatiaľ čo HL7 FHIR je štandard webového API, kde aplikácie čítajú a zapisujú zdroje ako Patient a Observation cez HTTPS v JSON.** Nie sú to alternatívy, ktoré si vyberiete raz: väčšina nemocníc stále interne funguje na v2, nové aplikácie a API orientované na pacienta používajú FHIR a integračná práca často spočíva v preklade jedného do druhého. Táto stránka ich porovnáva z hľadiska bodov, na ktorých záleží pri písaní kódu, zobrazuje rovnaké údaje v oboch a vysvetľuje, kde Anpheros akceptuje v2.

## Vedľa seba

| | HL7 v2 | HL7 FHIR R4 |
|---|---|---|
| Štýl | Správy spúšťané udalosťami (prijatie, objednávka, výsledok) | Zdroje, ktoré vytvárate, čítate, aktualizujete, vyhľadávate |
| Formát | Textové segmenty oddelené novými riadkami, polia pomocou `\|`, komponenty pomocou `^` | JSON (alebo XML) |
| Transport | Zvyčajne MLLP cez TCP v rámci nemocničnej siete | HTTPS REST |
| Dotaz | Obmedzený; systémy väčšinou posielajú dáta | Vyhľadávacie parametre, `_include`, história |
| Bezpečnosť | Na úrovni siete (VPN, súkromné linky) | OAuth 2.0 / SMART on FHIR, TLS, scopes |
| Flexibilita | Mnoho voliteľných polí a lokálnych Z-segmentov; každý interfejs je dohodnutý | Základné zdroje plus profily (US Core, IPS, European IGs) |
| Typickí používatelia | EHR, laboratórne, rádiologické, fakturačné systémy v rámci nemocnice | Aplikácie, API pre prístup pacienta, medziorganizačná výmena, AI |

Najbežnejšie v2 správy:

| Správa | Význam | Najbližšie FHIR zdroje |
|---|---|---|
| ADT^A01, A03, A08 | Prijatie, prepustenie, aktualizácia pacienta | `Patient`, `Encounter` |
| ORM / OML | Objednanie testu | `ServiceRequest` |
| ORU^R01 | Výsledok pripravený | `Observation`, `DiagnosticReport` |
| SIU | Plánovanie | `Appointment` |
| MDM | Dokument | `DocumentReference` |

## Rovnaký laboratórny výsledok v oboch

Riadok výsledku ORU^R01 (segment OBX):

```
OBX|1|NM|2093-3^Cholesterol^LN||212|mg/dL|<200|H|||F|||20261002074500
```

Rovnaký výsledok ako HL7 FHIR R4 Observation, ako ho Anpheros uchováva po importe správy:

```json
{
  "resourceType": "Observation",
  "status": "final",
  "category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/observation-category", "code": "laboratory"}]}],
  "code": {"coding": [{"system": "http://loinc.org", "code": "2093-3", "display": "Cholesterol [Mass/volume] in Serum or Plasma"}], "text": "Cholesterol"},
  "effectiveDateTime": "2026-10-02T07:45:00Z",
  "valueQuantity": {"value": 212.0, "unit": "mg/dL"},
  "interpretation": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation", "code": "H"}]}],
  "referenceRange": [{"high": {"value": 200.0, "unit": "mg/dL"}}]
}
```

Pole po poli: OBX-3 sa stáva `code`, OBX-5 a OBX-6 sa stávajú `valueQuantity`, OBX-7 `referenceRange`, OBX-8 `interpretation`, OBX-11 `status`, OBX-14 `effectiveDateTime`. HL7 publikuje oficiálny [HL7 Version 2 to FHIR](https://build.fhir.org/ig/HL7/v2-to-fhir/) implementačný sprievodca s mapovaniami pre segmenty, dátové typy a slovníky.

## Kde preklady zlyhávajú

- **Časové zóny.** Časové značky v2, ako napríklad `20261002074500`, často neobsahujú časový posun; musíte poznať zónu odosielateľa. FHIR vyžaduje zónu vždy, keď je čas prítomný. (Anpheros číta v2 čas bez zóny ako UTC; pošlite posun, ak ho máte.)
- **Lokálne kódy.** Mnoho laboratórií používa svoje vlastné kódy v OBX-3 namiesto LOINC. Dobrý preklad zachová lokálny kód a mapuje ho na LOINC, ak je to možné, namiesto jeho vynechania.
- **Opakované odosielanie.** Odosielatelia v2 opätovne prenášajú pri časových obmedzeniach. Bez stabilného identifikátora na výsledok sa FHIR úložisko zaplní duplicitami.
- **Všetko je voliteľné.** To isté pole môže byť prázdne, opakované alebo použité dvoma odosielateľmi odlišne. Validujte stranu FHIR; [FHIR R4 validátor](https://developers.anpheros.com/tools/fhir-validator) ukazuje, čo preloženému zdroju chýba.
- **Opravy.** Stav výsledku v2 `C` (opravený) by mal aktualizovať existujúce Observation a zachovať jeho históriu, nie vytvoriť druhý.

## Kedy použiť čo

- **Vo vnútri nemocnice, medzi existujúcimi systémami:** v2 je zvyčajne to, čomu systémy rozumejú. Integračný engine smeruje a transformuje správy.
- **Pri vytváraní aplikácie, API pre prístup pacienta alebo čohokoľvek, čo prekračuje organizácie:** FHIR, s OAuth a súhlasom.
- **Na napájanie AI alebo analytiky:** FHIR, pretože je dotazovateľný, kódovaný a verzovaný.
- **Oboje:** bežný vzor v reálnom svete – prijímať v2 z laboratória alebo EHR, ukladať FHIR, poskytovať FHIR aplikáciám.

## Kde Anpheros zapadá

Anpheros ukladá záznamy pacientov ako FHIR R4 a akceptuje jeden typ správy HL7 v2: **ORU^R01 výsledky laboratórnych testov**, odosielané cez HTTPS do [lab konektora](https://developers.anpheros.com/sk/guides/lab-connector) (`POST /v1/patients/{id}/labs/import` s `Content-Type: x-application/hl7-v2+er7`). Každý OBX sa stáva laboratórnym Observation s LOINC kódom, referenčným rozsahom a interpretáciou; ID správy sa uchováva v pôvode a duplicitné správy sa preskakujú. Opravený výsledok (OBX-11 = `C`) s novou hodnotou sa uloží ako nový Observation so stavom `amended`; pôvodný zostáva tak, ako bol, takže ak váš zdroj posiela opravy, označte skorší Observation `entered-in-error` alebo ho aktualizujte prostredníctvom FHIR API. Pracovný príklad nájdete v [Lab results API](https://developers.anpheros.com/sk/guides/lab-results-api).

Neprijíma iné v2 správy (ADT, objednávky, plánovanie), nepočúva na MLLP a neposiela v2. Pre tieto účely integračný engine pred Anpherosom prekladá do FHIR a zapisuje cez API.

## Často kladené otázky

### Nahrádza FHIR HL7 v2?
Zatiaľ nie. v2 zostáva chrbticou vo väčšine nemocníc, pretože funguje a je integrovaný do existujúcich systémov. FHIR rastie okolo neho – v aplikáciách, prístupe pacientov a výmene medzi organizáciami – a tieto dva štandardy koexistujú, často s prekladom medzi nimi.

### Čo je MLLP?
Minimal Lower Layer Protocol: jednoduchý spôsob rámcovania správ v2 cez TCP pripojenie, so znakmi začiatku a konca okolo každej správy a potvrdením (ACK) späť. FHIR namiesto toho používa HTTPS.

### Môžem automaticky konvertovať správy HL7 v2 na FHIR?
Vo väčšine prípadov. Sprievodca implementáciou HL7 v2-to-FHIR poskytuje štandardné mapovania a integračné enginy ich implementujú. Očakávajte manuálnu prácu pre lokálne kódy, Z-segmenty, časové zóny a spôsob, akým každý odosielateľ používa voliteľné polia.

### Akceptuje Anpheros HL7 v2?
Áno, pre laboratórne výsledky: správy ORU^R01 odoslané cez HTTPS do laboratórneho konektora sa stanú FHIR Observations. Iné typy správ v2 a MLLP pripojenia nie sú podporované.

## Súvisiace

- [Mapovanie HL7 v2 na FHIR](https://developers.anpheros.com/sk/guides/hl7-v2-to-fhir-mapping): mapovanie segmentov a polí, a konvertor
- [API pre laboratórne výsledky: HL7 v2, FHIR a LOINC](https://developers.anpheros.com/sk/guides/lab-results-api)
- [Ako importovať laboratórne výsledky do záznamu FHIR](https://developers.anpheros.com/sk/guides/import-lab-results-fhir)
- [Interoperabilita zdravotníckych údajov](https://developers.anpheros.com/sk/guides/interoperability)
- [DICOM vs FHIR: obrazové údaje a klinické údaje](https://developers.anpheros.com/sk/guides/dicom-vs-fhir)
- [Platforma FHIR](https://developers.anpheros.com/sk/guides/fhir)