CDA ve FHIR Karşılaştırması: belgeler ve kaynaklar, ne zaman hangisi kullanılır ve nasıl dönüştürülür

Kısa cevap: CDA, size tek bir belge sunar: tek bir anda, tek bir hasta hakkındaki imzalı bir XML dosyası. Bu dosya, insanların okuyabileceği bir anlatım ve bilgisayarların okuyabileceği girişler içerir ve bütünlüğü korunmalıdır. FHIR ise kaynaklar sunar: her biri kendi URL'sine sahip bir Hasta, kırk Gözlem, üç Durum. Bunlar REST API aracılığıyla bağımsız olarak alınabilir, aranabilir ve güncellenebilir. FHIR ayrıca kaynakları bir belgeye (bir document türündeki Bundle, bir Composition tarafından yönetilir) paketleyebilir. Bu, CDA'nın doğrudan karşılığıdır. Bir düzenleme veya iş ortağı gerektiriyorsa CDA'yı, API'ler, uygulamalar ve sorgulanması gereken her şey için FHIR'ı seçin.

İki şekil

CDA ve FHIR'ın iki farklı yapısı vardır. CDA, HL7 v3 veri türleri üzerine kurulu, OID'lerle tanımlanan, zorunlu anlatımı olan, sorgulama veya güncelleme yapmaya izin vermeyen ve tüm belgeyi imzalayan XML belgelerini değiştirir. FHIR ise, yerleşik REST sorgulama, sürümlü güncellemeler ve uygulama kılavuzlarında yayınlanan profillerle, kanonik URL'lerle tanımlanan bireysel JSON veya XML kaynaklarını ya da Bundle'ları değiştirir.

Farkın pratikte anlamı

Pratikte CDA ve FHIR arasındaki fark, CDA'nın bir kez yazılıp bütün olarak saklanan, örneğin imzalı bir taburcu özetine uygun olmasıdır. FHIR ise büyüyen ve sorgulanan, örneğin bir tansiyon serisi gibi verilere uygundur. Bir CDA alıcısı görüntüleyebilir ancak içe aktarmak için uyum sağlaması gerekir; bir FHIR alıcısı ise kendi kaydına benzeyecek şekilde biçimlendirilmiş kaynaklar alır.

Bir taburcu özeti doğal olarak bir belgedir: bir kez yazılır, bir doktor tarafından imzalanır ve yıllar sonra okunduğu gibi aynen yeniden üretilebilmelidir. Bir tansiyon serisi ise doğal olarak bir dizi kaynaktır: her gün büyür, çizilir ve filtrelenir ve kimse tarafından imzalanmaz. CDA ilkinciyi iyi, ikincinciyi ise kötü ele alır (her yeni okuma için tüm belgeyi yeniden göndermeniz gerekir). FHIR ikincinciyi yerel olarak, ilkinciyi ise belge mekanizması aracılığıyla ele alır.

Diğer pratik fark ise alıcının ne yapabileceğidir. Bir CDA alıcısı belgeyi her zaman görüntüleyebilir; girişlerini içe aktarmak, bölüm bölüm uzlaşma gerektirir. Bir FHIR alıcısı, kendi kaydının şeklinde olan kaynakları alır; zorlu sorular kimlik (bu aynı hasta mı?) ve köken (bunu kim ve ne zaman belirtti?) sorularına kayar. Hasta eşleştirme bölümüne bakın.

FHIR belgeleri: buluşma noktası

Bir FHIR belgesi, type: "document" olan ve ilk girişi Composition olan bir Bundle'dır. Composition, CDA başlığı ve bölüm listesinin rolünü üstlenir: tür (LOINC), tarih, yazar, konu, yönetici, durum ve başlık, kod, anlatı metni ve verileri taşıyan kaynaklara referanslar içeren section[].

{
  "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"}]}}}
  ]
}

Uluslararası Hasta Özeti, tam olarak budur: CDA ikizine sahip bir FHIR belge profili, hala ihtiyaç duyan sistemler için. Ayrıca FHIR Bundle açıklaması bölümüne de bakın.

Aralarında dönüştürme

CDA ve FHIR arasında dönüşüm, sınırlamalarla her iki yönde de çalışır. FHIR üzerindeki HL7 C-CDA uygulama kılavuzu, belge türlerini, bölümleri ve girişleri Composition profillerine ve kaynaklarına eşler; yalnızca anlatım içeren bölümler veri olmadan metne dönüşür. FHIR'dan CDA'ya dönüşüm, C-CDA şablonlarına uyan kaynaklar için işe yarar. Her iki yönde de orijinal, Provenance ile birlikte bir DocumentReference olarak saklanmalıdır.

