ÚNICAS Rare Diseases HL7 FHIR Implementation Guide - Local Development build (v0.0.2) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Mensajerías de proceso

La plataforma ÚNICAS pretende gestionar de forma eficiente el proceso asistencial de un paciente con enfermedades minoritarias, con el objetivo de dar una atención asistencial y un diagnóstico en la brevedad posible.

Para ello, la plataforma ÚNICAS plantea un gestor de procesos basado en momentos, eventos y actividades.

El equipo funcional de ÚNICAS ha definido el proceso transversal de la plataforma ÚNICAS con momentos, eventos y actividades.

Estas actividades se han relacionado con la información estandardizada en FHIR para poder situar cada mensaje en el proceso transversal de la plataforma ÚNICAS.

Momentos ÚNICAS

Los Momentos ÚNICAS proporcionan una estructura del proceso asistencial de un paciente ÚNICAS, de tal forma que puede saberse rápidamente su situación clínica y asistencial, facilitando así la toma de decisiones y asegurando la continuidad del cuidado.

Se han identificado cinco momentos clave en la atención a pacientes con enfermedades minoritarias. Cada momento está asociado a un conjunto de actividades clínicas y administrativas, así como a la información que debe ser compartida entre nodos autonómicos y el nodo central para garantizar la continuidad y la trazabilidad de la atención. Estos momentos son la base sobre la que se estructuran:

• La gestión de eventos y transiciones entre estados del paciente
• Los formularios y actividades

El proceso se organiza, por tanto, en torno a momentos y eventos ÚNICAS, donde los eventos actúan como señalizadores que permiten a la plataforma detectar el paso del paciente de un momento a otro y actualizar su situación dentro de la red.

Los momentos ÚNICAS identificados son los siguientes:

Detección y sospecha

Corresponde a la fase inicial del proceso asistencial, donde se identifica la posibilidad de que el paciente pueda padecer una enfermedad minoritaria, sin contar todavía con una confirmación diagnóstica.

Durante este momento se realiza el enrolamiento del paciente en la red ÚNICAS, previa obtención del consentimiento informado, registrando los datos administrativos básicos y los primeros hallazgos clínicos o antecedentes familiares.

Su objetivo es garantizar que desde el inicio del proceso se dispone de la información esencial para la coordinación entre niveles asistenciales y con otras comunidades autónomas, además de la trazabilidad del paciente dentro de la red.

Actividades principales:

• Alta del paciente mediante formulario de enrolamiento
• Solicitud de pruebas diagnósticas o genéticas
• Registro de criterios de sospecha

Detección y sospecha con tratamiento

En este momento, el paciente permanece en sospecha diagnóstica, pero recibe un tratamiento asociado a la evolución clínica. El registro del tratamiento en la plataforma permite reflejar que existe una intervención activa mientras se completa el estudio diagnóstico.

Este momento es fundamental para diferenciar entre los pacientes únicamente en fase de estudio y aquellos que ya han iniciado alguna línea de tratamiento específico para su diagnóstico, garantizando la continuidad asistencial y el seguimiento de la respuesta terapéutica.

Actividades principales:

• Actualización del formulario de diagnóstico en sospecha con tratamiento
• Registro del tratamiento
• Evaluación de eficacia terapéutica y efectos secundarios

Diagnóstico-Asignación

Se inicia cuando se confirma el diagnóstico de la enfermedad minoritaria mediante los criterios clínicos, genéticos o bioquímicos establecidos. El paciente pasa a estar formalmente identificado dentro de la red con una patología concreta.

El diagnóstico puede incluir la revisión de pruebas, la validación de resultados o la integración de datos procedentes de distintos nodos.

Actividades principales:

• Confirmación del diagnóstico
• Actualización de formulario de enrolamiento en diagnóstico
• Registro de datos generales del diagnóstico

Diagnóstico-Asignación con tratamiento

Este momento representa la fase de tratamiento activo tras la confirmación del diagnóstico. Incluye la administración de terapias especializadas, medicamentos, o tratamientos de precisión asociados a la patología confirmada. El sistema garantiza la trazabilidad de todo el proceso terapéutico.

