FHIR Ellátás erőforrás magyarázata, példával

Rövid válasz: az Encounter egyetlen interakció a beteg és az egészségügyi rendszer között: járóbeteg-rendelés, kórházi tartózkodás, sürgősségi ellátás, videókonzultáció, otthoni látogatás. Ez rögzíti, hogy mikor (period), milyen környezetben (class: járóbeteg, fekvőbeteg, sürgősségi, otthoni egészségügyi ellátás, virtuális), mi a állapota (tervezett → folyamatban → befejezett), ki vett részt, miért (reasonCode) és mit diagnosztizáltak (diagnosis, a Feltételekhez kapcsolódva). Megfigyelések, eljárások, gyógyszerrendelések és dokumentumok az Encounterre mutatnak, amelyhez tartoznak, így a rekord látogatásonként olvasható.

Érvényes FHIR R4 példa

Egy érvényes FHIR R4 Encounter erőforrás csak a status és class mezőket igényli, de egy hasznos erőforrás tartalmazza a témát (subject), az időszakot (period), a típust (type), a résztvevőket (participants), az okot (reason) és a megállapított diagnózisokat (diagnoses). Az alábbi példa egy befejezett járóbeteg-konzultáció a 2-es típusú cukorbetegségre, elsődleges előadóval, első helyen rangsorolt főpanasz diagnózissal, helyszínnel és a felelős szervezettel.

{
  "resourceType": "Encounter",
  "id": "visit-2026-03-14",
  "status": "finished",
  "class": {"system": "http://terminology.hl7.org/CodeSystem/v3-ActCode", "code": "AMB", "display": "ambulatory"},
  "type": [{"coding": [{"system": "http://snomed.info/sct", "code": "11429006", "display": "Consultation"}]}],
  "serviceType": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/service-type", "code": "165", "display": "Diabetes Education"}]},
  "subject": {"reference": "Patient/example"},
  "participant": [{
    "type": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType", "code": "PPRF", "display": "primary performer"}]}],
    "individual": {"reference": "Practitioner/gp-42"}
  }],
  "period": {"start": "2026-03-14T09:00:00+01:00", "end": "2026-03-14T09:25:00+01:00"},
  "reasonCode": [{"coding": [{"system": "http://snomed.info/sct", "code": "44054006", "display": "Type 2 diabetes mellitus"}]}],
  "diagnosis": [{
    "condition": {"reference": "Condition/t2dm"},
    "use": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/diagnosis-role", "code": "CC", "display": "Chief complaint"}]},
    "rank": 1
  }],
  "location": [{"location": {"reference": "Location/clinic-3"}, "status": "completed"}],
  "serviceProvider": {"reference": "Organization/hospital"}
}

Állapot: az életciklus

A FHIR Encounter állapota (status) a következőképpen változik: planned (tervezett), arrived (érkezett), triaged (triage-olt), in-progress (folyamatban), onleave (eltávozott) és finished (befejezett), míg a cancelled (törölt), entered-in-error (hibásan bevitt) és unknown (ismeretlen) a többi kilépési állapot. A statusHistory mező minden korábbi állapotot megőriz az időszakával együtt, így egy kórházi tartózkodás megmutatja, mikor érkezett meg a beteg, mikor helyezték be és mikor távozott. Az Encounter maga az interakció, nem pedig az azt foglaló Appointment.

planned (lefoglalva, még nem kezdődött el) → arrived → triaged (sürgősségi osztályok) → in-progress → onleave (fekvőbeteg ideiglenes távollétben) → finished. A cancelled és entered-in-error másképp fejezi be; az unknown importok esetén létezik. A statusHistory megőrzi a korábbi állapotokat a hozzájuk tartozó időszakokkal, így egy kórházi tartózkodás megmutatja, mikor érkezett a beteg, mikor vették fel és mikor távozott. Vegye figyelembe, hogy az Encounter nem egy Időpont: az Időpont a foglalás; amikor a beteg megérkezik, létrejön egy Encounter, amely az appointment keresztül hivatkozik rá.

