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

Mapovanie HL7 v2 na FHIR

Q: Ako mapujete HL7 v2 na FHIR?

Segment po segmente: PID na Patient, PV1 na Encounter, ORC/OBR na ServiceRequest a DiagnosticReport, OBX na Observation, NTE na notes. Sprievodca implementáciou HL7 V2-to-FHIR definuje mapovanie konceptov na úrovni polí.

Q: Existuje konvertor HL7 v2 na FHIR?

Áno. Interface enginy a open-source knižnice konvertujú správy; pre laboratórne výsledky, Anpheros lab connector konvertuje správu ORU^R01 na FHIR R4 Observations v jednom HTTPS požiadavke a ukladá ich do záznamu pacienta.

Q: Ktoré typy správ HL7 v2 Anpheros akceptuje?

ORU^R01 laboratórne výsledky. Správa iného typu dostane varovanie a čítajú sa iba jej OBX segmenty; ADT, objednávky a iné správy nie sú podporované.

Q: Ako sú HL7 v2 abnormálne príznaky reprezentované vo FHIR?

OBX-8 sa stáva Observation.interpretation pomocou kódov HL7 ObservationInterpretation (H, L, HH, LL, A, N).

Mapovanie segmentov na zdroje a polí OBX po poliach z HL7 v2 ORU^R01 na FHIR R4, nástrahy, ktoré narúšajú integrácie, a konvertor, ktorý voláte cez HTTPS.

Mapovanie HL7 v2 na FHIR znamená transformáciu každého segmentu v2 správy oddelenej znakom pipe na FHIR R4 zdroje: PID na Patient, OBR na DiagnosticReport (alebo ServiceRequest), každý OBX na Observation, s kódmi, jednotkami, rozsahy a časmi prenesenými pole po poli. HL7 publikuje oficiálny V2-to-FHIR implementation guide s mapami konceptov pre bežné segmenty. Táto stránka poskytuje praktické mapovanie pre laboratórne výsledky (ORU^R01), pasce, ktoré narúšajú reálne integrácie, a konvertor, ktorý môžete volať cez HTTPS: Anpheros lab connector.

An ORU^R01 message becoming FHIR

MSHSeparators, message type, message id → MessageHeader or provenance
PIDPatient identity → Patient (or, in Anpheros, the patient in the URL)
OBRThe order and report → DiagnosticReport, report id and date
OBXOne result each → Observation with LOINC, value, range, flag
FHIR recordCoded, versioned resources your apps can read

Segment do zdroja

HL7 v2 segment	Čo obsahuje	FHIR R4 zdroj	V konektore Anpheros lab
MSH	Separátory, odosielajúci systém, typ správy, ID správy	`MessageHeader` (alebo provenance)	Separátory čítané z MSH; typ skontrolovaný pre ORU^R01; ID správy uchované pre sledovateľnosť
PID	Identifikátory pacienta, meno, dátum narodenia, pohlavie	`Patient`	Nepoužité: pacient je ten v URL požiadavky, takže správa nemôže zapísať do nesprávneho záznamu
PV1	Návšteva	`Encounter`	Nepoužité
ORC / OBR	Objednávka a správa: filler/placer id, dátum	`ServiceRequest`, `DiagnosticReport`	OBR-3 (alebo OBR-2) je ID správy, OBR-7 je predvolený dátum
OBX	Jeden výsledok	`Observation`	Jedna laboratórna Observation na OBX
NTE	Poznámka voľného textu	`Observation.note`	Nepoužité

Pole OBX po poli

Pole OBX	Element FHIR Observation	Poznámky
Typ hodnoty poľa OBX-2 (NM, SN, ST, CWE)	voľba z `value[x]`	NM a SN sa stanú `valueQuantity`; text zostáva text
Identifikátor poľa OBX-3 `code^text^system`	`code.coding`	`LN` v OBX-3.3 znamená LOINC; iné systémy sú lokálne kódy laboratória
Hodnota poľa OBX-5, jednotka poľa OBX-6	`valueQuantity.value`, `.unit` / `.code` (UCUM)	`<5` a `6,4` musia byť analyzované cielene
Referenčný rozsah poľa OBX-7	`referenceRange.low` / `.high`	`3.5-5.1`, `<200`, `>40`
Abnormálna vlajka poľa OBX-8	`interpretation`	H, L, HH, LL, A, N
Stav výsledku poľa OBX-11	`status`	F → finálny, C → upravený, P → predbežný, I → zaregistrovaný
Čas pozorovania poľa OBX-14	`effectiveDateTime`	časy v2 často nemajú časové pásmo; FHIR ho vyžaduje

Konverzia správy s jednou požiadavkou

curl -X POST "https://platform.anpheros.com/v1/patients/$PID/labs/import" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: x-application/hl7-v2+er7" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data-binary @oru_r01.hl7

Odpoveď uvádza, koľko Observations bolo vytvorených, koľko ich bolo preskočených ako už importovaných, ktoré markery sa nepodarilo namapovať a nové Observations s ich kódmi. Každý z nich dostane stabilný identifikátor odvodený zo správy, testu, času a hodnoty, takže laboratórium, ktoré pošle rovnakú správu opakovane, nevytvorí žiadne duplikáty.

Nástrahy, ktoré narúšajú reálne integrácie

Časové zóny. 20261002074500 nemá žiadny offset; explicitne rozhodnite o zóne odosielateľa.
Lokálne kódy. Ponechajte vlastný kód laboratória, ak neexistuje LOINC; nikdy ho nevypúšťajte.
Opätovné odoslania. Bez stabilného identifikátora na výsledok sa opakované pokusy stávajú duplicitami.
Opravy. OBX-11 C je oprava; rozhodnite, či nahrádza alebo pridáva, a označte starý výsledok.
Nenumerické hodnoty. positive, <5, 6,4 vyžadujú explicitné pravidlá, nie odhad.

Čo konektor nerobí

Prijíma laboratórne výsledky ORU^R01 cez HTTPS. Neprijíma správy ADT ani objednávky, nekomunikuje cez MLLP cez TCP (vpredu umiestnený interface engine to môže presmerovať), nevytvára DiagnosticReport a nespáruje pacientov z PID.

Často kladené otázky

Ako mapujete HL7 v2 na FHIR?

Segment po segmente: PID na Patient, PV1 na Encounter, ORC/OBR na ServiceRequest a DiagnosticReport, OBX na Observation, NTE na notes. Sprievodca implementáciou HL7 V2-to-FHIR definuje mapovanie konceptov na úrovni polí.

Existuje konvertor HL7 v2 na FHIR?

Áno. Interface enginy a open-source knižnice konvertujú správy; pre laboratórne výsledky, Anpheros lab connector konvertuje správu ORU^R01 na FHIR R4 Observations v jednom HTTPS požiadavke a ukladá ich do záznamu pacienta.

Ktoré typy správ HL7 v2 Anpheros akceptuje?

ORU^R01 laboratórne výsledky. Správa iného typu dostane varovanie a čítajú sa iba jej OBX segmenty; ADT, objednávky a iné správy nie sú podporované.

Ako sú HL7 v2 abnormálne príznaky reprezentované vo FHIR?

OBX-8 sa stáva Observation.interpretation pomocou kódov HL7 ObservationInterpretation (H, L, HH, LL, A, N).

Súvisiace

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