Actividades principales:

• Modificación del formulario a diagnóstico con tratamiento especializado
• Inclusión de tratamiento especializado del paciente
• Evaluación de la evolución y respuesta terapéutica

Salida

El último momento corresponde al cierre del proceso ÚNICAS, bien por fallecimiento del paciente (exitus letalis) en el que el nodo central es el responsable de notificar a los nodos, o por revocación del consentimiento informado o cualquier otra causa que implique la finalización del seguimiento dentro de la red, en el que son los propios nodos autonómicos los que comparten el momento del paciente al resto de la red.

El evento de salida genera una notificación automática a todos los nodos, que actualizan el estado del paciente y conservan la información con las debidas garantías de integridad, trazabilidad y seguridad.

Actividades principales:

• Registro de fallecimiento o motivo de salida
• Generación de notificación de baja a los nodos
• Cierre de formularios y bloqueo de la edición de datos

Eventos ÚNICAS

Un evento señaliza los hitos clave del paciente en ÚNICAS, permitiendo determinar un cambio del momento del “proceso asistencial” en el que se encuentra el paciente.

A través del análisis de procesos se identificaron y definieron cuatro eventos clave que conforman el proceso mínimo consensuado en el marco del proyecto ÚNICAS:

Estos eventos se han trasladado a la Plataforma de ÚNICAS al gestor del proceso.

Actividades ÚNICAS

También se han definido unas actividades asistenciales específicas donde resulta necesaria la compartición de información. Algunas de estas actividades tienen especial relevancia para el curso clínico del paciente y permiten situar el paciente en el CarePlan. Este paso es detectado por la plataforma ÚNICAS que modifica el CarePlan y el Task del paciente en la gestión del proceso de la plataforma.

La actividad consiste en una tarea concreta ejecutada bajo la responsabilidad y dirección de un encargado designado (Encounter). Cada vez que se recibe información mediante l’API FHIR de cada Nodo Autonómico, la plataforma de ÚNICAS relaciona la información recibida con una actividad.

Las actividades fundamentales incluidas en ÚNICAS son:

​Esta es la relación realizada en la plataforma de ÚNICAS entre información estandarizada y las actividades que se van a contemplar en el proceso:




Toda esta gestión de los eventos y actividades, así como la relación con los informes y registros de datos la asume la propia plataforma ÚNICAS.

Modelo FHIR del Proceso ÚNICAS

Todas las consultas a los procesos se gestionan mediante consultas basadas en recursos FHIR. Por lo general se utilizan las llamadas definidas en el estándar, aunque hay algunos casos específicos en los que se utilizan operaciones personalizadas (custom operation) definidas en el NA.

Los recursos FHIR que se utilizan son:

• CarePlan: Representa el plan de atención de un paciente, incluyendo los objetivos, actividades previstas, responsables y seguimiento. Detalla las acciones planificadas para alcanzar metas de salud, facilitando la coordinación y el registro de la atención entre diferentes profesionales y servicios. En el contexto del proyecto es el recurso destinado a registrar la información de la instancia del proceso ÚNICAS de cada paciente, permite el seguimiento del paciente en función del proceso.

• Task: Describe una tarea individual a realizar, relacionada con un proceso clínico o administrativo. Permite asignar, monitorizar y registrar el estado de actividades específicas, como procedimientos, solicitudes o acciones dentro de un flujo de trabajo, facilitando la gestión y seguimiento de dichas acciones. En el contexto del proyecto son los recursos utilizados para dejar registro de las actividades a realizar o realizadas durante el desarrollo de la instancia del proceso ÚNICAS.

• Parameters: Se utiliza para intercambiar datos estructurados en operaciones o servicios, como llamadas a funciones o procesos dentro de la API FHIR. Permite encapsular y transmitir uno o varios valores de entrada y salida de manera flexible, sin un modelo de datos predefinido, facilitando la comunicación entre el cliente y el servidor en operaciones como $validate, $process-message o búsquedas personalizadas.

