Standardy

CDA vs FHIR: dokumenty vs. zdroje, kdy se co hodí a jak mezi nimi převádět

CDA je standard pro dokumenty: jeden podepsaný XML soubor, který zůstává jako celek. FHIR je standard pro zdroje: malé, adresovatelné části, které API poskytuje a aktualizuje. Co tento rozdíl znamená v praxi, jak dokumenty FHIR (Composition v Bundle) spojují obojí, kdy je CDA stále vyžadováno a jak funguje převod.

od Publikováno Přečteno za 6 min

Stručně: CDA vám poskytne jeden dokument: podepsaný XML soubor o jednom pacientovi v jednom okamžiku, s textem, který čte člověk, a záznamy, které může číst počítač, a který musí zůstat neporušený a nezměněný. FHIR vám poskytne zdroje: Pacient, čtyřicet Pozorování, tři Stavy, každý s vlastní URL, načítaný, vyhledávaný a aktualizovaný nezávisle přes REST API. FHIR může také seskupit zdroje do dokumentu (Bundle typu document vedený Composition), což je přímý ekvivalent CDA. Zvolte CDA tam, kde to vyžaduje předpis nebo partner; zvolte FHIR pro API, aplikace a cokoli, co musí být dotazováno, nikoli čteno.

Dva tvary

CDA a FHIR mají dva různé tvary. CDA vyměňuje celé XML dokumenty postavené na datových typech HL7 v3, identifikované OID, s povinným textovým popisem, bez dotazování, bez aktualizací a s podepisováním celého dokumentu. FHIR vyměňuje jednotlivé JSON nebo XML zdroje nebo svazky (Bundles), identifikované kanonickými URL, s vestavěným REST dotazováním, verzovanými aktualizacemi a profily publikovanými v implementačních průvodcích.

CDA / C-CDA FHIR
Jednotka výměny Celý dokument Zdroj, nebo Bundle zdrojů
Formát XML, datové typy HL7 v3 JSON nebo XML, datové typy FHIR
Identifikace OID pro šablony a kódové systémy URL (kanonické) pro profily a kódové systémy
Lidsky čitelná část Povinná <text> v každé sekci Volitelný text.div narativ pro každý zdroj; povinný v dokumentech
Přenos Není definován; přenášen přes XDS, Direct, MLLP, email REST přes HTTPS definovaný standardem; také zprávy a dokumenty
Dotazování Není možné uvnitř dokumentu; registry indexují hlavičku Vestavěné: GET /Observation?patient=…&code=…
Aktualizace Nikdy; nový dokument nahrazuje starý Zdroje jsou verzovány a aktualizovány na místě
Podepisování Celý dokument, XML-DSig Možný celý Bundle; jednotlivé zdroje zřídka podepisovány
Profily Šablony (templateId) pro sekci a záznam Profily StructureDefinition pro zdroj, publikované v implementačních průvodcích
Terminologie Kódy sekcí LOINC, záznamy SNOMED/ICD/RxNorm Stejné kódové systémy, jako CodeableConcept

Co rozdíl znamená v praxi

V praxi je rozdíl mezi CDA a FHIR v tom, že CDA je vhodná pro obsah napsaný jednou a uchovaný vcelku, jako je podepsaná propouštěcí zpráva, zatímco FHIR je vhodná pro data, která rostou a jsou dotazována, jako je série měření krevního tlaku. Příjemce CDA může obsah zobrazit, ale musí ho upravit, aby ho mohl importovat; příjemce FHIR získá zdroje již naformátované jako svůj vlastní záznam.

Výpis z nemocnice je přirozeně dokument: je napsán jednou, podepsán jedním lékařem a musí být reprodukovatelný roky později přesně tak, jak byl přečten. Série měření krevního tlaku je přirozeně sada zdrojů: každý den roste, je vykreslována a filtrována a nikdo ji nepodepisuje. CDA zvládá první dobře a druhé špatně (pro každé nové měření byste znovu posílali celý dokument). FHIR zvládá druhé nativně a první prostřednictvím svého mechanismu dokumentů.

Další praktický rozdíl je co může příjemce udělat. Příjemce CDA může vždy zobrazit dokument; import jeho záznamů vyžaduje usmíření, sekci po sekci. Příjemce FHIR získá zdroje, které jsou již ve tvaru jeho vlastního záznamu; složité otázky se přesouvají na identitu (je to stejný pacient?) a původ (kdo to potvrdil a kdy?). Viz Potvrzení pacienta.

FHIR dokumenty: místo setkání

FHIR dokument je Bundle s type: "document", jehož prvním záznamem je Composition. Composition hraje roli hlavičky CDA a seznamu sekcí: typ (LOINC), datum, autor, předmět, správce, stav a section[] s názvem, kódem, narativním textem a odkazy na zdroje, které nesou data.