Osztály: a környezet

Az Encounter class az HL7 v3 ActCode rendszertől származik: AMB ambulatory (járóbeteg), IMP inpatient (fekvőbeteg), EMER emergency (sürgősségi), HH home health (otthoni egészségügyi ellátás), VR virtual (telehealth), ACUTE és NONAC fekvőbeteg-altípusokhoz, OBSENC observation (megfigyelés), PRENC pre-admission (előzetes bejelentkezés), SS short stay (rövid tartózkodás). A classHistory rögzíti az áthelyezéseket, például egy sürgősségi ellátást, amely fekvőbeteggé vált.

A többi elem

Az állapoton (status) és az osztályon (class) túl az Encounter tartalmazza a típust (type) és a szolgáltatás típusát (serviceType) (milyen látogatás és milyen szolgáltatási vonal), a résztvevőt (participant) (klinikusok szerepeikkel és időszakaikkal), az okot (reasonCode vagy reasonReference), a diagnózist (kapcsolt Condition-ök használattal és rangsorolással), a kórházi tartózkodást (hospitalization) (be- és kiutalás részletei), az időbeli helyszínbejegyzéseket (location), a hosszt (length), a szolgáltatót (serviceProvider) és az al-találkozókhoz a partOf mezőt.

A type és a serviceType megmondja, milyen típusú az encounter és melyik szolgáltatási vonal (kardiológia, cukorbetegség oktatás), az országonként eltérő kódokkal.
A participant felsorolja a klinikusokat és másokat, részvételi típussal (felvevő, ellátó, elsődleges végrehajtó, konzultáns, beutaló) és azzal az időszakkal, amelyben mindegyikük részt vett.
A reasonCode / reasonReference megadja a látogatás okát; a diagnosis összekapcsolja a megállapított vagy kezelt Feltételeket, egy use (felvételi diagnózis AD, elbocsátási diagnózis DD, fő panasz CC, társbetegség CM, számlázás) és egy rank mellett. Lásd FHIR Condition magyarázata.
A hospitalization tartalmazza a felvételi részleteket: admitSource (háziorvosi beutaló, sürgősségi, átszállítás), dischargeDisposition (otthon, másik kórház, elhunyt), preAdmissionIdentifier, étrend és különleges elrendezések.
A location felsorolja a helyeket az állapotukkal idővel (tervezett, aktív, foglalt, befejezett); egy osztály áthelyezés új bejegyzést ad hozzá.
A length a tartam; a serviceProvider a felelős szervezet; a partOf egy al-encountert (egy osztály tartózkodás) összekapcsol a hozzá tartozó felvétellel.

Mi változott az R5-ben

A FHIR R5 átnevezte az Encounter.hospitalization-t admission-re, összevonta a reasonCode-t és a reasonReference-t reason-re, a class mezőt CodeableConcept listává tette (egy Encounter több besorolást is tartalmazhat), az participant.individual mezőt az actor mezőbe helyezte, és bevezette az EncounterHistory-t mint külön erőforrást az állapot- és osztálytörténethez. Az R4 továbbra is az US Core és a legtöbb nemzeti útmutatóban szereplő verzió; lásd: FHIR R4 vs R5.

Leképezés az HL7 v2-ből

Az HL7 v2 ADT üzenetek az esemény típusától függően map-olódnak a FHIR Encounter-re: az A01 beutalás egy folyamatban lévő fekvőbeteg Encounter-t hoz létre, az A03 elbocsátás befejezi azt az period.end és az elbocsátási rendeltetéssel (discharge disposition), az A02 áthelyezés egy helyszínbejegyzést ad hozzá, az A04 egy járóbeteg Encounter-t regisztrál, az A08 pedig frissíti azt. Az adatok nagy része a PV1 szegmensből származik, amelynek látogatási száma lesz az Encounter.identifier.