• QuestionnaireResponse: Representa las respuestas proporcionadas por un usuario, paciente o profesional de salud a un cuestionario estructurado. Almacena los datos capturados durante la aplicación del cuestionario, asociando las respuestas con las preguntas y permitiendo su uso en procesos de evaluación, diagnóstico o seguimiento clínico. En ÚNICAS se utiliza para almacenar los formularios asociados a las actividades de usuario.

El siguiente diagrama representa el proceso:

Al iniciarse el proceso se tienen disponibles las siguientes actividades:

• Enrolamiento en ÚNICAS: Comienza con el consentimiento. Si se registra rechazando el consentimiento se finaliza el proceso. Si se acepta se despliega el resto del formulario, en el que se indica la primera versión del formulario de diagnóstico.
• Salida de paciente ÚNICAS: Esta tarea estará disponible siempre que el proceso esté en curso. Si se registra, se finaliza el proceso.

Al introducir el diagnóstico en la actividad “Enrolamiento en ÚNICAS” se puede indicar como “en sospecha” o “confirmado”, además de indicar si se encuentra en tratamiento específico para la enfermedad en ese momento. También se puede indicar que es “portador asintomático”, caso en el que se trata como un diagnóstico confirmado, pero sin opción a indicar si se está sometiendo a tratamiento específico.

Durante la ejecución del proceso, tal y como representa el diagrama, se puede pasar por los siguientes momentos:

• Momento sospecha
• Momento sospecha con tratamiento
• Momento diagnóstico
• Momento diagnóstico con tratamiento
• Momento salida

La descripción detallada sobre la mensajería de ejecución de este proceso viene detallada en la documentación adicional disponible en el Área de descarga.

La descripción de los data sets empleados puede encontrarse en el apartado de Data sets de mensajería.

Descripción general del recurso CarePlan

Este profile define las restricciones del recurso CarePlan representar al gestor del proceso en la red de ÚNICAS.

El recurso CarePlan representa parte de su información a través del atributo meta.tag, para minimizar el uso de extensiones.
Los valores de estas etiquetas son los siguientes:

La información detallada sobre Meta.tag está disponible en el apartado Decisiones de diseño FHIR para ÚNICAS.

Operaciones

Operación $apply

Operación personalizada del servidor para la inscripción a procesos. Permite instanciar procesos utilizando la última versión activa del proceso, sin necesidad de buscar previamente el identificador del PlanDefinition. Si ya existiera una instancia de ese proceso en curso al realizar la solicitud, la respuesta será el CarePlan existente, no creará uno nuevo. Si bien esta operación no pertenece a CarePlan, se incluye aquí por completitud del proceso.

• Método: POST
• URL: https:///ohbpm/api/fhir/PlanDefinition/$apply
  • servidor: nombre del servidor donde se encuentre disponible el NA ÚNICAS, dependerá de cada Comunidad Autónoma.

Operación $status-execution

Operación personalizada del servidor para la búsqueda de actividades pendientes o disponibles de un proceso.

• Método: GET
• URL: https:///ohbpm/api/fhir/CarePlan//$status-execution
  • servidor: nombre del servidor donde se encuentre disponible el NA ÚNICAS, dependerá de cada Comunidad Autónoma.
  • idCarePlan: el identificador único de la instancia de procesos cuyas actividades queremos consultar.

Operación $binnacle

Operación personalizada para la consulta de actividades finalizadas.

• Método: GET
• URL: https:// /ohbpm/api/fhir/CarePlan//$binnacle
  • servidor: nombre del servidor donde se encuentre disponible el NA ÚNICAS, dependerá de cada Comunidad Autónoma.
  • idCarePlan: el identificador único de la instancia de procesos cuyas actividades queremos consultar.

Descripción general del recurso Task

Este profile define las restricciones del recurso Task para representar el registro de tarea en el proceso de ÚNICAS.

Un recurso Task describe una actividad que puede realizarse y hace un seguimiento del estado de finalización de dicha actividad. Es una representación de que una actividad debe iniciarse o ya ha sido iniciada, y que, finalmente, refleja la finalización exitosa o fallida de esa actividad.

