DocumentaciónSoporteCosta Rica · Contacto
El punto de partida

El ecosistema ya está definido. La pregunta es de qué lado queda su organización.

Cuando un país define su arquitectura de interoperabilidad, conectarse deja de ser opcional. Su organización va a tener que responder consultas, publicar lo que produce, o ambas cosas — y va a tener que demostrar que puede hacerlo antes de que la dejen entrar. La mayoría lo descubre tarde: faltaban tres o cuatro capacidades que nunca estuvieron en ningún proyecto, y aparecen en la fase de pruebas, cuando la fecha ya está comprometida. Nuestro trabajo es que usted sepa eso hoy.

Roles

Consumidor, productor, custodio: casi nadie es uno solo

El intercambio se organiza por roles, no por tipo de institución. Un mismo hospital suele cumplir los tres al mismo tiempo, y las obligaciones no se eligen: se acumulan.

Consulta para decidir

Consumidor

Necesita ver información que otro generó —un resultado, una vacuna, un episodio previo— en el momento en que está atendiendo al paciente.

Lo que le van a exigir

Probar quién consulta, en nombre de quién y con qué propósito; y que cada consulta queda registrada.

Lo que casi siempre falta

Nadie definió el propósito de uso ni dónde queda el consentimiento. La consulta funciona en pruebas y se traba en la revisión legal.

Típicamente
  • Servicios de emergencia
  • Consulta externa
  • Farmacia
  • Referencia y contrarreferencia
Genera el dato

Productor

Produce información clínica que el resto del ecosistema necesita: resultados de laboratorio, notificaciones, informes de imágenes, vacunas aplicadas.

Lo que le van a exigir

Publicar conforme al perfil nacional, con la terminología ligada y en el momento en que el hecho ocurre — no en un lote al final del mes.

Lo que casi siempre falta

El sistema que genera el dato no puede producir el perfil, y el proyecto se entera cuando ese sistema ya está comprado.

Típicamente
  • Laboratorios
  • Servicios de imágenes
  • Vacunación
  • Notificación obligatoria
Responde por el dato

Custodio

Guarda la información y responde por ella: quién puede verla, cuánto tiempo se conserva y qué se entrega cuando el ecosistema la pide. A veces es el mismo que la produce; a veces es un rol aparte.

Lo que le van a exigir

Estar disponible cuando le consulten, entregar solo lo autorizado y poder reconstruir quién accedió a qué, meses después.

Lo que casi siempre falta

El repositorio existe, pero no hay disponibilidad comprometida, ni auditoría consultable, ni una política de retención escrita.

Típicamente
  • Repositorios institucionales
  • Redes de prestadores
  • Registros nacionales
  • Operadores de PACS

Si su organización produce y además consulta, no elija: le aplican las dos columnas. Y si guarda lo que produce, le aplican las tres. Esa acumulación es la razón por la que los proyectos de conexión se estiran el doble de lo estimado.

Brechas

¿Qué le falta construir?

Siete capacidades. Abra la que le corresponda según su rol y va a reconocer en cuáles está listo y cuáles no están hoy en ningún proyecto de su organización.

CapacidadConsumidorProductorCustodio
Resolución de identidad del pacienteConsumidorObligatorioProductorObligatorioCustodioObligatorio
Qué es

Saber que el expediente que usted tiene y el que responde el ecosistema son de la misma persona, aunque los identificadores no coincidan.

Si no la tiene

Une o separa historias equivocadas. Es el error que más rápido escala a incidente clínico y el más caro de corregir hacia atrás.

Cómo se resuelve

Se consulta el índice del ecosistema en vez de replicarlo, con una política escrita para los casos que no resuelven de forma automática.

  • IHE PIX / PDQm
  • FHIR Patient $match
Localización de la informaciónConsumidorObligatorioProductorSegún el casoCustodioObligatorio
Qué es

Averiguar qué información existe sobre un paciente y quién la tiene, antes de traerla.

Si no la tiene

Sin esto solo puede preguntarle a quien ya sabía que tenía algo, que es exactamente lo contrario de para qué existe un HIE.

Cómo se resuelve

Se consulta el registro de documentos del ecosistema y se recupera únicamente lo que hace falta para la decisión clínica de ese momento.

  • IHE XDS.b / XCA
  • IHE MHD
  • FHIR DocumentReference
Consentimiento y propósito de usoConsumidorObligatorioProductorSegún el casoCustodioObligatorio
Qué es

Declarar para qué se consulta y verificar que hay base para hacerlo, en cada acceso y no una sola vez al inicio.

Si no la tiene

