DocumentaciónSoporteCosta Rica · Contacto
Objetivo del servicio

Interoperar no falla en el transporte: falla en el modelo.

Cuando dos sistemas no logran entenderse, casi nunca es porque el mensaje no llegó. Es porque cada uno guarda el mismo hecho clínico de forma distinta: un campo de texto libre donde el otro tiene un código, una tabla propia de diagnósticos, una fecha que a veces es la de la toma y a veces la del reporte, un identificador que se repite entre establecimientos. Estandarizar el intercambio sin ordenar el modelo solo traslada el problema a la capa siguiente. Este servicio trabaja donde el problema se origina: analizamos el modelo actual, revisamos su diseño, acordamos hasta dónde llega el alcance y proponemos un modelo objetivo con las terminologías, las reglas de normalización y el plan de migración necesarios para llegar a él.

Capas

Un modelo de datos se decide en cinco capas

Las cinco existen aunque nadie las haya decidido. Cuando una se salta, la decisión igual se toma — la toma quien desarrolla, en el momento de desarrollar, y sin dejar registro.

Gobernanza

Qué se decide aquí

Quién es dueño de cada dato, quién aprueba un cambio de modelo, con qué cadencia se versiona y cómo se documenta una decisión para que siga siendo comprensible dentro de tres años.

Qué falla cuando se ignora

Cada proyecto crea su propia variante del mismo concepto, nadie puede revertir un cambio y entender el modelo se vuelve un trabajo de arqueología.

Semántica

Qué se decide aquí

Qué significa exactamente cada dato: a qué terminología se enlaza, con qué fuerza de binding, en qué unidades se expresa y qué se hace con los valores que no tienen código.

Qué falla cuando se ignora

Los sistemas comparten estructuras idénticas y datos incomparables. La analítica agrega cosas distintas bajo el mismo nombre y nadie lo nota.

Sintáctica

Qué se decide aquí

Cómo se estructura la información: qué es un recurso y qué un atributo, cómo se anidan las observaciones, qué cardinalidades aplican y qué significa exactamente un valor ausente.

Qué falla cuando se ignora

Cada integración necesita su propio traductor, ningún mapeo se puede reutilizar y el costo de conectar crece con cada sistema nuevo.

Técnica

Qué se decide aquí

Cómo se persiste y se consulta: esquema físico, índices, versionado de registros, historización y el rendimiento tanto de la consulta clínica como de la analítica.

Qué falla cuando se ignora

El modelo es correcto en papel y la consulta que el clínico necesita tarda minutos, así que alguien construye una tabla paralela y el modelo único deja de ser único.

Normalización

Qué se decide aquí

Qué reglas convierten el dato real —el que ya está cargado, con duplicados, abreviaturas y texto libre— en dato conforme al modelo, y qué se hace con lo que no encaja.

Qué falla cuando se ignora

El modelo nuevo convive con años de datos que no lo cumplen, y la migración se descubre inviable cuando ya se prometió una fecha.

Metodología

Del modelo que hay al modelo que se necesita

Cinco etapas. La primera mira los datos reales, no solo el diagrama.

  1. 01

    Análisis del modelo actual

    Levantamos lo que existe: esquemas, diccionarios, catálogos de códigos propios, formularios y las estructuras que cada sistema realmente usa. Y perfilamos los datos ya cargados —distribuciones, nulos, texto libre, duplicados— porque el modelo documentado y el modelo en producción rara vez coinciden.

    Salidas
    • Inventario de fuentes y esquemas
    • Diccionario de datos consolidado
    • Perfilado de datos reales
    • Catálogos de códigos en uso
  2. 02

    Revisión de diseño

    Evaluamos el modelo contra criterios explícitos en lugar de opiniones: expresividad clínica, trazabilidad de quién registró qué y cuándo, extensibilidad ante un dominio nuevo, consultabilidad para clínica y analítica, y capacidad de sostener el intercambio que la organización necesita.

    Salidas
    • Informe de revisión de diseño
    • Hallazgos por capa
    • Riesgos y deuda de modelo
    • Decisiones que hay que tomar
  3. 03

    Alcance del modelo

    Acordamos hasta dónde llega: qué dominios clínicos entran ahora, con qué granularidad, qué se representa de forma estructurada y qué se acepta como texto por el momento. Cuando el dominio ya tiene un DAK de las SMART Guidelines de la OMS, sus elementos de datos esenciales son el punto de partida del alcance en vez de una lista construida desde cero. Un alcance honesto es lo que hace ejecutable todo lo demás.

    Salidas
    • Documento de alcance
    • Dominios priorizados
    • Granularidad por dominio
    • Qué queda fuera y por qué
  4. 04

    Propuesta de modelo objetivo

    Diseñamos el modelo destino y lo expresamos en los artefactos del enfoque elegido: arquetipos y templates, perfiles y extensiones, o un modelo canónico interno. Con identificadores, terminologías y reglas de conformidad definidas, no pendientes.

    Salidas
    • Modelo lógico objetivo
    • Artefactos del enfoque elegido
    • Estrategia de identificadores
    • Bindings terminológicos
  5. 05

    Gobernanza y evolución

    Un modelo sin proceso de cambio vuelve a divergir en el primer proyecto urgente. Definimos quién aprueba una modificación, cómo se versiona, cómo se comunica y qué compatibilidad se garantiza entre versiones.

    Salidas
    • Política de versionado del modelo
    • Proceso de solicitudes de cambio
    • Roles y responsables por dominio
    • Documentación viva del modelo