El campo meta.tag permitirá indicar una serie de etiquetas con información adicional sobre la actividad. La etiqueta que nos interesa para identificar las actividades es aquella cuyo system es ohbpm.task.planitem.

Además de las anteriores, existen Task asociadas a los diferentes momentos ÚNICAS. Estas no aparecen en la tabla porque no son tareas de usuario y por tanto no hay que realizar ninguna acción a través de la API con ellas para utilizar el flujo del proceso. Las tareas en cuestión son las siguientes:

• Activity_momento_deteccion
• Activity_momento_sospecha
• Activity_momento_sospecha_tratamiento
• A_ctivity_momento_diagnostico
• Activity_momento_diagnostico_tratamiento
• Activity_momento_salida

La información detallada sobre Meta.tag está disponible en el apartado Decisiones de diseño FHIR para ÚNICAS.

Operaciones

Operación $complete

Operación personalizada del servidor para el envío de respuestas de los formularios.

• Método: POST
• URL: https:///ohbpm/api/fhir/Task//$complete
  • servidor: nombre del servidor donde se encuentre disponible el NA ÚNICAS, dependerá de cada Comunidad Autónoma.
  • idTask: el identificador único de la actividad que se quiere completar.

Información sobre formularios

En ÚNICAS, la interacción con el proceso del paciente se realiza mediante el envío de respuestas a formularios. Disponemos de tres formularios ÚNICAS que pueden ser respondidos, de acuerdo con las actividades ÚNICAS.

• Enrolamiento ÚNICAS Esta primera actividad consiste en la realización de un formulario de inscripción. Este formulario de inscripción incluye el consentimiento de los familiares del paciente en primer lugar. Si se marca “NO” el formulario puede enviarse y darse por completado sin más información. Si se marca “SI” y por tanto se quiere continuar se despliega el resto del formulario, en el que se indica el diagnóstico y datos asociados a este.

• Modificación del formulario de diagnóstico en sospecha/confirmado El formulario de modificación de diagnóstico y el de enrolamiento de paciente solo se diferencian en los dos primeros ítems, ya que el de modificación no incluye la firma y fecha del consentimiento, esto solo se indica al realizar el enrolamiento. En este formulario se puede modificar el formulario de diagnóstico que se ha creado durante el enrolamiento del paciente, por ejemplo, para confirmar el diagnóstico si estaba en sospecha.

• Salida de paciente ÚNICAS La actividad de salida es la única actividad que siempre está disponible. En este formulario se indica el motivo de la salida del paciente. Una vez completada esta actividad la instancia deja de estar en curso.

Los primeros dos formularios coinciden en prácticamente todos los ítems excepto los dos primeros del formulario de Enrolamiento, que son solo de este formulario. A continuación, en una tabla, se muestran los ítems que forman los QuestionnaireResponse:

Formulario Enrolamiento / Modificación diagnóstico

Nota:

• Los linkId 40 y 42 solo se incluyen en el Formulario de Enrolamiento. El resto son comunes e idénticos en ambos formularios. Si se indica “NO” en la pregunta 41, ninguna respuesta más es necesaria.
• Se habilita el correspondiente a la codificación de diagnóstico seleccionada en el linkId 41. Solo se debe enviar uno de ellos, pero es necesario que se envíe.
• La pregunta “en_tratamiento” se omite si se indica en tipo de diagnóstico “portador asintomático”. El resto de las respuestas son en cualquier caso opcionales. Se pueden omitir del QuestionnaireResponse.

Por otro lado, el formulario de Salida solo incluye dos ítems, y de estos solo es obligatorio el que indica el motivo, el campo de observaciones es opcional.

Formulario Salida

Es importante recordar que nunca se envían los QuestionnaireResponse directamente como PUT de recurso, si no que siempre se envían dentro de un recurso Parameters , como parámetro de entrada de la operación personalizada del recurso Task $complete:

https:///ohbpm/api/fhir/Task//$complete