Recurso FHIR Encounter explicado, con un ejemplo

Respuesta corta: un Encounter es una interacción entre un paciente y el sistema de salud: una visita ambulatoria, una estancia hospitalaria, una atención de urgencias, una consulta por video, una visita a domicilio. Registra cuándo (period), en qué entorno (class: ambulatorio, hospitalizado, urgencias, atención domiciliaria, virtual), su estado (planificado → en curso → finalizado), quién participó, por qué (reasonCode) y qué se diagnosticó (diagnosis, enlazando a Conditions). Las observaciones, procedimientos, órdenes de medicación y documentos apuntan al Encounter al que pertenecen, que es como se puede leer el registro visita a visita.

Un ejemplo válido de FHIR R4

Un recurso de tipo Encounter válido en FHIR R4 solo requiere el estado (status) y la clase (class), pero uno útil también incluye el sujeto (subject), el período (period), el tipo (type), los participantes (participants), un motivo (reason) y los diagnósticos que estableció. El ejemplo a continuación es una consulta ambulatoria finalizada para diabetes tipo 2, con un profesional principal, un diagnóstico de motivo principal clasificado en primer lugar, una ubicación y la organización responsable.

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

Estado: el ciclo de vida

El estado (status) de un Encounter en FHIR pasa por planned (planificado), arrived (llegó), triaged (triaje), in-progress (en curso), onleave (de baja) y finished (finalizado), con cancelled (cancelado), entered-in-error (introducido por error) y unknown (desconocido) como otras salidas. El elemento statusHistory guarda cada estado anterior con su período, por lo que una estancia hospitalaria muestra cuándo el paciente llegó, fue admitido y se fue. Un Encounter es la interacción en sí, no la cita (Appointment) que la reservó.

planned (reservado, aún no iniciado) → arrived → triaged (departamentos de urgencias) → in-progress → onleave (hospitalizado con permiso temporal) → finished. cancelled y entered-in-error lo terminan de otra manera; unknown existe para importaciones. statusHistory guarda los estados anteriores con sus períodos, por lo que una estancia hospitalaria muestra cuándo llegó el paciente, cuándo fue ingresado y cuándo se fue. Tenga en cuenta que un Encounter no es una Cita: la Cita es la reserva; cuando el paciente llega, se crea un Encounter que lo referencia a través de appointment.

Clase: el entorno

La clase (class) del Encounter proviene del sistema HL7 v3 ActCode: AMB ambulatorio (paciente externo), IMP hospitalizado, EMER emergencia, HH atención domiciliaria, VR virtual (telemedicina), ACUTE y NONAC para subtipos de hospitalización, OBSENC observación, PRENC preadmisión, SS estancia corta. classHistory registra transferencias, por ejemplo, una atención de urgencias que se convirtió en una admisión.

Los otros elementos

Más allá del estado y la clase, un Encounter de FHIR contiene el tipo (type) y el tipo de servicio (serviceType) (qué tipo de visita y qué línea de servicio), el participante (participant) (profesionales de la salud con sus roles y períodos), el código de motivo (reasonCode) o la referencia de motivo (reasonReference), el diagnóstico (diagnosis) (Condiciones vinculadas con su uso y rango), la hospitalización (hospitalization) (detalles de admisión y alta), las entradas de ubicación a lo largo del tiempo, la duración (length), el proveedor de servicios (serviceProvider) y la parte de (partOf) para sub-encuentros.

type y serviceType indican qué tipo de encuentro y qué línea de servicio (cardiología, educación sobre diabetes), con códigos que varían según el país.
participant enumera a los médicos y otras personas con un tipo de participación (admitente, asistente, intérprete principal, consultor, remitente) y el período en que cada uno estuvo involucrado.
reasonCode / reasonReference indican el motivo de la visita; diagnosis enlaza las Condiciones establecidas o abordadas, con un use (diagnóstico de ingreso AD, diagnóstico de alta DD, queja principal CC, comorbilidad CM, facturación) y un rank. Consulte FHIR Condition explicado.
hospitalization contiene los detalles del ingreso: admitSource (remisión del médico de cabecera, urgencias, traslado), dischargeDisposition (domicilio, otro hospital, fallecido), preAdmissionIdentifier, dieta y arreglos especiales.
location enumera los lugares con su estado a lo largo del tiempo (planificado, activo, reservado, completado); una transferencia de sala añade una nueva entrada.
length es la duración; serviceProvider la organización responsable; partOf enlaza un sub-encuentro (una estancia en sala) con el ingreso al que pertenece.

