# Laboratóriumi összekötő

> Küldjön egy teljes laboratóriumi jelentést CSV, HL7 v2 ORU^R01 vagy JSON formátumban, és kapjon laboratóriumi megfigyeléseket LOINC kódokkal és referenciatartományokkal.

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

Egy laboratórium (vagy bárki, aki laboratóriumi jelentést birtokol) egyetlen kérésben elküldi a teljes jelentést, és a platform minden eredményt a páciens laboratóriumi `Observation`-ává alakít.

```
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)
```

## Formátumok

**CSV** fejlsorral; elválasztójel `,` `;` vagy tabulátor, tizedesvessző elfogadott, dátumok ISO,
`DD.MM.YYYY` vagy `DD/MM/YYYY`. Felismert oszlopok (román vagy angol): marker
(`analiza`, `test`, `marker`, `name`) — vagy csak egy LOINC `code` oszlop, ebben az esetben a LOINC név lesz a marker —
érték (`rezultat`, `valoare`, `value`, `result`), egység (`um`, `unitate`, `unit`),
referenciatartomány (`interval`, `referinta`: `70-100`, `<5`, `>3.5`) vagy `ref_low`/`ref_high`,
dátum (`data`, `recoltare`), opcionális LOINC (`loinc`, `code`), megjegyzés.