• CDA → FHIR: HL7 C-CDA on FHIR uygulama kılavuzu, ABD belge türlerini ve bölümlerini Composition profillerine eşler; girişler kaynaklara eşlenir (Problem Concern Act → Condition, Medication Activity → MedicationStatement, Result Observation → Observation). Eşleme, iyi şablonlanmış Seviye 3 içerik için deterministik ve yalnızca anlatıdan oluşan bölümler için kayıplıdır, bunlar veri olmadan metne dönüşür.
• FHIR → CDA: C-CDA şablonlarına uyan kaynaklara sahip belgeler için mümkündür. Bir belge olarak tasarlanmamış serbest biçimli FHIR kaynakları (giyilebilir Gözlemler akışı) anlamlı bir CDA oluşturmaz.
• Orijinali saklayın. Hangi yönde dönüştürürseniz dönüştürün, alınan kaynağı bir DocumentReference olarak saklayın ve Dönüşümden (Provenance) kaynakların ona işaret etmesini sağlayın. Dönüştürme bir görünümdür, bir yedekleme değildir.

CDA'nın hala doğru cevap olduğu durumlar

Alıcı tarafın bunu gerektirdiği durumlarda (ABD'deki bakım geçişleri, MyHealth@EU hasta özeti ve e-reçete, çeşitli ulusal belge kayıtları), içeriğin yasal olarak imzalanması ve bütün olarak saklanması gereken bir belge olduğu durumlarda veya ortağın altyapısının kaynaklar yerine belgeleri indeksleyen IHE XDS olduğu durumlarda CDA hala doğru cevaptır. Aksi takdirde FHIR ile başlayın.

Alıcı taraf gerektirdiğinde (ABD geçiş bakımları, MyHealth@EU hasta özeti ve eReçete bugün, çeşitli ulusal belge kayıtları); içerik yasal olarak imzalanması ve bütün olarak korunması gereken bir belge olduğunda; ortağın altyapısı belgeleri indeksleyen ve kaynakları değil, IHE XDS olduğunda. Diğer tüm durumlarda, FHIR ile başlayın ve belge gerektiğinde bir FHIR belgesi oluşturun.

İlgili sayfalar

• CDA ve C-CDA açıklaması
• FHIR Bundle açıklaması
• Uluslararası Hasta Özeti
• HL7 vs FHIR
• DocumentReference vs DiagnosticReport vs Binary
• Hasta eşleştirme

Kaynaklar

• HL7 FHIR R4: Belgeler
• HL7 FHIR R4: Composition
• HL7 C-CDA on FHIR uygulama kılavuzu
• HL7 FHIR: CDA ile karşılaştırması (Ek)
• HL7 FHIR: Uluslararası Hasta Özeti IG

Sık sorulan sorular

Bir FHIR belgesi sadece JSON formatında CDA mıdır?

Hayır. İlkeleri paylaşır (bütün, imzalı, insan tarafından okunabilir, başlığı olan), ancak içeriği sıradan FHIR kaynaklarıdır, bu nedenle aynı Gözlem bir belgede yaşayabilir ve API tarafından sunulabilir. CDA'da bir giriş yalnızca belgesinin içinde bulunur.

Bir FHIR belgesini imzalayabilir miyim?

Evet. Bundle.signature, bundle üzerinde bir dijital imza tutar ve IPS ve ulusal kılavuzlar bunu nasıl yapacağını açıklar. Pratikte birçok dağıtım, imzalardan ziyade taşıma güvenliğine ve kökene dayanır.

FHIR'da templateId var mı?

Karşılığı meta.profile'dır, kaynağın uyduğunu iddia ettiği StructureDefinitions'ın kanonik URL'lerinin bir listesidir. Doğrulayıcılar, CDA şemaları şablonları kontrol ettiği gibi uyumluluğu kontrol eder.

Yeni bir ulusal program hangisini seçmeli?

Son programlar (EHDS değişim formatı, ABD hasta erişim kuralları, IPS) FHIR'ı seçiyor, özetler ve mektuplar için FHIR belgeleri kullanıyor ve yalnızca eski iş ortakları için bir CDA yolu tutuyor.

Anpheros Platform

Sandbox'ta ücretsiz deneyin

İlk FHIR çağrınız 5 dakikada. Hasta izniyle yerleşik HL7 FHIR R4 API: sandbox'ta deneyin, ardından kendi uygulamanızı veya klinik sisteminizi bağlayın.

Ücretsiz sandbox oluşturunGeliştirici kılavuzlarını okuyun →

Ücretsiz · 30 sentetik hasta · kart gerekmez

Yazan

Anpheros Ekibi

Anpheros, hasta kontrolünde olan ve herhangi bir klinik ile paylaşılabilecek, AB merkezli bir HL7 FHIR R4 platformu üzerinde tıbbi kayıtlar oluşturur. Bu rehberler, sağlığınızı anlamanıza ve düzenlemenize yardımcı olur; doktorunuzun yerini tutmaz.

Anpheros Hakkında →