# Laboratuvar bağlayıcısı

> Tüm laboratuvar raporunu CSV, HL7 v2 ORU^R01 veya JSON olarak gönderin ve LOINC kodları ve referans aralıkları ile laboratuvar Gözlemleri alın.

Source: https://developers.anpheros.com/tr/guides/lab-connector

Bir laboratuvar (veya laboratuvar raporu tutan herhangi biri) tüm raporu tek bir istekte gönderir ve
platform her bir sonucu hastanın bir laboratuvarı `Observation` haline getirir:

```
POST /v1/patients/{patient_id}/labs/import
Authorization: Bearer <project key>
Content-Type: text/csv | x-application/hl7-v2+er7 | application/json
X-Anpheros-Source-System: labx        (optional; recorded in Provenance)
Idempotency-Key: <report id>          (optional; a retry returns the same answer)
```

## Formatlar

**CSV** başlık satırı ile; ayırıcılar `,` `;` veya sekme, ondalık virgül kabul edilir, tarihler ISO,
`DD.MM.YYYY` veya `DD/MM/YYYY`. Tanınan sütunlar (Rumence veya İngilizce): işaretleyici
(`analiza`, `test`, `marker`, `name`) — veya yalnızca bir LOINC `code` sütunu, bu durumda LOINC adı işaretleyici olur —
değer (`rezultat`, `valoare`, `value`, `result`), birim (`um`, `unitate`, `unit`),
referans aralığı (`interval`, `referinta`: `70-100`, `<5`, `>3.5`) veya `ref_low`/`ref_high`,
tarih (`data`, `recoltare`), isteğe bağlı LOINC (`loinc`, `code`), not.

```
Analiza;Rezultat;UM;Interval de referinta;Data
Hemoglobina glicozilata (HbA1c);6,4;%;4,0-5,6;01.09.2026
TSH;2,1;mUI/L;0,4-4,0;01.09.2026
```

**HL7 v2 ORU^R01** (ER7 metni, segmentler CR veya LF ile ayrılmış): `OBX-3` tanımlayıcı (`code^text^LN`
LOINC'dir; yerel bir kod (`^L`, `^99zzz`) veya başka herhangi bir kodlama sistemi, laboratuvarın kendi kodu olarak saklanır
`urn:anpheros:lab-code`), `OBX-5` değer (`NM`, `SN` veya metin),
`OBX-6` birim, `OBX-7` referans aralığı, `OBX-8` anormal bayrak → `interpretation`, `OBX-11` durum,
`OBX-14` veya `OBR-7` tarih; `OBR-3`/`MSH-10`, Provenance'da rapor kimliği olur.

**Laboratuvar.** Her sonuç, HL7 Europe Laboratory Report 2.1.0'ın gerektirdiği gibi `performer`'da kimin ürettiğini belirtir:
kuruluş (`X-Anpheros-Acting-As`), aksi takdirde HL7 için `MSH-4` (gönderen tesis) veya
JSON'da `laboratory` (üst düzey veya öğe başına). Bir CSV laboratuvar taşımaz; bu tür sonuçlar eksik
performansla doğrulanır, ki bu gerçektir.

**Metin raporları, belgeler ve eksik tarihler.** Bir metin raporu, her satır bir OBX (`TX`/`FT`, aynı `OBX-3`)
olarak gönderilir, satırlar birleştirilerek tek bir sonuç olur. `OBX-5`'daki (`ED` veya `Base64` olarak kodlanmış herhangi bir değer) tam bir belge
bir sonuç olarak saklanmaz; yanıt uyarır ve belge `/documents`'a aittir. `OBR-7` olmadan, sonuçlar `OBR-14` (numune alındı) tarafından tarihlendirilir
ve bir uyarı ile.

**Saatler ve saat dilimleri.** Saat dilimi olmayan bir v2 saati, UTC değil, gönderenin yerel saatidir. `OBX-14`/`OBR-7` (`20260901081000+0300`) ile gönderilen ofset saklanır (`2026-09-01T08:10:00+03:00`).
Biri olmadan, `MSH-7`'nın ofseti kullanılır ve bir uyarı bunu belirtir; hiçbir ofset olmadan, sonuç yalnızca tarihini saklar, bu da bir uyarı ile birlikte gelir. CSV saatleri
(`01.09.2026 08:10`) saat dilimi taşımaz, bu nedenle yalnızca tarih olarak saklanır. 17 Ekim 2026'ya kadar bu saatler
UTC olarak etiketlenmişti; o zaman içe aktarılan sonuçlar tanımlayıcılarını korur ve bir rapor tekrar gönderildiğinde hala tanınır.

Hala bekleyen (OBX-11 `I`), elde edilemeyen (`X`), silinmiş (`D`) veya yanlış (`W`) HL7 sonuçları ve değeri olmayan OBX segmentleri
Gözlemler olmaz; her biri `warnings`'de adlandırılır.

**JSON**: `{"date": "2026-09-01", "origin": "report-77", "laboratory": "Synevo", "items": [{"marker": "TSH", "value": 2.1, "unit": "mUI/L", "ref_low": 0.4, "ref_high": 4.0, "date": "2026-09-01", "code": "3016-3"}]}`.

