# FHIR vs HL7 v2: praktické rozdíly

> Zprávy HL7 v2 a zdroje FHIR porovnány pro vývojáře: formát, přenos, stejný laboratorní výsledek v obou, úskalí překladu a kde Anpheros přijímá v2.

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

**HL7 v2 je formát zpráv, který si nemocniční systémy vyměňují od konce 80. let – události oddělené znakem „pipe“ (např. „pacient přijat“ nebo „laboratorní výsledek připraven“), které jsou posílány mezi systémy přes síťové připojení – zatímco HL7 FHIR je standard webového API, kde aplikace čtou a zapisují zdroje jako Patient a Observation přes HTTPS ve formátu JSON.** Nejedná se o alternativy, které si vyberete jednou provždy: většina nemocnic stále interně používá v2, nové aplikace a rozhraní pro pacienty používají FHIR a integrační práce často spočívá v překladu jednoho do druhého. Tato stránka je porovnává z hledisek, na kterých záleží při psaní kódu, ukazuje stejná data v obou formátech a vysvětluje, kde Anpheros přijímá v2.

## Vedle sebe

| | HL7 v2 | HL7 FHIR R4 |
|---|---|---|
| Styl | Zprávy spouštěné událostmi (přijetí, objednávka, výsledek) | Zdroje, které vytváříte, čtete, aktualizujete, vyhledáváte |
| Formát | Textové segmenty oddělené novými řádky, pole znakem `\|`, komponenty znakem `^` | JSON (nebo XML) |
| Přenos | Obvykle MLLP přes TCP uvnitř nemocniční sítě | HTTPS REST |
| Dotazování | Omezené; systémy většinou posílají data | Vyhledávací parametry, `_include`, historie |
| Zabezpečení | Na úrovni sítě (VPN, privátní propojení) | OAuth 2.0 / SMART on FHIR, TLS, scopes |
| Flexibilita | Mnoho volitelných polí a lokálních Z-segmentů; každé rozhraní je dojednáno | Základní zdroje plus profily (US Core, IPS, European IGs) |
| Typičtí uživatelé | EHR, laboratorní, radiologické, fakturační systémy uvnitř nemocnice | Aplikace, API pro přístup pacientů, mezioborová výměna dat, AI |

Nejběžnější zprávy v2:

| Zpráva | Význam | Nejpodobnější FHIR zdroje |
|---|---|---|
| ADT^A01, A03, A08 | Přijetí, propuštění, aktualizace pacienta | `Patient`, `Encounter` |
| ORM / OML | Objednání testu | `ServiceRequest` |
| ORU^R01 | Výsledek připraven | `Observation`, `DiagnosticReport` |
| SIU | Plánování | `Appointment` |
| MDM | Dokument | `DocumentReference` |

## Stejný laboratorní výsledek v obou

Řádek výsledku ORU^R01 (segment OBX):

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