{
  "resourceType": "Bundle",
  "type": "document",
  "identifier": {"system": "urn:ietf:rfc:3986", "value": "urn:uuid:3f2d7a3e-…"},
  "timestamp": "2026-03-14T10:15:00+01:00",
  "entry": [
    {"fullUrl": "urn:uuid:comp-1", "resource": {
      "resourceType": "Composition", "status": "final",
      "type": {"coding": [{"system": "http://loinc.org", "code": "60591-5", "display": "Patient summary Document"}]},
      "subject": {"reference": "urn:uuid:pat-1"},
      "date": "2026-03-14T10:15:00+01:00",
      "author": [{"reference": "urn:uuid:prac-1"}],
      "title": "Patient summary",
      "section": [{
        "title": "Allergies and intolerances",
        "code": {"coding": [{"system": "http://loinc.org", "code": "48765-2"}]},
        "text": {"status": "generated", "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>Penicillin: rash</p></div>"},
        "entry": [{"reference": "urn:uuid:allergy-1"}]
      }]
    }},
    {"fullUrl": "urn:uuid:pat-1", "resource": {"resourceType": "Patient", "id": "pat-1"}},
    {"fullUrl": "urn:uuid:prac-1", "resource": {"resourceType": "Practitioner", "id": "prac-1"}},
    {"fullUrl": "urn:uuid:allergy-1", "resource": {"resourceType": "AllergyIntolerance", "id": "allergy-1", "patient": {"reference": "urn:uuid:pat-1"}, "code": {"coding": [{"system": "http://snomed.info/sct", "code": "764146007", "display": "Penicillin"}]}}}
  ]
}

Mezinárodní souhrn pacienta je přesně toto: profil FHIR dokumentu, s dvojníkem CDA pro systémy, které jej stále potřebují. Viz také Vysvětlení FHIR Bundle.

Převod mezi nimi

Převod mezi CDA a FHIR funguje oběma směry s omezeními. Implementační průvodce HL7 C-CDA on FHIR mapuje typy dokumentů, sekce a položky na profily Composition a zdroje; sekce pouze s textovým popisem se stanou textem bez dat. Převod z FHIR do CDA funguje pro zdroje, které odpovídají šablonám C-CDA. V obou směrech by měl být originál uchován jako DocumentReference s Provenance.

  • CDA → FHIR: implementační průvodce HL7 C-CDA on FHIR mapuje americké typy dokumentů a sekce na profily Composition; záznamy mapují na zdroje (Problem Concern Act → Condition, Medication Activity → MedicationStatement, Result Observation → Observation). Mapování je deterministické pro dobře šablonovaný obsah úrovně 3 a ztrátové pro sekce pouze s narativem, které se stanou textem bez dat.
  • FHIR → CDA: možné pro dokumenty, jejichž zdroje odpovídají šablonám C-CDA. Volné FHIR zdroje, které nikdy nebyly zamýšleny jako dokument (proud pozorování z nositelných zařízení), se nestanou smysluplným CDA.
  • Ponechte originál. V obou směrech konverze uložte zdroj tak, jak byl přijat, jako DocumentReference, a nechte Provenance odkazovat z konvertovaných zdrojů na něj. Konverze je pohled, nikoli náhrada.

Kdy je CDA stále správnou odpovědí

CDA je stále správnou odpovědí, když ji vyžaduje příjemce (přechody péče v USA, souhrn pacienta a elektronický předpis v rámci MyHealth@EU, několik národních registrů dokumentů), když je obsah právně považován za dokument, který musí být podepsán a uchován vcelku, nebo když je infrastruktura partnera IHE XDS, která indexuje dokumenty namísto zdrojů. V ostatních případech začněte s FHIR.

Když to vyžaduje příjemce (americké přechody péče, mezinárodní souhrn pacienta a elektronický předpis dnes, několik národních registrů dokumentů); když je obsah právně dokumentem, který musí být podepsán a uchován vcelku; když je infrastruktura partnera IHE XDS, která indexuje dokumenty a nikoli zdroje. Ve všech ostatních případech začněte s FHIR a vytvořte FHIR dokument tam, kde je dokument potřeba.

Související stránky

Zdroje

Časté otázky

Je FHIR dokument jen CDA v JSON?

Ne. Sdílí principy (celý, podepsaný, lidsky čitelný, s hlavičkou), ale jeho obsah jsou běžné FHIR zdroje, takže stejné Observation může žít v dokumentu a být obsluhováno API. V CDA existuje záznam pouze uvnitř svého dokumentu.

Mohu podepsat FHIR dokument?

Ano. Bundle.signature drží digitální podpis nad balíčkem a IPS a národní průvodci popisují jak. V praxi se mnoho nasazení spoléhá na bezpečnost přenosu a původ spíše než na podpisy.

Má FHIR templateId?

Ekvivalentem je meta.profile, seznam kanonických URL StructureDefinitions, ke kterým se zdroj hlásí. Validátory kontrolují shodu způsobem, jakým CDA schematrony kontrolují šablony.

Co by si měl vybrat nový národní program?

Nejnovější programy (formát výměny EHDS, pravidla přístupu pacientů v USA, IPS) si vybírají FHIR, s FHIR dokumenty pro souhrny a dopisy, a ponechávají cestu CDA pouze pro starší partnery.

Anpheros Platform

Vyzkoušejte zdarma v sandboxu

První volání FHIR za 5 minut. API standardu HL7 FHIR R4 s integrovaným souhlasem pacienta: vyzkoušejte si ho v sandboxu a poté propojte svou vlastní aplikaci nebo klinický systém.

Zdarma · 30 syntetických pacientů · bez karty

Tento návod slouží pouze pro informační účely a nenahrazuje lékařskou radu. Ohledně rozhodnutí o svém zdraví se poraďte se svým lékařem. V naléhavém případě volejte místní tísňové číslo (v Evropě 112).
Napsal
Tým Anpheros

Anpheros vytváří zdravotní záznamy, které pacient ovládá a může sdílet s jakoukoli klinikou, na platformě HL7 FHIR R4 se sídlem v EU. Tyto průvodce vám pomohou porozumět vašemu zdraví a uspořádat si ho; nenahrazují vašeho lékaře.

O Anpheros →