AnpherosAnpheros PlatformDevelopers

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

Łącznik laboratorium

Wyślij cały raport laboratoryjny jako CSV, HL7 v2 ORU^R01 lub JSON i uzyskaj obserwacje laboratoryjne z kodami LOINC i zakresami referencyjnymi.

Laboratorium (lub ktokolwiek posiadający raport laboratoryjny) wysyła cały raport w jednym żądaniu, a platforma przekształca każdy wynik w obserwację laboratoryjną Observation pacjenta:

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)

Formaty

CSV z wierszem nagłówka; separatory , ; lub tabulator, akceptowana przecinek dziesiętna, daty ISO, DD.MM.YYYY lub DD/MM/YYYY. Rozpoznawane kolumny (rumuńskie lub angielskie): marker (analiza, test, marker, name) — lub tylko kolumna LOINC code, w tym przypadku nazwa LOINC staje się markerem — wartość (rezultat, valoare, value, result), jednostka (um, unitate, unit), zakres referencyjny (interval, referinta: 70-100, <5, >3.5) lub ref_low/ref_high, data (data, recoltare), opcjonalny LOINC (loinc, code), uwaga.

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 (tekst ER7, segmenty oddzielone CR lub LF): OBX-3 identyfikator (code^text^LN to LOINC; lokalny kod (^L, ^99zzz) lub dowolny inny system kodowania jest zachowywany jako własny kod laboratorium pod urn:anpheros:lab-code), OBX-5 wartość (NM, SN lub tekst), OBX-6 jednostka, OBX-7 zakres referencyjny, OBX-8 flaga nieprawidłowości → interpretation, OBX-11 status, OBX-14 lub OBR-7 data; OBR-3/MSH-10 stają się identyfikatorem raportu w Provenance.

Laboratorium. Każdy wynik określa, kto go wygenerował w performer, zgodnie z wymaganiami HL7 Europe Laboratory Report 2.1.0: organizacja, w której działasz (X-Anpheros-Acting-As), w przeciwnym razie MSH-4 (placówka wysyłająca) dla HL7, lub laboratory w JSON (najwyższy poziom lub na element). CSV nie zawiera laboratorium; takie wyniki są walidowane z brakującym wykonawcą, co jest prawdą.

Raporty tekstowe, dokumenty i brakujące daty. Raport tekstowy wysłany jedna linia na OBX (TX/FT, ten sam OBX-3) staje się jednym wynikiem z połączonymi liniami. Cały dokument w OBX-5 (ED lub dowolna wartość zakodowana Base64) nie jest przechowywany jako wynik; odpowiedź ostrzega, a dokument należy do /documents. Bez OBR-7 wyniki są datowane przez OBR-14 (odebrana próbka), z ostrzeżeniem.

Czasy i strefy czasowe. Czas v2 bez strefy czasowej jest czasem lokalnym nadawcy, a nie UTC. Przesunięcie wysłane z OBX-14/OBR-7 (20260901081000+0300) jest zachowywane (2026-09-01T08:10:00+03:00). Bez niego używane jest przesunięcie MSH-7, a ostrzeżenie o tym informuje; bez przesunięcia w żadnym miejscu wynik zachowuje tylko swoją datę, również z ostrzeżeniem. Czasy CSV (01.09.2026 08:10) nie zawierają strefy czasowej, więc są przechowywane tylko jako daty. Do 17 października 2026 r. takie czasy były oznaczone jako UTC; zaimportowane wtedy wyniki zachowują swoje identyfikatory i są nadal rozpoznawane, gdy raport jest wysyłany ponownie.

Wyniki HL7, które są nadal w toku (OBX-11 I), niedostępne (X), usunięte (D) lub nieprawidłowe (W), oraz segmenty OBX bez wartości, nie stają się Obserwacjami; każdy jest nazwany w warnings.

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

Co otrzymujesz w zamian

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

Oba SDK: labs.importCsv, labs.importHl7, labs.importItems.

Praktyczny przykład importu wyników laboratoryjnych do rekordu FHIR z raportu CSV i HL7 v2, z niezmapowanymi znacznikami i ponownymi wysłaniami raportów: Jak importować wyniki laboratoryjne do rekordu FHIR.

Jak dane laboratoryjne przemieszczają się między laboratoriami, klinikami, aplikacjami i AI, oraz na co zwrócić uwagę w API wyników laboratoryjnych: Laboratory results API.

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

Product updates by email

New features, guides and the end of the beta. One email a month at most.

Send me occasional Anpheros Platform updates by email (new features, API changes, guides). I'll confirm by email and can unsubscribe in one click from any email. Privacy