Es donde se frenan los proyectos que ya funcionaban técnicamente. Nadie firma una salida a producción con esto abierto.

Cómo se resuelve

Se define el propósito de uso por caso, se registra la base legal y se ata a la autorización con la que viaja la solicitud, no a una casilla de un formulario.

  • IHE BPPC / APPC
  • FHIR Consent
  • SMART scopes
Publicación conforme al perfilConsumidorSegún el casoProductorObligatorioCustodioObligatorio
Qué es

Entregar lo que usted produce con la estructura, los campos obligatorios y la terminología que exige la guía nacional.

Si no la tiene

Lo que publica se rechaza. O peor: se acepta incompleto y llega así a quien lo consulta, sin que nadie se entere hasta que importa.

Cómo se resuelve

Se valida contra el perfil antes de publicar y se corrige en el origen. Si el sistema origen no puede producirlo, se resuelve con una capa de exposición sin reemplazarlo.

  • HL7 FHIR
  • IHE MHD / XDS.b
Respuesta a consultas en líneaConsumidorSegún el casoProductorSegún el casoCustodioObligatorio
Qué es

Estar disponible para responder cuando el ecosistema pregunta, con un tiempo de respuesta comprometido.

Si no la tiene

Un custodio que no responde deja de serlo en la práctica, y quien consultaba toma la decisión clínica sin ese dato.

Cómo se resuelve

Se compromete la disponibilidad como un número medible, con monitoreo, y se separa el camino de consulta externa del sistema que atiende la operación diaria.

  • IHE XCA / XCPD
  • FHIR RESTful API
Auditoría del accesoConsumidorObligatorioProductorObligatorioCustodioObligatorio
Qué es

Poder reconstruir, meses después, quién accedió a qué información, cuándo y con qué justificación.

Si no la tiene

Es lo primero que le van a pedir ante un reclamo. Si los registros ya rotaron, la respuesta institucional es que no se sabe.

Cómo se resuelve

Se diseña como componente, con retención definida y consulta propia, y se emite el evento en cada transacción del ecosistema y no solo en el sistema local.

  • IHE ATNA
  • FHIR AuditEvent
Identidad de sistema, reloj y no repudioConsumidorObligatorioProductorObligatorioCustodioObligatorio
Qué es

Que el ecosistema sepa que quien pregunta es usted, que todos los registros compartan la misma hora y que lo intercambiado se pueda probar.

Si no la tiene

Sin sincronía de reloj la auditoría no reconstruye nada. Sin firma, un documento intercambiado no prueba quién lo emitió ni que llegó íntegro.

Cómo se resuelve

Certificados por organización y por subsistema, sincronización de reloj, y firma y sellado en los intercambios con valor probatorio.

  • IHE ATNA / CT
  • JAdES
  • mTLS
ObligatorioSegún el caso

Ese tablero es exactamente el primer entregable de una evaluación de brechas: sus filas, con lo que su organización ya tiene, lo que falta y qué cuesta cada una.

Transaccionalidad

Cómo conversa su arquitectura con el HIE

Ninguna integración es una sola llamada. Esta es la secuencia real, y en cada paso hay algo concreto que su arquitectura tiene que poder hacer.

  1. 01

    Identificar al paciente

    Hacia el ecosistema

    Antes de pedir nada hay que resolver de quién se está hablando. Se consulta el índice del ecosistema con los identificadores que usted tiene y se recibe aquel con el que el resto lo conoce.

    • PIX / PDQm
  2. 02

    Averiguar qué existe

    Hacia el ecosistema

    Con la identidad resuelta se pregunta qué información hay sobre esa persona: quién la tiene, de qué tipo es y de cuándo. Todavía no se trae nada.

    • XDS.b / MHD
  3. 03

    Recuperar solo lo necesario

    Hacia el ecosistema

    Se trae el documento o el recurso que hace falta para la decisión de ese momento, no el expediente completo. Lo que se trae de más queda fuera de su control.

    • XCA / FHIR read
  4. 04

    Responder cuando le preguntan

    Hacia su organización

    El mismo circuito, del otro lado: alguien identifica al paciente, ve que usted tiene información y se la pide. Su arquitectura tiene que responder a tiempo, autorizar por caso de uso y recortar la respuesta.

    • XCA / XCPD
  5. 05

    Publicar lo que usted produce

    Hacia el ecosistema

    Cada vez que se genera un hecho clínico relevante se publica conforme al perfil, con la terminología ligada y en el momento en que ocurre. El lote mensual ya no sirve.

    • MHD / FHIR create
  6. 06

    Registrar cada paso

    En ambos extremos

    Cada una de las transacciones anteriores emite un evento de auditoría, en los dos extremos y con la misma hora. Eso es lo que después permite responder un reclamo con hechos.

    • ATNA
    • CT