```
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 szöveg, szegmensek CR vagy LF által elválasztva): `OBX-3` azonosító (`code^text^LN`
LOINC; helyi kód (`^L`, `^99zzz`) vagy bármely más kódrendszer a labor saját kódjaként marad
`urn:anpheros:lab-code` alatt), `OBX-5` érték (`NM`, `SN`, vagy szöveg),
`OBX-6` egység, `OBX-7` referenciatartomány, `OBX-8` rendellenességi jelző → `interpretation`, `OBX-11` státusz,
`OBX-14` vagy `OBR-7` dátum; `OBR-3`/`MSH-10` lesz a jelentés azonosítója a Provenance-ben.

**A laboratórium.** Minden eredmény megnevezi, ki állította elő a `performer` mezőben, ahogy az HL7 Europe Laboratory Report 2.1.0
előírja: az Ön által képviselt szervezet (`X-Anpheros-Acting-As`), egyébként a `MSH-4` (küldő létesítmény) HL7 esetén, vagy
a `laboratory` JSON-ban (legfelső szinten vagy tételenként). A CSV nem tartalmaz laboratóriumot; az ilyen eredmények hiányzó
teljesítővel érvényesek, ami a valóság.

**Szöveges jelentések, dokumentumok és hiányzó dátumok.** Egy szöveges jelentés, ahol minden sor egy OBX-nek felel meg (`TX`/`FT`, ugyanaz a `OBX-3`)
egyetlen eredménnyé válik az összekapcsolt sorokkal. Egy teljes dokumentum a `OBX-5` mezőben (`ED`, vagy bármilyen kódolt érték `Base64`) nem
kerül tárolásra eredményként; a válasz figyelmeztet, és a dokumentum a `/documents` mezőbe tartozik. `OBR-7` hiányában az eredményeket a
`OBR-14` (specimen átvétel) dátumozza, figyelmeztetéssel.

**Idők és időzónák.** Időzóna nélküli v2 idő a küldő helyi ideje, nem UTC. A `OBX-14`/`OBR-7` (`20260901081000+0300`) mezőben megadott eltolás megmarad (`2026-09-01T08:10:00+03:00`).
Eltolás hiányában a `MSH-7` eltolása kerül felhasználásra, és erről figyelmeztetés jelenik meg; sehol sincs eltolás, az eredmény csak a dátumát tartja meg, szintén figyelmeztetéssel. A CSV idők (`01.09.2026 08:10`) nem tartalmaznak időzónát, így csak dátumként tárolódnak. 2026. október 17-ig az ilyen idők
UTC-ként voltak jelölve; az akkor importált eredmények megőrzik azonosítóikat, és továbbra is felismerhetők, ha egy jelentést ismét elküldenek.

Az HL7 eredmények, amelyek még függőben vannak (OBX-11 `I`), nem elérhetők (`X`), töröltek (`D`) vagy hibásak (`W`), valamint az érték nélküli OBX szegmensek
nem válnak megfigyelésekké; mindegyik a `warnings` mezőben lesz megnevezve.

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

## Mit kapsz vissza

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

- A markereket a **LOINC**-hoz rendeljük hozzá, ha a jelentés LOINC kódot ad meg, vagy a név megegyezik a
  platform terminológiájával (román és angol nevek, valamint gyakori becenevek). Mások megtartják a labor
  kódját a `urn:anpheros:lab-code` alatt, a jelentésből származó pontos szöveggel, és a `unmapped` listában szerepelnek,
  hogy Ön javíthassa a hozzárendelést az Ön oldalán. A labor saját kódja csak a laboratóriumával együtt egyedi:
  a forrásrendszer minden egyes megfigyelés (Observation) származási helyében (Provenance) rögzítve van (`X-Anpheros-Source-System`).
- A neveket a LOINC nevekhez és szinonimákhoz hasonlítjuk (például *Hemoglobin A1c*, *Glycated hemoglobin*,
  *HDL cholesterol*, *LDL-C*). Egy név, amely több fogalommal is megegyezik, vagy olyan minősítőt hordoz,
  amelyet a fogalom nem tartalmaz (*urine*, *non-HDL*, *free*, *ratio*…), nem kerül kitalálásra: megtartja a labor
  kódját, és a `unmapped` listában szerepel. Küldjön LOINC kódokat, amikor rendszere rendelkezik velük.
- A karbamid és a karbamid-nitrogén (BUN) különböző mérések: az *Uree* / *Urea* a karbamidhoz (LOINC `3091-6`, vagy
  `22664-7` mmol/L-ben) rendelődik hozzá, a *BUN* / *Urea nitrogen* / *Azot ureic* pedig a karbamid-nitrogénhez (`3094-0`, vagy
  `14937-7` mmol/L-ben).
  Az értékeket soha nem alakítjuk át.
- LDL koleszterin: egy módszer nélküli név a `2089-1`-hoz rendelődik; a *calculated* / *calculat* / *Friedewald* a számított
  LDL-hez (`13457-7`); a *direct* a direkt analízishez (`18262-6`). A módszer egy minősítő, mint például a *direct* a *Bilirubina
  directa*-ban, amely nem teljes bilirubin, és megtartja a labor kódját.
- Glükóz: egy egyszerű "Glicemie" / "Glucose" egy laborjelentésen szérumhoz vagy plazmához (LOINC `2345-7`) rendelődik;
  egy olyan név, amely kapilláris, ujjbegyből vett vagy teljes vért említ ("capilar", "sânge integral"), ahhoz
  rendelődik (`2339-0`).
  A jelentésben szereplő LOINC kód mindig elsőbbséget élvez.
- Minden sorhoz egy stabil azonosító (`urn:anpheros:lab-import:v2`) tartozik, amely a jelentés tartalmából épül fel – jelentés azonosítója,
  a jelentésen szereplő név és kód, dátum, érték és egység – soha nem a platform által választott LOINC kód alapján,
  így **ugyanazon jelentés újraküldése kihagyja azokat a sorokat, amelyeket már importáltak** (`skipped`), még a hozzárendelés javítása után is.
  Azok a sorok, amelyek bármelyikben eltérnek (más jelentés, más gyűjtési időpont, más érték), külön kerülnek tárolásra.
  A 2026. október 14. előtt importált eredmények megtartják eredeti azonosítójukat, és név, dátum, érték,
  egység és jelentés azonosító alapján ismerhetők fel. Jelentés azonosító nélkül (CSV) egy ilyen egyezés a `warnings`-ben kerül jelentésre; küldjön jelentés azonosítót
  (HL7 `OBR-3`/`MSH-10`, JSON `origin`) a különálló jelentések elkülönítéséhez.
- Minden megfigyelés (Observation) tartalmazza a származási helyet (Provenance) a `author_type = import`-mal, az Ön forrásrendszerével és a jelentés azonosítójával;
  a webhookok `resource.created` eseményt indítanak megfigyelésenként (Observation); a beteg az eredményeket az alkalmazásában látja, és bármely olyan alkalmazás, amelyhez hozzájárult, el tudja olvasni őket.
- Kérésenként legfeljebb 500 sor.

Mindkét SDK: `labs.importCsv`, `labs.importHl7`, `labs.importItems`.

Egy kidolgozott példa CSV és HL7 v2 jelentésből FHIR megfigyelésekre (Observations), nem hozzárendelt markerekkel és újraküldött jelentésekkel: [Hogyan importálhatunk laboratóriumi eredményeket egy FHIR rekordba](https://developers.anpheros.com/hu/guides/import-lab-results-fhir).

Hogyan mozognak a laboratóriumi adatok a laboratóriumok, klinikák, alkalmazások és AI között, és mire figyeljünk egy laboreredményeket tartalmazó API-ban: [Laboreredmények API](https://developers.anpheros.com/hu/guides/lab-results-api).