Stejný výsledek jako HL7 FHIR R4 Observation, jak jej Anpheros ukládá po importu této zprá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 se stává `code`, OBX-5 a OBX-6 se stávají `valueQuantity`, OBX-7 `referenceRange`, OBX-8 `interpretation`, OBX-11 `status`, OBX-14 `effectiveDateTime`. HL7 publikuje oficiální [HL7 Version 2 to FHIR](https://build.fhir.org/ig/HL7/v2-to-fhir/) implementační průvodce s mapováním segmentů, datových typů a slovníků.

## Kde překlady selhávají

- **Časová pásma.** Časová razítka v2, jako je `20261002074500`, často neobsahují žádný posun; musíte znát zónu odesílatele. FHIR vyžaduje zónu, kdykoli je přítomen čas. (Anpheros čte čas v2 bez zóny jako UTC; odešlete posun, pokud jej máte.)
- **Lokální kódy.** Mnoho laboratoří vkládá své vlastní kódy do OBX-3 místo LOINC. Dobrý překlad zachovává lokální kód a mapuje jej na LOINC, kdykoli je to možné, místo aby jej vynechal.
- **Opakované odesílání.** Odesílatelé v2 znovu přenáší při vypršení časového limitu. Bez stabilního identifikátoru na výsledek se FHIR úložiště zaplní duplicitami.
- **Všechno je volitelné.** Stejné pole může být prázdné, opakované nebo použité odlišně dvěma odesílateli. Validujte stranu FHIR; [FHIR R4 validátor](https://developers.anpheros.com/tools/fhir-validator) ukazuje, co přeloženému zdroji chybí.
- **Opravy.** Stav výsledku v2 `C` (opraveno) by měl aktualizovat existující Observation a zachovat jeho historii, nikoli vytvořit druhou.

## Kdy co použít

- **Uvnitř nemocnice, mezi existujícími systémy:** v2 je obvykle to, co systémy používají. Integrační engine směruje a transformuje zprávy.
- **Vývoj aplikace, API pro přístup pacienta nebo čehokoli, co překračuje organizace:** FHIR, s OAuth a souhlasem.
- **Napájení AI nebo analytiky:** FHIR, protože je dotazovatelný, kódovaný a verzovaný.
- **Obě možnosti:** běžný reálný vzor — příjem v2 z laboratoře nebo EHR, ukládání FHIR, poskytování FHIR aplikacím.

## Kde Anpheros zapadá

Anpheros ukládá záznamy pacientů ve formátu FHIR R4 a přijímá jeden typ zprávy HL7 v2: **ORU^R01 laboratorní výsledky**, zasílané přes HTTPS do [lab konektoru](https://developers.anpheros.com/cs/guides/lab-connector) (`POST /v1/patients/{id}/labs/import` s `Content-Type: x-application/hl7-v2+er7`). Každý OBX se stává laboratorním pozorováním (Observation) s kódem LOINC, referenčním rozsahem a interpretací; ID zprávy je uchováno v původu a duplicitní zprávy jsou přeskočeny. Opravený výsledek (OBX-11 = `C`) s novou hodnotou je uložen jako nové pozorování se stavem `amended`; původní zůstává nezměněn, takže pokud váš zdroj posílá opravy, označte dřívější pozorování `entered-in-error` nebo jej aktualizujte prostřednictvím FHIR API. Pracovní příklad naleznete v [Lab results API](https://developers.anpheros.com/cs/guides/lab-results-api).

Nepřijímá jiné zprávy v2 (ADT, objednávky, plánování), neposlouchá na MLLP a neodesílá v2. Pro tyto účely integrační engine před Anpherosem překládá do FHIR a zapisuje prostřednictvím API.

## Často kladené dotazy

### Nahrazuje FHIR standard HL7 v2?
Zatím ne. v2 zůstává páteří většiny nemocnic, protože funguje a je integrován do stávajících systémů. FHIR se kolem něj rozvíjí – v aplikacích, přístupu pacientů a výměně mezi organizacemi – a oba standardy koexistují, často s překladem mezi nimi.

### Co je MLLP?
Minimal Lower Layer Protocol: jednoduchý způsob rámování zpráv v2 přes TCP spojení, s počátečními a koncovými znaky kolem každé zprávy a potvrzením (ACK) zpět. FHIR místo toho používá HTTPS.

### Mohu automaticky převést zprávy HL7 v2 na FHIR?
Většinou ano. Průvodce implementací HL7 v2-to-FHIR poskytuje standardní mapování a integrační enginy je implementují. Počítejte s manuální prací pro lokální kódy, Z-segmenty, časová pásma a způsob, jakým každý odesílatel používá volitelná pole.

### Přijímá Anpheros standard HL7 v2?
Ano, pro laboratorní výsledky: zprávy ORU^R01 odeslané přes HTTPS do laboratorního konektoru se stanou FHIR Observations. Jiné typy zpráv v2 a MLLP spojení nejsou podporovány.

## Související

- [Mapování HL7 v2 na FHIR](https://developers.anpheros.com/cs/guides/hl7-v2-to-fhir-mapping): mapování segmentů a polí a konvertor
- [API pro laboratorní výsledky: HL7 v2, FHIR a LOINC](https://developers.anpheros.com/cs/guides/lab-results-api)
- [Jak importovat laboratorní výsledky do záznamu FHIR](https://developers.anpheros.com/cs/guides/import-lab-results-fhir)
- [Interoperabilita zdravotnických dat](https://developers.anpheros.com/cs/guides/interoperability)
- [DICOM vs FHIR: obrazová data a klinická data](https://developers.anpheros.com/cs/guides/dicom-vs-fhir)
- [Platforma FHIR](https://developers.anpheros.com/cs/guides/fhir)