Cumplimiento

Lo que hay que demostrar antes de que lo dejen conectarse

Entrar a un ecosistema nacional no es un acuerdo técnico entre dos equipos: hay requisitos que se prueban con evidencia. Conviene conocerlos antes de comprometer una fecha, no después.

Conformidad con el perfil nacional

Lo que le exigen

Que lo que publica cumple la guía de implementación vigente, con los campos obligatorios y la terminología ligada.

Con qué lo demuestra

Reporte de validación contra el perfil, con casos de prueba que cubren los escenarios reales y no solo el camino feliz.

Terminologías correctas y vigentes

Lo que le exigen

Que los códigos que envía existen, están vigentes y pertenecen al ValueSet que la guía exige.

Con qué lo demuestra

Validación terminológica automatizada en el punto de publicación, y un plan escrito de qué pasa cuando un ValueSet cambia de versión.

Identidad y autorización

Lo que le exigen

Certificados de organización y de subsistema, y autorización por caso de uso en lugar de acceso general al sistema.

Con qué lo demuestra

Registro en el ecosistema, prueba de autenticación mutua y matriz de qué puede pedir cada consumidor.

Auditoría reconstruible

Lo que le exigen

Registro de cada acceso, con retención definida y capacidad de responder una consulta puntual.

Con qué lo demuestra

Demostración de una búsqueda real: quién vio el expediente de esta persona en los últimos seis meses, respondida en minutos.

Valor probatorio del intercambio

Lo que le exigen

Que lo intercambiado se pueda atribuir a quien lo emitió y probar que no fue alterado, en los casos que lo requieren.

Con qué lo demuestra

Firma y sellado de los documentos o recursos, con validación del lado receptor. Meddyg brindó asistencia técnica al Banco Central de Costa Rica para habilitar el firmado JAdES de recursos FHIR.

Pruebas de conexión superadas

Lo que le exigen

Superar el ciclo de pruebas del ecosistema con datos parecidos a los reales, antes de tocar producción.

Con qué lo demuestra

Ambiente de pruebas con datos sintéticos, juego de casos acordado y evidencia de cada transacción ejecutada de extremo a extremo.

Método

De la decisión de conectarse a la primera transacción en producción

Seis etapas. La primera define su rol, porque todo lo demás —alcance, costo y fecha— depende de eso.

  1. 01

    Definición de rol y casos

    Establecemos qué roles cumple su organización, servicio por servicio, y con qué casos de uso concretos entra al ecosistema. Sin esto, cualquier estimación es una adivinanza.

    Lo que queda
    • Roles asignados por servicio
    • Casos de uso priorizados
    • Alcance de la primera conexión
  2. 02

    Evaluación de brechas

    Contrastamos las capacidades que su rol exige contra lo que su arquitectura hace hoy, y separamos lo que hay que construir de lo que solo hay que configurar. Aquí es donde la fecha se vuelve realista.

    Lo que queda
    • Tablero de brechas por rol
    • Estimación de esfuerzo por brecha
    • Riesgos de la conexión
  3. 03

    Diseño de la integración

    Definimos qué componente habla con el ecosistema, qué transacciones soporta, cómo se autentica y qué se recorta en cada respuesta.

    Lo que queda
    • Diseño de transacciones
    • Punto de exposición y controles
    • Matriz de autorización por caso
  4. 04

    Construcción y conformidad

    Se construye lo que falta y se valida contra el perfil nacional en el origen, no al final. Cuando el sistema origen no puede producir el perfil, se resuelve con una capa de exposición en lugar de reemplazarlo.

    Lo que queda
    • Componentes de integración
    • Reportes de validación
    • Casos de prueba automatizados
  5. 05

    Pruebas con el ecosistema

    Ejecutamos el ciclo de pruebas de extremo a extremo, incluyendo los escenarios que fallan: el paciente que no resuelve, el documento que no cumple, el otro extremo que no responde.

    Lo que queda
    • Evidencia de pruebas
    • Hallazgos y correcciones
    • Aprobación de conexión
  6. 06

    Salida a producción y operación

    Acompañamos la primera transacción real y dejamos el monitoreo, la auditoría y el procedimiento para cuando el que falla es el otro extremo.

    Lo que queda
    • Plan de salida y de reversa
    • Monitoreo y alertas
    • Transferencia al equipo interno
Entregables

Lo que queda en manos de la organización

Material con el que se estima, se contrata y se demuestra el cumplimiento — no una presentación.

Tablero de brechas por rol