Enfoques

¿Qué estandarizamos, y con qué?

openEHR y FHIR se presentan a veces como alternativas excluyentes. No lo son: resuelven problemas distintos y, en más de un ecosistema, conviene usar los dos.

openEHR

El registro clínico

Modela y persiste la información clínica con el modelo separado del software: los arquetipos definen el conjunto máximo de datos de un concepto clínico, los templates lo restringen para un uso concreto y las consultas se escriben contra el modelo, no contra un esquema físico. El contenido lo gobiernan los clínicos, no el equipo de desarrollo.

Artefactos
  • Arquetipos (ADL)
  • Templates operacionales
  • Consultas AQL
  • Modelo de referencia
Cuándo conviene
  • Cuando la organización construye o rehace su repositorio clínico y quiere que el modelo sobreviva al proveedor de software.
  • Cuando el dominio clínico es profundo y cambia seguido, y no se quiere una migración de esquema por cada cambio.
  • Cuando hay que consultar el histórico clínico con una semántica que se mantenga estable a lo largo de los años.

HL7® FHIR®

El intercambio

Modela cómo la información sale de un sistema y entra en otro: recursos con una granularidad pensada para el transporte, perfiles que los restringen a un caso de uso concreto y APIs con búsquedas y operaciones definidas. Es el contrato con el mundo exterior.

Artefactos
  • Perfiles y extensiones
  • ValueSets y bindings
  • CapabilityStatement
  • APIs y parámetros de búsqueda
Cuándo conviene
  • Cuando hay que intercambiar con sistemas, redes o ecosistemas nacionales que ya lo exigen.
  • Cuando el objetivo inmediato es exponer datos existentes sin rehacer la persistencia.
  • Cuando la conformidad debe poder verificarla un tercero, sin acceso a la base de datos.

Modelo canónico

El interior de la organización

El modelo común que la organización usa entre sus propios sistemas, su analítica y sus procesos. No siempre necesita ser un estándar externo, pero sí necesita ser uno solo: es el punto donde se resuelven las diferencias entre fuentes antes de exponer nada hacia afuera.

Artefactos
  • Modelo lógico canónico
  • Diccionario de datos
  • Reglas de derivación
  • Mapeos por fuente
Cuándo conviene
  • Cuando conviven sistemas heredados que no se van a reemplazar en el corto plazo.
  • Cuando la analítica necesita una vista estable que no dependa de la versión de cada fuente.
  • Cuando conviene pagar la traducción entre modelos una sola vez, en un lugar, y no en cada integración.

Cómo se conectan

Elegir uno no excluye a los otros. La ruta habitual va del modelo clínico al contrato de intercambio, y el modelo canónico es lo que evita que cada extremo termine hablando un idioma propio.

  • Arquetipo → template → perfil FHIR: el detalle clínico se conserva en el repositorio y se expone recortado para el intercambio.
  • Modelo canónico → perfil FHIR: los sistemas heredados se normalizan una vez y se exponen conformes sin tocar su persistencia.
  • Terminología compartida: los bindings se definen una vez y valen para los tres enfoques; sin eso, cada uno vuelve a inventar sus códigos.
  • Identificadores comunes: paciente, profesional, establecimiento y episodio deben significar lo mismo en el repositorio, en el canónico y en la API.
Terminologías

Adoptar un vocabulario es una decisión de operación, no de catálogo

Descargar SNOMED CT no es adoptarlo. Cada terminología obliga a decisiones sobre alcance, mantenimiento, licenciamiento y versionado que, si no se toman al inicio, terminan tomándose solas y mal.

