# FHIR vs HL7 v2: pratik farklar

> Geliştiriciler için HL7 v2 mesajları ve FHIR kaynaklarının karşılaştırması: format, taşıma, her ikisinde de aynı laboratuvar sonucu, çeviri tuzakları ve Anpheros'un v2'yi kabul ettiği yerler.

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

**HL7 v2, 1980'lerin sonlarından beri hastane sistemlerinin alışveriş yaptığı mesaj formatıdır — sistemler arasında bir ağ bağlantısı üzerinden gönderilen "hasta kabul edildi" veya "laboratuvar sonucu hazır" gibi boru hattı sınırlı olaylar — HL7 FHIR ise uygulamaların HTTPS üzerinden JSON olarak Hasta ve Gözlem gibi kaynakları okuyup yazdığı bir web API standardıdır.** Bunlar bir kez seçip bırakacağınız alternatifler değildir: çoğu hastane hala dahili olarak v2 üzerinde çalışır, yeni uygulamalar ve hastaya yönelik API'ler FHIR kullanır ve entegrasyon çalışmaları genellikle birini diğerine çevirmeyi içerir. Bu sayfa, kod yazarken önemli olan noktalarda bunları karşılaştırır, her ikisinde de aynı veriyi gösterir ve Anpheros'un v2'yi nerede kabul ettiğini açıklar.

## Yan Yana

| | HL7 v2 | HL7 FHIR R4 |
|---|---|---|
| Stil | Olaylarla tetiklenen mesajlar (kabul, sipariş, sonuç) | Oluşturduğunuz, okuduğunuz, güncellediğiniz, aradığınız kaynaklar |
| Format | Satır sonlarıyla ayrılmış metin segmentleri, alanlar `\|` ile, bileşenler `^` ile | JSON (veya XML) |
| Taşıma | Genellikle hastane ağı içinde TCP üzerinden MLLP | HTTPS REST |
| Sorgu | Sınırlı; sistemler çoğunlukla iter | Arama parametreleri, `_include`, geçmiş |
| Güvenlik | Ağ düzeyinde (VPN, özel bağlantılar) | OAuth 2.0 / SMART on FHIR, TLS, kapsamlar |
| Esneklik | Birçok isteğe bağlı alan ve yerel Z-segmentleri; her arayüz müzakere edilir | Temel kaynaklar artı profiller (US Core, IPS, European IGs) |
| Tipik kullanıcılar | Hastane içindeki EHR, laboratuvar, radyoloji, faturalama sistemleri | Uygulamalar, hasta erişim API'leri, kurumlar arası değişim, yapay zeka |

En yaygın v2 mesajları:

| Mesaj | Anlamı | En Yakın FHIR Kaynakları |
|---|---|---|
| ADT^A01, A03, A08 | Hasta kabul, taburcu, güncelleme | `Patient`, `Encounter` |
| ORM / OML | Test siparişi | `ServiceRequest` |
| ORU^R01 | Sonuç hazır | `Observation`, `DiagnosticReport` |
| SIU | Planlama | `Appointment` |
| MDM | Belge | `DocumentReference` |

## Her İkisinde de Aynı Laboratuvar Sonucu

Bir ORU^R01 sonuç satırı (OBX segmenti):

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

Bu mesajı içe aktardıktan sonra Anpheros'un sakladığı HL7 FHIR R4 Observation ile aynı sonuç:

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