Las capacidades que su rol exige, lo que ya tiene resuelto, lo que falta y qué cuesta cada brecha.

Diseño de la integración

Qué componente habla con el ecosistema, qué transacciones soporta y bajo qué controles de identidad, autorización y auditoría.

Expediente de cumplimiento

Los requisitos técnicos y normativos con la evidencia que los demuestra, ordenados para presentarlos tal cual.

Juego de casos de prueba

Los escenarios de conexión, incluidos los que fallan, automatizados para poder repetirlos en cada cambio.

Plan de conexión por etapas

Qué caso de uso entra primero, con qué dependencias, y en qué orden conviene para que algo esté en producción pronto.

Monitoreo y operación

Qué se mide, qué alerta y qué se hace cuando el que deja de responder es el otro extremo.

Casos

Conexiones que están operando

Cada uno de estos proyectos resolvió un rol concreto dentro de un ecosistema de intercambio, y quedó funcionando.

El rol que resolvióTransaccionalidad con el ecosistema

Intercambio nacional sobre X-Road

Pruebas de concepto junto a la Agencia Nacional de Gobierno Digital para validar transacciones de recursos FHIR sobre la plataforma nacional, dentro de la demostración funcional de interoperabilidad de Costa Rica: intercambio seguro entre sistemas distintos, sin centralizar los datos.

El rol que resolvióCustodio que recibe

Servidor FHIR nacional de notificaciones del EDUS/CCSS

Diseño, despliegue a producción y operación del primer servidor FHIR que recibe las notificaciones de enfermedades de notificación obligatoria, vacunas y resultados de laboratorio del EDUS/CCSS, y posteriormente de otros establecimientos de salud.

El rol que resolvióProductor hacia un ecosistema regional

Notificación regional de ESAVI

Parte del equipo de Meddyg participó como consultor en el diseño de la primera guía de implementación HL7© FHIR© para la notificación regional de ESAVI, y en el diseño e implementación de la infraestructura que recibiría esas notificaciones.

El rol que resolvióCustodio de estudios

Intercambio de imágenes médicas bajo DICOM

Implementación de arquitecturas de PACS y estaciones de trabajo de diagnóstico para el intercambio de imágenes médicas bajo el estándar DICOM, en hospitales públicos del Servicio Nacional de Salud de República Dominicana.

Los modelos y perfiles que nombramos en esta página —OpenHIE, IHE, HL7 FHIR— son el método con el que trabajamos, no clientes. Cuando un caso corresponde a un cliente, lo decimos con su nombre.

Para quién

Quién tiene esta conversación pendiente

Sirve tanto a quien ya recibió una fecha de conexión como a quien todavía no sabe qué rol le asignaron.

Instituciones públicas de salud

Cajas, ministerios y hospitales a los que el ecosistema nacional ya les asignó un rol y, muchas veces, una fecha.

Prestadores privados y redes

Clínicas, hospitales y redes que necesitan participar sin abrir su red ni rehacer su expediente.

Laboratorios y servicios de imágenes

Productores de resultados a los que les van a exigir publicar conforme a perfil, en el momento en que el hecho ocurre.

Áreas de TI e integración

Equipos que tienen que responder cuánto tarda y cuánto cuesta conectarse, y hoy no tienen con qué estimarlo.

Proveedores de software de salud

Fabricantes cuyo producto tiene que cumplir el perfil nacional para que su cliente pueda conectarse.

Programas nacionales y regionales

Iniciativas que necesitan conectar a decenas de organizaciones con el mismo criterio, en vez de negociar una por una.

Autodiagnóstico

Señales de que la conexión va a costar más de lo estimado

Le asignaron un rol en el ecosistema y no está seguro de qué implica en obligaciones concretas.
Puede publicar lo que produce, pero no sabe si cumple el perfil nacional hasta que alguien se lo rechaza.
No podría reconstruir quién consultó el expediente de una persona en los últimos seis meses.
Cada consulta al ecosistema se resuelve con un desarrollo distinto, hecho por el proveedor de turno.
Le pidieron una fecha de conexión y la estimación se apoya en lo que espera, no en lo que midió.
Sabe que le va a tocar responder consultas en línea, y hoy el único que podría responder es el sistema que atiende la operación diaria.

Si reconoce tres o más, no le falta un proyecto: le falta un diagnóstico. Ese primer paso se mide en semanas y es lo que hace que la fecha deje de ser una apuesta.

¿Sabe qué rol le tocó y qué le falta para cumplirlo?

Le decimos exactamente qué capacidades le exige su rol, cuáles ya tiene, cuáles faltan y en qué orden conviene construirlas — con la evidencia que el ecosistema le va a pedir.