SNOMED CT®

Vocabulario clínico de referencia para diagnósticos, procedimientos, hallazgos y contexto clínico.

Decisiones que obliga a tomar
  • Licenciamiento y afiliación en el país donde se va a usar.
  • Qué subsets o refsets se habilitan por formulario y por dominio — nadie usa la terminología completa.
  • Si se crea una extensión nacional o institucional, y quién la gobierna.
  • Cómo se tratan los conceptos inactivados en cada release sin romper el histórico.

LOINC®

Identificación de observaciones, análisis de laboratorio, paneles y variables clínicas.

Decisiones que obliga a tomar
  • Qué código corresponde a cada prueba del catálogo local, incluida la parte que hoy solo existe como nombre interno.
  • Cómo se representan las unidades y si se normalizan a UCUM.
  • Qué se hace con los paneles y con las pruebas que el laboratorio reporta agrupadas.
  • Quién actualiza el mapeo cuando el laboratorio cambia de método o de equipo.

CIE-10 / CIE-11

Clasificación para reporte estadístico, morbilidad, mortalidad y obligaciones regulatorias.

Decisiones que obliga a tomar
  • Qué se registra en clasificación y qué en terminología clínica — no son intercambiables.
  • Cómo se deriva el código estadístico desde el registro clínico sin obligar a una doble digitación.
  • Qué versión exige cada reporte obligatorio y cómo conviven cuando difieren entre sí.

CodeSystem y ValueSet nacionales

Catálogos propios del país —establecimientos, servicios, profesionales— y los ValueSets que imponen las guías nacionales.

Decisiones que obliga a tomar
  • Quién los publica, en qué formato y con qué frecuencia.
  • Cómo se sincronizan con los catálogos internos que ya están en producción.
  • Qué ocurre cuando el catálogo nacional cambia y los sistemas locales todavía no.
  • Cómo se declara la trazabilidad entre el código local y el nacional.

Códigos locales y ConceptMap

Los catálogos que la organización ya tiene y que no van a desaparecer de un día para otro.

Decisiones que obliga a tomar
  • Qué códigos locales se mapean, cuáles se retiran y cuáles se conservan como identificador secundario.
  • Qué equivalencia declara cada mapeo: exacta, más amplia, más específica o inexistente.
  • Dónde vive el mapeo y quién responde por él cuando el catálogo de origen cambia.

Trabajamos con estas terminologías como marco técnico de referencia. El licenciamiento y la afiliación, cuando aplican, corresponden a la organización o al país que las adopta.

Migración

Rediseñar el modelo sin apagar la operación

Un modelo nuevo no sirve de nada si los datos que ya existen no llegan a él. La migración se diseña como un proyecto propio, con fases, criterios de aceptación y una salida de emergencia.

  1. Inventario y perfilado

    Se mide qué hay realmente: volúmenes, calidad, texto libre, duplicados, valores fuera de rango y datos que nunca cumplieron la regla que decían cumplir.

  2. Reglas de normalización

    Se definen las transformaciones y los criterios de calidad: qué se limpia, qué se deduplica, qué se enriquece con terminología y qué se marca como no conforme.

  3. Mapeo y equivalencias

    Se mapea campo a campo y código a código, declarando el tipo de equivalencia de cada mapeo. Lo que no mapea se documenta como excepción; no se descarta en silencio.

  4. Convivencia de modelos

    El modelo viejo y el nuevo operan a la vez durante un período acordado, con doble escritura o con vistas de compatibilidad, para que ningún sistema dependa de una única fecha de corte.

  5. Backfill y validación

    El histórico se migra por lotes y se valida por equivalencia: reconciliación de volúmenes, comparación de agregados y revisión clínica por muestreo. La validación es lo que autoriza el corte.

  6. Corte y retiro

    Se corta el flujo hacia el modelo viejo y se retira cuando se demuestra que ya nadie lo lee, conservando la trazabilidad de cada transformación para poder explicar después de dónde salió un dato.

Reglas que sostienen la migración

  • Ningún dato se transforma sin dejar registro de la regla que lo transformó y de su valor original.
  • Lo que no mapea se marca y se cuenta: una migración que oculta sus excepciones no se puede auditar.
  • La convivencia tiene fecha de fin acordada desde el inicio, o se vuelve permanente.
  • El corte lo autoriza la validación, no el cronograma.
  • El modelo viejo se retira cuando se demuestra que nadie lo consulta, no cuando se asume.
  • Cada fase entrega valor por sí sola, para que una pausa del proyecto no deje la operación a medio camino.
