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

Mapování HL7 v2 na FHIR

Q: Jak namapovat HL7 v2 na FHIR?

Segment po segmentu: PID na Patient, PV1 na Encounter, ORC/OBR na ServiceRequest a DiagnosticReport, OBX na Observation, NTE na notes. Implementační průvodce HL7 V2-to-FHIR definuje mapování konceptů na úrovni polí.

Q: Existuje konvertor HL7 v2 na FHIR?

Ano. Interface engines a open-source knihovny konvertují zprávy; pro laboratorní výsledky, Anpheros lab connector konvertuje zprávu ORU^R01 na FHIR R4 Observations v jednom HTTPS požadavku a ukládá je do záznamu pacienta.

Q: Které typy zpráv HL7 v2 Anpheros přijímá?

ORU^R01 laboratorní výsledky. Zpráva jiného typu obdrží varování a čtou se pouze její OBX segmenty; ADT, objednávky a jiné zprávy nejsou podporovány.

Q: Jak jsou v FHIR reprezentovány příznaky abnormality HL7 v2?

OBX-8 se stává Observation.interpretation pomocí kódů HL7 ObservationInterpretation (H, L, HH, LL, A, N).

Mapování segmentů na zdroje a polí OBX z HL7 v2 ORU^R01 na FHIR R4, pasti, které narušují integrace, a konvertor, který voláte přes HTTPS.

Mapování HL7 v2 na FHIR znamená převod každého segmentu zprávy v2 oddělené svislou čarou na zdroje FHIR R4: PID na Patient, OBR na DiagnosticReport (nebo ServiceRequest), každý OBX na Observation, s kódy, jednotkami, rozsahy a časy přenesenými pole po poli. HL7 publikuje oficiální V2-to-FHIR implementation guide s mapami konceptů pro běžné segmenty. Tato stránka poskytuje praktické mapování pro laboratorní výsledky (ORU^R01), úskalí, která narušují reálné integrace, a převodník, který můžete volat přes 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 zdroje

HL7 v2 segment	Co nese	FHIR R4 resource	V konektoru Anpheros lab
MSH	Separátory, odesílající systém, typ zprávy, ID zprávy	`MessageHeader` (nebo provenance)	Separátory čteny z MSH; typ kontrolován pro ORU^R01; ID zprávy uchováno pro sledovatelnost
PID	Identifikátory pacienta, jméno, datum narození, pohlaví	`Patient`	Nepoužito: pacient je ten v URL požadavku, takže zpráva nemůže zapsat do nesprávného záznamu
PV1	Návštěva	`Encounter`	Nepoužito
ORC / OBR	Objednávka a zpráva: filler/placer id, datum	`ServiceRequest`, `DiagnosticReport`	OBR-3 (nebo OBR-2) je ID zprávy, OBR-7 výchozí datum
OBX	Jeden výsledek	`Observation`	Jedna laboratorní Observation na OBX
NTE	Textová poznámka	`Observation.note`	Nepoužito

Pole OBX po poli

Pole OBX	Prvek FHIR Observation	Poznámky
OBX-2 typ hodnoty (NM, SN, ST, CWE)	volba z `value[x]`	NM a SN se stanou `valueQuantity`; text zůstává text
OBX-3 identifikátor `code^text^system`	`code.coding`	`LN` v OBX-3.3 znamená LOINC; jiné systémy jsou lokální kódy laboratoře
OBX-5 hodnota, OBX-6 jednotka	`valueQuantity.value`, `.unit` / `.code` (UCUM)	`<5` a `6,4` musí být analyzovány záměrně
OBX-7 referenční rozsah	`referenceRange.low` / `.high`	`3.5-5.1`, `<200`, `>40`
OBX-8 příznak abnormality	`interpretation`	H, L, HH, LL, A, N
OBX-11 stav výsledku	`status`	F → finální, C → opravený, P → předběžný, I → zaregistrovaný
OBX-14 čas pozorování	`effectiveDateTime`	časy v2 často postrádají časové pásmo; FHIR vyžaduje jedno

Převod zprávy s jedním požadavkem

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

Odpověď uvádí, kolik bylo vytvořeno Observation, kolik jich bylo přeskočeno jako již importovaných, které markery nebylo možné namapovat a nové Observation s jejich kódy. Každé z nich získá stabilní identifikátor odvozený ze zprávy, testu, času a hodnoty, takže laboratoř, která znovu odešle stejnou zprávu, nevytvoří žádné duplikáty.

Úskalí, která narušují reálné integrace

Časová pásma. 20261002074500 nemá žádný offset; explicitně určete zónu odesílatele.
Lokální kódy. Ponechte vlastní kód laboratoře, pokud neexistuje LOINC; nikdy jej nevypouštějte.
Opakované odesílání. Bez stabilního identifikátoru na výsledek se opakované pokusy stávají duplicitami.
Opravy. OBX-11 C je oprava; rozhodněte, zda nahrazuje nebo přidává, a označte starý výsledek.
Nenumerické hodnoty. positive, <5, 6,4 vyžadují explicitní pravidla, nikoli odhad.

Co konektor nedělá

Přijímá laboratorní výsledky ve formátu ORU^R01 přes HTTPS. Nepřijímá zprávy ADT ani objednávky, nemluví MLLP přes TCP (přední interface engine může předávat), nevytváří DiagnosticReport a nespáruje pacienty z PID.

Často kladené otázky

Jak namapovat HL7 v2 na FHIR?

Segment po segmentu: PID na Patient, PV1 na Encounter, ORC/OBR na ServiceRequest a DiagnosticReport, OBX na Observation, NTE na notes. Implementační průvodce HL7 V2-to-FHIR definuje mapování konceptů na úrovni polí.

Existuje konvertor HL7 v2 na FHIR?

Ano. Interface engines a open-source knihovny konvertují zprávy; pro laboratorní výsledky, Anpheros lab connector konvertuje zprávu ORU^R01 na FHIR R4 Observations v jednom HTTPS požadavku a ukládá je do záznamu pacienta.

Které typy zpráv HL7 v2 Anpheros přijímá?

ORU^R01 laboratorní výsledky. Zpráva jiného typu obdrží varování a čtou se pouze její OBX segmenty; ADT, objednávky a jiné zprávy nejsou podporovány.

Jak jsou v FHIR reprezentovány příznaky abnormality HL7 v2?

OBX-8 se stává Observation.interpretation pomocí kódů HL7 ObservationInterpretation (H, L, HH, LL, A, N).

Související

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