## Geri Döndürülenler

```json
{"created": 3, "skipped": 0, "unmapped": ["Marker foarte rar"], "warnings": [],
 "observations": [{"id": "…", "marker": "TSH", "code": "3016-3", "system": "http://loinc.org", "value": 2.1, "unit": "mUI/L", "date": "2026-09-01"}]}
```

- Rapor bir LOINC kodu verdiğinde veya ad, platformun terminolojisiyle (Romence ve İngilizce adlar ve yaygın takma adlar) eşleştiğinde işaretleyiciler **LOINC**'e eşlenir. Diğerleri, laboratuvarın kodunu `urn:anpheros:lab-code` altında, rapordan tam metniyle saklar ve sizin tarafınızda eşlemeyi iyileştirebilmeniz için `unmapped`'te listelenir. Bir laboratuvarın kendi kodu, yalnızca laboratuvarıyla birlikte benzersizdir: kaynak sistem, her Gözlem'in Provenance'ında (`X-Anpheros-Source-System`) kaydedilir.
- Adlar, LOINC adları ve eş anlamlılarıyla (örneğin *Hemoglobin A1c*, *Glikozillenmiş hemoglobin*, *HDL kolesterol*, *LDL-C*) eşleştirilir. Birden çok kavramla eşleşen veya kavramın sahip olmadığı bir niteleyici taşıyan bir ad (*idrar*, *non-HDL*, *serbest*, *oran*…), tahmin edilmez: laboratuvarın kodunu saklar ve `unmapped`'de listelenir. Sisteminizde LOINC kodları varsa, lütfen bunları gönderin.
- Üre ve üre nitrojeni (BUN) farklı ölçümlerdir: *Üre* / *Urea*, üreye (LOINC `3091-6` veya mmol/L cinsinden `22664-7`) eşlenir, *BUN* / *Üre nitrojeni* / *Azot ureic*, üre azotuna (`3094-0` veya mmol/L cinsinden `14937-7`) eşlenir. Değerler asla dönüştürülmez.
- LDL kolesterol: bir yöntem içermeyen bir ad `2089-1`'ye eşlenir; *hesaplanmış* / *calculated* / *Friedewald*, hesaplanmış LDL'ye (`13457-7`); *direkt*, direkt analize (`18262-6`) eşlenir. Yöntem, *Bilirubina directa* gibi *direkt* gibi bir niteleyicidir, bu toplam bilirubin değildir ve laboratuvarın kodunu saklar.
- Glikoz: bir laboratuvar raporundaki boş bir "Glicemie" / "Glucose", serum veya plazmaya (LOINC `2345-7`) eşlenir; kapiler, parmak ucu veya tam kan ("capilar", "sânge integral") belirten bir ad, tam kana (`2339-0`) eşlenir. Rapordaki bir LOINC kodu her zaman önceliklidir.
- Her satır, raporda belirtilenlerden — rapor kimliği, rapordaki ad ve kod, tarih, değer ve birim — platformun seçtiği LOINC kodundan değil, oluşturulan kararlı bir tanımlayıcı (`urn:anpheros:lab-import:v2`) alır, bu nedenle **aynı raporun yeniden gönderilmesi, zaten içe aktarılan satırları atlar** (`skipped`), eşleme iyileştirildikten sonra bile. Bu unsurlardan herhangi birinde farklılık gösteren satırlar (başka bir rapor, başka bir toplama zamanı, başka bir değer) ayrı tutulur. 14 Ekim 2026'dan önce içe aktarılan sonuçlar orijinal tanımlayıcılarını korur ve ad, tarih, değer, birim ve rapor kimliğine göre tanınır. Rapor kimliği olmadan (CSV) böyle bir eşleşme `warnings`'da bildirilir; ayrı raporları ayırmak için bir rapor kimliği (HL7 `OBR-3`/`MSH-10`, JSON `origin`) gönderin.
- Her Gözlem, `author_type = import`, kaynak sisteminiz ve rapor kimliği ile Provenance taşır; web kancaları Gözlem başına `resource.created` tetikler; hasta sonuçları uygulamasında görür ve onay verdiği herhangi bir uygulama bunları okuyabilir.
- İstek başına 500 satıra kadar.

Her iki SDK: `labs.importCsv`, `labs.importHl7`, `labs.importItems`.

Bir CSV ve bir HL7 v2 raporundan FHIR Gözlemlerine, eşlenmemiş işaretleyiciler ve yeniden gönderilen raporlarla çalışılmış bir örnek: [Laboratuvar sonuçlarını bir FHIR kaydına nasıl aktarılır](https://developers.anpheros.com/tr/guides/import-lab-results-fhir).

Laboratuvar verileri laboratuvarlar, klinikler, uygulamalar ve yapay zeka arasında nasıl hareket eder ve bir laboratuvar sonuçları API'sinde nelere dikkat edilmelidir: [Laboratuvar Sonuçları API'si](https://developers.anpheros.com/tr/guides/lab-results-api).