Prepojenie laboratória: ako sa laboratórna správa vo formáte HL7 v2, CSV alebo JSON stane FHIR Observations v jednom kroku

Laboratórium má pri integrácii jednu úlohu: dostať správu do záznamu pacienta bez prepisovania, bez straty referenčného rozsahu a bez vymýšľania formátu, ktorému nikto iný nerozumie. Konektor laboratória Anpheros prevezme správu tak, ako ju laboratórium už produkuje, vo formáte HL7 v2, CSV alebo JSON, a premení každý výsledok na FHIR Observation s kódom LOINC, jednotkou, referenčným rozsahom, dátumom a názvom laboratória ako vykonávateľa. Táto príručka je zmluvou.

Technická verzia pre vývojárov: Konektor laboratória · API výsledkov laboratória na developers.anpheros.com, s požiadavkami, odpoveďami a obmedzeniami. Táto stránka je verzia v bežnom jazyku.

Jedna požiadavka

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        (voliteľné; zaznamenané v Provenance)
Idempotency-Key: <report id>          (voliteľné; opakovaná požiadavka vráti rovnakú odpoveď)

Odpoveď hovorí, čo sa stalo:

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

Formáty

HL7 v2 ORU^R01, ako text ER7. OBX-3 je identifikátor (code^text^LN je LOINC; lokálny kód je zachovaný ako vlastný kód laboratória), OBX-5 hodnota, OBX-6 jednotka, OBX-7 referenčný rozsah, OBX-8 abnormálna značka (stane sa interpretation), OBX-11 stav, OBR-7 alebo OBX-14 dátum. MSH-4 pomenúva odosielajúce zariadenie, ktoré sa stane vykonávateľom; OBR-3 a MSH-10 sa stanú ID správy v Provenance. Výsledky čakajúce na spracovanie, odstránené alebo nesprávne (I, X, D, W) a segmenty OBX bez hodnoty sa nestanú Observations a sú pomenované vo warnings.

CSV s hlavičkovým riadkom; oddeľovače , ; alebo tabulátor, desatinná čiarka je akceptovaná, dátumy ISO, DD.MM.YYYY alebo DD/MM/YYYY. Rozpoznané stĺpce v rumunčine alebo angličtine: marker, hodnota, jednotka, referenčný rozsah (70-100, <5, >3.5) alebo ref_low/ref_high, dátum, voliteľný kód LOINC, poznámka. CSV neobsahuje laboratórium, takže vykonávateľ chýba, pokiaľ nepošlete X-Anpheros-Acting-As.

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

JSON ak už máte štruktúrované údaje: {"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, "code": "3016-3"}]}.

Pravidlá mapovania, na ktorých záleží

• LOINC, ak je k dispozícii, inak podľa názvu. Názvy sa porovnávajú s názvami a synonymami LOINC v rumunčine a angličtine. Názov, ktorý zodpovedá viacerým konceptom, alebo nesie kvalifikátor, ktorý koncept nemá (moč, ne-HDL, voľný, pomer), sa nehádže: zachová si vlastný kód laboratória pod urn:anpheros:lab-code a objaví sa v unmapped, takže si mapovanie môžete na svojej strane vylepšiť. Posielajte kódy LOINC vždy, keď ich máte.
• Hodnoty sa nikdy nekonvertujú. Močovina a močovinový dusík sú rôzne kódy; LDL priamy a LDL vypočítaný sú rôzne kódy; glukóza zo séra a z kapilárnej krvi sú rôzne kódy. Konektor vyberie správny kód podľa názvu a metódy a číslo ponechá tak, ako je.
• Časy si zachovávajú svoju zónu. Čas v2 s posunom sa zachová; bez neho sa použije posun z MSH-7 s varovaním; ak nie je nikde, uloží sa iba dátum. Časy v CSV neobsahujú zónu a ukladajú sa ako dátumy.
• Idempotentné. Pošlite rovnakú správu dvakrát s rovnakým Idempotency-Key a dostanete rovnakú odpoveď a žiadne duplikáty.
• Provenance pri každom výsledku: zdrojový systém, ID správy a vykonávateľ, ako vyžaduje HL7 Europe Laboratory Report.

Čo vidí pacient

Výsledky sa zobrazia v zázname osoby a ak používajú Anpheros Daily, aj na ich telefóne hneď po príchode, s referenčným rozsahom a trendom z predchádzajúcich správ. Nič na skenovanie, nič na prepisovanie. Ak je výsledok abnormálny, osoba vidí značku; aplikácia ho neinterpretuje.

Testovanie

Sandbox je bezplatný a syntetickí pacienti už majú históriu laboratórnych vyšetrení. Pošlite správu jednému z nich a prečítajte si ju späť:

curl -X POST "$BASE/v1/patients/$PID/labs/import" -H "Authorization: Bearer $KEY" \
     -H "Content-Type: text/csv" --data-binary @report.csv
curl "$BASE/fhir/R4/Observation?patient=$PID&category=laboratory&_sort=-date" -H "Authorization: Bearer $KEY"

Úplná špecifikácia vrátane poznámok o zhode HL7 Europe je na developers.anpheros.com/guides/lab-connector.

Časté otázky

Musíme zmeniť to, čo produkuje náš LIS?

Nie. Pošlite správu ORU^R01 alebo export CSV tak, ako sú. Ak môžete pridať kódy LOINC, urobte to; inak konektor mapuje podľa názvu a povie vám, čo nedokázal namapovať.

Čo výsledky, ktoré nedokážete namapovať?

Sú uložené s vlastným kódom laboratória a presným textom zo správy, takže sa nič nestratí, a sú uvedené v unmapped, takže môžete nabudúce pridať kód LOINC.

Zachovávajú sa referenčné rozsahy a abnormálne značky?

Áno: rozsah ide do referenceRange, značka do interpretation, jednotka sa ukladá ako UCUM a hodnota sa nikdy nekonvertuje.

Môže laboratórium posielať výsledky pre pacienta, ktorého nevytvorilo?

Iba s povolením osoby, alebo ako organizácia, za ktorú projekt koná, s X-Anpheros-Acting-As. Projekt vidí pacientov, ktorých vytvoril; všetko ostatné vyžaduje povolenie.

Je integrácia spoplatnená?

Sandbox je bezplatný. Produkcia začína na 49 € mesačne na organizáciu, s prvým mesiacom zdarma; pozrite si cenník.