FHIR

Resursa FHIR Encounter explicată: clase, stări, participanți, diagnostice și locații, cu un exemplu

Encounter: resursa FHIR pentru vizite (ambulatoriu, internare, telemedicină, domiciliu). Detaliază: când, context, participanți, diagnostic. Include ciclul de viață, coduri, detalii spitalizare, exemple R4/R5.

de Publicat 6 min de citit

Pe scurt: un Encounter este o interacțiune între un pacient și sistemul de sănătate: o vizită la ambulatoriu, o spitalizare, o prezentare la urgență, o consultație video, o vizită la domiciliu. Acesta înregistrează când (period), în ce cadru (class: ambulatoriu, internare, urgență, îngrijiri la domiciliu, virtual), starea sa (planificat → în desfășurare → finalizat), cine a participat, de ce (reasonCode) și ce a fost diagnosticat (diagnosis, legând de Conditions). Observațiile, procedurile, prescripțiile de medicamente și documentele indică Encounter-ul căruia îi aparțin, astfel încât un dosar poate fi citit vizită cu vizită.

Un exemplu valid FHIR R4

Un resurs FHIR R4 valid de tip Encounter necesită doar status și class, dar unul util include și subject, period, type, participants, un reason și diagnosticele stabilite. Exemplul de mai jos este o consultație ambulatorie finalizată pentru diabet de tip 2, cu un medic primar, un diagnostic de „simptom principal” clasat pe primul loc, o locație și organizația responsabilă.

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

Status: ciclul de viață

Starea (status) unui Encounter FHIR trece prin planned, arrived, triaged, in-progress, onleave și finished, cu cancelled, entered-in-error și unknown ca ieșiri alternative. Elementul statusHistory păstrează fiecare stare anterioară cu perioada sa, astfel încât o spitalizare arată când pacientul a sosit, a fost internat și a plecat. Un Encounter reprezintă interacțiunea în sine, nu Appointment-ul care a programat-o.

planned (rezervat, încă nu a început) → arrived → triaged (departamente de urgență) → in-progress → onleave (internat în concediu temporar) → finished. cancelled și entered-in-error îl încheie altfel; unknown există pentru importuri. statusHistory păstrează stările anterioare cu perioadele lor, astfel încât o spitalizare arată când a sosit pacientul, când a fost internat și când a plecat. Rețineți că un Encounter nu este un Appointment: Appointment-ul este rezervarea; când pacientul sosește, se creează un Encounter care face referire la acesta prin appointment.

Class: cadrul

Clasa (class) Encounter-ului provine din sistemul HL7 v3 ActCode: AMB ambulatoriu (în ambulatoriu), IMP internat, EMER urgență, HH îngrijiri la domiciliu, VR virtual (telemedicină), ACUTE și NONAC pentru subtipuri de internare, OBSENC observație, PRENC pre-internare, SS scurtă ședere. classHistory înregistrează transferurile, de exemplu o prezentare la urgență care a devenit o internare.

Celelalte elemente

Pe lângă status și class, un Encounter FHIR include type și serviceType (ce fel de vizită și ce linie de servicii), participant (clinicieni cu rolurile și perioadele lor), reasonCode sau reasonReference, diagnosis (afecțiuni legate cu utilizarea și rangul), hospitalization (detalii de internare și externare), intrări location în timp, length, serviceProvider și partOf pentru sub-întâlniri.

  • type și serviceType indică tipul de întâlnire și linia de servicii (cardiologie, educație pentru diabet), cu coduri care variază în funcție de țară.
  • participant listează clinicienii și alte persoane cu un tip de participare (admițător, attendant, performer principal, consultant, referent) și perioada în care fiecare a fost implicat.
  • reasonCode / reasonReference oferă motivul vizitei; diagnosis leagă Condițiile stabilite sau abordate, cu un use (diagnostic de internare AD, diagnostic de externare DD, motiv principal al internării CC, comorbiditate CM, facturare) și un rank. Vezi FHIR Condition explicat.
  • hospitalization conține detalii de admitere: admitSource (trimitere de la medicul de familie, urgență, transfer), dischargeDisposition (acasă, alt spital, decedat), preAdmissionIdentifier, dietă și aranjamente speciale.
  • location listează locurile cu starea lor în timp (planificat, activ, rezervat, finalizat); un transfer de secție adaugă o nouă intrare.
  • length este durata; serviceProvider organizația responsabilă; partOf leagă un sub-encounter (o ședere în secție) de admiterea căreia îi aparține.