Qué cambió en R5

FHIR R5 renombró Encounter.hospitalization a admission, fusionó reasonCode y reasonReference en reason, hizo que class fuera una lista de CodeableConcept (un encuentro puede tener varias clasificaciones), movió participant.individual a actor, e introdujo EncounterHistory como un recurso separado para el historial de estado y clase. R4 sigue siendo la versión en US Core y la mayoría de las guías nacionales; consulte FHIR R4 vs R5.

Mapeo desde HL7 v2

Los mensajes ADT de HL7 v2 se mapean a Encounter de FHIR por tipo de evento: A01 (admisión) crea un Encounter hospitalizado en curso, A03 (alta) lo finaliza con period.end y disposición de alta, A02 (transferencia) añade una entrada de ubicación, A04 registra un Encounter ambulatorio y A08 lo actualiza. La mayor parte de los datos provienen del segmento PV1, cuyo número de visita se convierte en Encounter.identifier.

Un ADT^A01 (ingreso) crea un Encounter con clase IMP y estado in-progress; A03 (alta) establece el estado finished y completa period.end y dischargeDisposition; A02 (transferencia) añade una entrada de location; A04 (registro ambulatorio) crea un Encounter AMB; A08 lo actualiza. PV1 contiene la mayoría de los datos (clase del paciente en PV1-2, ubicación en PV1-3, asistente en PV1-7, número de visita en PV1-19, que se convierte en Encounter.identifier). Consulte Mensajes HL7 v2 explicados.

En Anpheros

La Plataforma Anpheros crea recursos Encounter de FHIR de dos maneras: las clínicas los escriben a través de la API, y la visita registrada de una persona se convierte en un Encounter finalizado una vez que ha tenido lugar la cita. Los resultados, documentos y notas de esa visita hacen referencia al Encounter, de modo que el registro puede ser leído visita por visita por la persona y por cualquier clínica con la que comparta.

Las citas reservadas en la aplicación son recursos Appointment hasta que ocurren.

Páginas relacionadas

Fuentes

Preguntas frecuentes

¿Cuál es la diferencia entre Encounter y Appointment?

Una Cita es la reserva de un espacio futuro; un Encounter es la interacción que realmente ocurrió (o está ocurriendo). Cuando el paciente llega, se crea el Encounter y se referencia la Cita.

¿Una estancia hospitalaria es un Encounter o muchos?

Normalmente un Encounter para el ingreso, con entradas de ubicación para cada sala y classHistory para cambios de entorno. Algunos sistemas crean sub-encuentros por estancia en sala vinculados a través de partOf; las guías nacionales dicen cuál.

¿Dónde va el resumen de alta?

Como DocumentReference o un documento FHIR cuya Composition referencia el Encounter. El Encounter en sí mismo contiene la disposición de alta y las fechas, no la narrativa.

¿Cada Observation necesita un Encounter?

No. Las Observaciones que el paciente registra en casa, o que llegan de un dispositivo portátil, no tienen Encounter. Las que se toman durante una visita deben referenciarlo para que el registro pueda ser leído por visita.

Anpheros Platform

Pruébalo gratis en el sandbox

Tu primera llamada FHIR en 5 minutos. Una API HL7 FHIR R4 con el consentimiento del paciente integrado: pruébala en el sandbox y luego conecta tu propia app o sistema de clínica.

Crear un sandbox gratis Leer las guías para desarrolladores →

Gratis · 30 pacientes sintéticos · sin tarjeta

Esta guía es informativa y no sustituye la consulta médica. Para decisiones sobre tu salud, habla con tu médico. En una emergencia, llama al número de emergencias local (112 en Europa).

Escrito por

El equipo de Anpheros

Anpheros crea un historial médico que el paciente controla y puede compartir con cualquier clínica, en una plataforma HL7 FHIR R4, con sede en la UE. Estas guías te ayudan a entender y organizar tu salud; no reemplazan a tu médico.

Sobre Anpheros →