Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Labor csatlakozó

Küldj egy teljes laborjelentést CSV, HL7 v2 ORU^R01 vagy JSON formátumban, és kapj laboratóriumi megfigyeléseket LOINC kódokkal és referencia tartományokkal.

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

{"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.

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.

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card