Alana göre: OBX-3 `code` olur, OBX-5 ve OBX-6 `valueQuantity` olur, OBX-7 `referenceRange`, OBX-8 `interpretation`, OBX-11 `status`, OBX-14 `effectiveDateTime`. HL7, segmentler, veri türleri ve kelime dağarcıkları için eşlemeler içeren resmi bir [HL7 Version 2 to FHIR](https://build.fhir.org/ig/HL7/v2-to-fhir/) uygulama kılavuzu yayınlar.

## Çevirilerin Yanlış Gittiği Yerler

- **Saat Dilimleri.** `20261002074500` gibi v2 zaman damgaları genellikle bir ofset taşımaz; gönderenin saat dilimini bilmeniz gerekir. FHIR, bir zaman mevcut olduğunda her zaman bir dilim gerektirir. (Anpheros, dilimsiz bir v2 zamanını UTC olarak okur; varsa ofseti gönderin.)
- **Yerel Kodlar.** Birçok laboratuvar, LOINC yerine kendi kodlarını OBX-3 alanına yerleştirir. İyi bir çeviri, yerel kodu düşürmek yerine saklar ve mümkün olduğunda LOINC'e eşler.
- **Tekrarlanan Gönderimler.** v2 göndericileri zaman aşımlarında yeniden iletim yapar. Sonuç başına sabit bir tanımlayıcı olmadan, bir FHIR deposu yinelenenlerle dolar.
- **Her Şey İsteğe Bağlı.** Aynı alan, iki gönderici tarafından boş bırakılabilir, tekrarlanabilir veya farklı şekilde kullanılabilir. FHIR tarafını doğrulayın; [FHIR R4 doğrulayıcısı](https://developers.anpheros.com/tools/fhir-validator), çevrilmiş bir kaynağın neleri eksik olduğunu gösterir.
- **Düzeltmeler.** v2 sonuç durumu `C` (düzeltilmiş), mevcut Gözlemi güncellemalı ve geçmişini korumalıdır, ikinci bir tane oluşturmamalıdır.

## Ne zaman hangisini kullanmalı

- **Bir hastane içinde, mevcut sistemler arasında:** v2 genellikle sistemlerin konuştuğu dildir. Bir entegrasyon motoru mesajları yönlendirir ve dönüştürür.
- **Bir uygulama, hasta erişim API'si veya kuruluşlar arası herhangi bir şey oluştururken:** FHIR, OAuth ve izin ile birlikte.
- **Yapay zeka veya analitik beslemek için:** FHIR, çünkü sorgulanabilir, kodlanmış ve sürümlenmiştir.
- **Her ikisi de:** yaygın gerçek dünya deseni — laboratuvardan veya EHR'den v2 almak, FHIR'ı depolamak, uygulamalara FHIR sunmak.

## Anpheros Nerede Yer Alıyor?

Anpheros, hasta kayıtlarını FHIR R4 olarak depolar ve yalnızca bir HL7 v2 mesaj türünü kabul eder: **ORU^R01 laboratuvar sonuçları**. Bu mesajlar HTTPS üzerinden [laboratuvar bağlayıcısına](https://developers.anpheros.com/tr/guides/lab-connector) (`POST /v1/patients/{id}/labs/import` ile `Content-Type: x-application/hl7-v2+er7`) gönderilir. Her OBX, LOINC kodu, referans aralığı ve yorumu ile bir laboratuvar Gözlemi (Observation) haline gelir; rapor kimliği kaynak bilgide (provenance) saklanır ve tekrar gönderilen raporlar atlanır. Yeni bir değere sahip düzeltilmiş bir sonuç (OBX-11 = `C`), `amended` durumuna sahip yeni bir Gözlem olarak saklanır; orijinali olduğu gibi kalır, bu nedenle kaynağınız düzeltmeler gönderiyorsa, önceki Gözlemi `entered-in-error` olarak işaretleyin veya FHIR API aracılığıyla güncelleyin. Çalışan bir örnek [Laboratuvar Sonuçları API'sidir](https://developers.anpheros.com/tr/guides/lab-results-api).

Diğer v2 mesajlarını (ADT, siparişler, planlama) kabul etmez, MLLP üzerinde dinlemez ve v2 göndermez. Bunlar için Anpheros'un önünde bir entegrasyon motoru FHIR'a çevirir ve API aracılığıyla yazar.

## Sıkça Sorulan Sorular

### FHIR, HL7 v2'nin yerini mi alıyor?
Yakında değil. v2, çoğu hastanede omurga olmaya devam ediyor çünkü işe yarıyor ve mevcut sistemlere entegre edilmiş durumda. FHIR, uygulamalar, hasta erişimi ve kuruluşlar arası değişim alanlarında bunun etrafında büyüyor ve ikisi bir arada var oluyor, genellikle aralarında çeviri yapılıyor.

### MLLP nedir?
Minimal Lower Layer Protocol: TCP bağlantısı üzerinden v2 mesajlarını çerçevelemenin basit bir yolu; her mesajın etrafında başlangıç ve bitiş karakterleri ve bir onay (ACK) geri bildirimi bulunur. FHIR bunun yerine HTTPS kullanır.

### HL7 v2 mesajlarını otomatik olarak FHIR'a dönüştürebilir miyim?
Çoğunlukla. HL7'nin v2'den FHIR'a uygulama kılavuzu standart eşlemeler sunar ve entegrasyon motorları bunları uygular. Yerel kodlar, Z-segmentleri, saat dilimleri ve her göndericinin isteğe bağlı alanları nasıl kullandığı için manuel çalışma beklenir.

### Anpheros, HL7 v2'yi kabul ediyor mu?
Evet, laboratuvar sonuçları için: laboratuvar bağlayıcısına HTTPS üzerinden gönderilen ORU^R01 mesajları FHIR Observations'a dönüşür. Diğer v2 mesaj türleri ve MLLP bağlantıları desteklenmez.

## İlgili Konular

- [HL7 v2'den FHIR'a eşleme](https://developers.anpheros.com/tr/guides/hl7-v2-to-fhir-mapping): segment ve alan eşlemesi ve bir dönüştürücü
- [Laboratuvar sonuçları API'si: HL7 v2, FHIR ve LOINC](https://developers.anpheros.com/tr/guides/lab-results-api)
- [Bir FHIR kaydına laboratuvar sonuçlarının nasıl aktarılacağı](https://developers.anpheros.com/tr/guides/import-lab-results-fhir)
- [Sağlık verisi birlikte çalışabilirliği](https://developers.anpheros.com/tr/guides/interoperability)
- [DICOM ve FHIR: görüntüleme verileri ve klinik veriler](https://developers.anpheros.com/tr/guides/dicom-vs-fhir)
- [FHIR platformu](https://developers.anpheros.com/tr/guides/fhir)