Ce s-a schimbat în R5

FHIR R5 a redenumit Encounter.hospitalization în admission, a unit reasonCode și reasonReference în reason, a transformat class într-o listă de CodeableConcept (un Encounter poate avea mai multe clasificări), a mutat participant.individual la actor și a introdus EncounterHistory ca un resurs separat pentru istoricul status și class. R4 rămâne versiunea din US Core și majoritatea ghidurilor naționale; vezi FHIR R4 vs R5.

Mapare din HL7 v2

Mesajele HL7 v2 ADT se mapează la Encounter FHIR în funcție de tipul evenimentului: A01 admitere creează un Encounter internat în curs, A03 externare îl finalizează cu period.end și discharge disposition, A02 transfer adaugă o intrare location, A04 înregistrează un Encounter ambulatoriu și A08 îl actualizează. Majoritatea datelor provin din segmentul PV1, al cărui număr de vizită devine Encounter.identifier.

Un ADT^A01 (admitere) creează un Encounter cu clasa IMP și starea in-progress; A03 (externare) setează starea finished și completează period.end și dischargeDisposition; A02 (transfer) adaugă o intrare location; A04 (înregistrare pacient extern) creează un encounter AMB; A08 îl actualizează. PV1 conține majoritatea datelor (clasa pacientului în PV1-2, locația în PV1-3, attendantul în PV1-7, numărul vizitei în PV1-19, care devine Encounter.identifier). Vezi Mesajele HL7 v2 explicate.

În Anpheros

Platforma Anpheros creează resurse FHIR Encounter în două moduri: clinicile le scriu prin API, iar vizita înregistrată a unei persoane devine un Encounter finalizat odată ce programarea a avut loc. Rezultatele, documentele și notele de la acea vizită fac referire la Encounter, astfel încât înregistrarea poate fi citită vizită cu vizită de către persoană și de către orice clinică cu care aceasta partajează.

Programările rezervate în aplicație sunt resurse Appointment până când au loc.

Pagini conexe

Surse

Întrebări frecvente

Care este diferența dintre Encounter și Appointment?

Un Appointment este rezervarea unui interval de timp viitor; un Encounter este interacțiunea care a avut loc (sau are loc). Când pacientul sosește, se creează Encounter-ul și face referire la Appointment.

O spitalizare este un singur Encounter sau mai multe?

De obicei, un singur Encounter pentru admitere, cu intrări de locație pentru fiecare secție și classHistory pentru schimbările de cadru. Unele sisteme creează sub-encounter-uri per ședere în secție legate prin partOf; ghidurile naționale spun care.

Unde merge rezumatul externării?

Ca un DocumentReference sau un document FHIR a cărui Compoziție face referire la Encounter. Însuși Encounter-ul conține dispoziția de externare și datele, nu narațiunea.

Fiecare Observație necesită un Encounter?

Nu. Observațiile pe care pacientul le înregistrează acasă sau care sosesc de la un dispozitiv purtabil nu au un Encounter. Cele efectuate în timpul unei vizite ar trebui să facă referire la acesta, astfel încât dosarul să poată fi citit pe vizite.

Anpheros Platform

Încearcă gratuit în sandbox

Primul apel FHIR în 5 minute. Un API HL7 FHIR R4 cu consimțământul pacientului integrat: încearcă-l în sandbox, apoi conectează-ți propria aplicație sau sistemul clinicii.

Gratuit · 30 de pacienți sintetici · fără card

Acest ghid este informativ și nu înlocuiește consultul medical. Pentru decizii despre sănătatea ta, vorbește cu medicul tău. În caz de urgență, sună la numărul de urgență local (112 în Europa).
Scris de
Echipa Anpheros

Anpheros construiește un dosar medical pe care pacientul îl controlează și îl poate da oricărei clinici, pe o platformă HL7 FHIR R4, cu sediul în UE. Ghidurile te ajută să-ți înțelegi și să-ți organizezi sănătatea; nu înlocuiesc medicul.

Despre Anpheros →