Egy ADT^A01 (felvétel) létrehoz egy Encountert IMP osztállyal és in-progress állapottal; az A03 (elbocsátás) beállítja a finished állapotot, és kitölti a period.end-et és a dischargeDisposition-t; az A02 (átszállítás) hozzáad egy location bejegyzést; az A04 (járóbeteg regisztráció) létrehoz egy AMB encountert; az A08 frissíti azt. A PV1 tartalmazza a legtöbb adatot (beteg osztály a PV1-2-ben, hely a PV1-3-ban, ellátó a PV1-7-ben, látogatási szám a PV1-19-ben, ami az Encounter.identifier lesz). Lásd HL7 v2 üzenetek magyarázata.

Az Anpheros-ban

Az Anpheros Platform kétféleképpen hoz létre FHIR Encounter erőforrásokat: a klinikák az API-n keresztül írják őket, és egy személy saját bejelentkezett látogatása befejezett Encounter-ré válik, amint a találkozó megtörtént. Az eredmények, dokumentumok és jegyzetek ebből a látogatásból az Encounter-re hivatkoznak, így a rekord látogatásonként olvasható a személy és bármelyik klinika által, akivel megosztja.

Az alkalmazásban foglalt időpontok Appointment erőforrások, amíg meg nem történnek.

Kapcsolódó oldalak

Források

Gyakori kérdések

Mi a különbség az Encounter és az Appointment között?

Az Appointment egy jövőbeli időpont foglalása; az Encounter a ténylegesen megtörtént (vagy folyamatban lévő) interakció. Amikor a beteg megérkezik, létrejön az Encounter, amely hivatkozik az Appointmentra.

Egy kórházi tartózkodás egy Encounter vagy több?

Általában egy Encounter a felvételhez, osztálybejegyzésekkel minden osztályhoz és classHistory-val a környezetváltozásokhoz. Egyes rendszerek al-encounteket hoznak létre osztálytartózkodásonként, amelyek a partOf-on keresztül kapcsolódnak; a nemzeti útmutatók meghatározzák, melyiket.

Hová kerül az elbocsátási összefoglaló?

DocumentReference-ként vagy FHIR dokumentumként, amelynek Compositionja hivatkozik az Encounterre. Maga az Encounter tartalmazza az elbocsátási rendeltetést és a dátumokat, nem a narratívát.

Minden Observationnek szüksége van Encounterre?

Nem. Az otthon rögzített vagy viselhető eszközről érkező megfigyeléseknek nincs Encounterük. A látogatás során végzett megfigyeléseknek hivatkozniuk kell rá, hogy a rekord látogatásonként olvasható legyen.

Anpheros Platform

Próbálja ki ingyen a sandboxban

Az első FHIR-hívás 5 perc alatt. Egy HL7 FHIR R4 API, amely tartalmazza a beteg beleegyezését: próbáld ki a sandboxban, majd csatlakoztasd saját alkalmazásodat vagy klinikai rendszeredet.

Ingyenes sandbox létrehozása Olvasd el a fejlesztői útmutatókat →

Ingyenes · 30 szintetikus beteg · kártya nélkül

Ez az útmutató tájékoztató jellegű, és nem helyettesíti az orvosi tanácsot. Az egészségeddel kapcsolatos döntésekhez beszélj az orvosoddal. Vészhelyzetben hívja a helyi segélyhívó számot (Európában 112).

Szerző:

Az Anpheros csapata

Az Anpheros egy olyan egészségügyi nyilvántartást épít, amelyet a beteg irányít, és megoszthat bármelyik klinikával, egy EU-ban működő HL7 FHIR R4 platformon. Ezek az útmutatók segítenek megérteni és rendszerezni az egészségügyi adataidat; nem helyettesítik az orvosodat.

Tudj meg többet az Anpherosról →