Resultados

Qué recibe su organización

Documentos que se usan durante el rediseño y después de él, no un informe que se archiva.

Análisis del modelo actual

Inventario de fuentes, diccionario consolidado y perfilado de los datos reales.

Revisión de diseño

Hallazgos por capa, riesgos, deuda de modelo y las decisiones que quedan pendientes.

Documento de alcance

Dominios, granularidad y qué queda explícitamente fuera de esta iteración.

Modelo objetivo

Modelo lógico y los artefactos del enfoque elegido: arquetipos y templates, perfiles o modelo canónico.

Catálogo terminológico y ConceptMaps

Bindings por elemento y equivalencias declaradas con los códigos locales.

Reglas de normalización

Transformaciones, criterios de calidad y tratamiento explícito de las excepciones.

Plan de migración por fases

Secuencia, criterios de aceptación, convivencia y condiciones para autorizar el corte.

Gobernanza del modelo

Versionado, proceso de cambio y responsables por dominio.

Experiencia

Modelado en proyectos reales

El trabajo de modelado y terminología detrás de guías de implementación que hoy están publicadas y en uso.

Ángulo de modeladoValueSets y CodeSystems nacionales

IG Terminológica — Costa RicaAbre en una pestaña nueva

Perfiles y ValueSets de las terminologías clínicas compartidas por el ecosistema de salud del país: decidir qué vocabulario aplica a cada elemento, con qué fuerza de binding y quién mantiene el catálogo.

Ángulo de modeladoNormalización para notificación nacional

Notificación desde el EDUS/CCSS

Notificación de enfermedades de notificación obligatoria, vacunas y resultados de laboratorio: alinear lo que el sistema de origen registra con lo que la guía nacional exige recibir, y recibirlo en el primer servidor FHIR nacional.

Estos casos corresponden al trabajo de modelado y terminología dentro de guías de implementación nacionales. El enfoque openEHR forma parte del servicio y se evalúa caso por caso; no aparece aquí porque no formó parte de estos proyectos.

Perfil

¿Para quién es este servicio?

Lo que cambia entre una organización y otra no es el método, sino qué tan caro resulta seguir sin un modelo acordado.

Hospitales y redes hospitalarias

Varios sistemas clínicos que registran el mismo hecho de formas distintas. El modelo común es lo que permite una vista única del paciente.

Instituciones públicas y proyectos nacionales

Ecosistemas que deben acordar el modelo antes de exigir conformidad, para que la guía nacional se apoye en algo decidido y no en un supuesto.

Laboratorios y centros de imágenes

Catálogos propios que deben mapearse a LOINC o a códigos nacionales sin perder el detalle que el laboratorio necesita para operar.

Proveedores de software de salud

Productos cuyo esquema creció por acumulación y que ahora deben exponer datos conformes sin rehacer la base desde cero.

Áreas de analítica y datos

Equipos que dependen de que el dato signifique lo mismo en todas las fuentes para que un indicador sea comparable entre establecimientos.

Aseguradoras

Intercambio con múltiples prestadores donde cada uno codifica a su manera y la equivalencia hay que declararla, no suponerla.

Autodiagnóstico

¿Reconoce alguno de estos problemas?

El mismo dato clínico se registra distinto en cada sistema y ninguno está equivocado.
Tenemos campos de texto libre donde deberíamos tener códigos.
Cada sistema tiene su propia tabla de diagnósticos y ninguna coincide con otra.
Queremos adoptar SNOMED CT o LOINC y no sabemos por dónde empezar ni quién los mantendría.
Nuestro diccionario de datos no coincide con lo que hay realmente en la base.
Un mismo indicador da distinto según de qué fuente se calcule.
Agregar un dominio clínico nuevo obliga a migrar el esquema.
El modelo lo decide quien desarrolla, en el momento de desarrollar.
Tenemos años de datos históricos que no cumplen el modelo que queremos adoptar.
Nadie puede explicar de dónde salió un dato después de tres transformaciones.
Cada integración nueva obliga a escribir otro traductor desde cero.
Necesitamos exponer FHIR y descubrimos que el dato que exige la guía no existe estructurado.

Si reconoce varias de estas situaciones, el problema no está en las interfaces: está en el modelo que hay debajo.

¿Su modelo aguanta lo que le van a pedir?

Antes de exponer APIs o comprometerse con una guía nacional, conviene saber qué representa realmente el modelo y qué falta para llegar a donde se necesita.