HL7® Iniciativa Costa Rica

Guía de Implementación Core de Costa Rica
0.1.0 - ci-build Costa Rica bandera

Guía de Implementación Core de Costa Rica - Compilación local de desarrollo (v0.1.0), generada con las herramientas de compilación de FHIR (HL7® FHIR® Standard). Vea el directorio de versiones publicadas

Inicio

URL oficial: https://hl7.or.cr/fhir/core/ImplementationGuide/hl7.fhir.cr.core Versión: 0.1.0
IG Standards status: Draft Nivel de madurez: 0 Nombre computable: CRCore

Guía en desarrollo: no se debe usar en producción. Es un borrador en discusión en las mesas de trabajo de la Iniciativa HL7® Costa Rica y cambia sin aviso. Está en la etapa de diseño FHIR, publicación continua y discusión, con nivel de madurez FMM 0. Ver el ciclo de vida de las guías.

Oficialización ministerial. La Directriz MS-DM-0521-2026, artículo 1, oficializa la Guía de Implementación Core HL7/FHIR como instrumento técnico nacional de referencia obligatoria. Fue publicada en La Gaceta el 21 de abril de 2026 (documento IN202601050581). Consulte la directriz ministerial, su publicación en La Gaceta y el portal oficial de guías del Ministerio. La oficialización del instrumento no sustituye el ciclo de vida ni convierte esta publicación continua (0.1.0, draft, FMM 0) en una versión normativa. Para cumplimiento, verifique la versión vigente divulgada por el Ministerio de Salud.

Introducción

Esta guía de implementación define los datos comunes que intercambian los sistemas de salud de Costa Rica: el paciente, los profesionales de salud, las organizaciones, las ubicaciones, los servicios, la atención, el documento clínico y la observación. Las guías de dominio del país, como la de informes de imágenes médicas, parten de esta.

La terminología que usa (catálogos, mapeos y sistemas de identificación) está en la guía de terminología de Costa Rica.

Arquitectura de las guías nacionales

La Iniciativa separa las reglas por el alcance que gobiernan:

Guía Responsabilidad Dependencias y perfiles
CR Core R5 Modelos lógicos y perfiles nacionales reutilizables en distintos dominios. Define semántica y restricciones comunes, no el funcionamiento de una plataforma particular. La usan las guías nacionales de dominio. Sus perfiles base deben dejar permitido el espacio que esos dominios puedan necesitar.
CR HIE R5 (prevista) Requisitos de operación de la plataforma nacional de intercambio: directorios, repositorios, interacciones, búsquedas, transacciones y los perfiles que solo tienen sentido por ese contexto. Dependerá de Core y de Terminología. Una guía de dominio dependerá de HIE cuando adopte esos flujos o servicios.
Guías de caso de uso Reglas clínicas o administrativas propias de cada intercambio, como laboratorio e imágenes médicas. Dependerán de Core y perfilarán sus recursos. Dependerán también de HIE cuando usen sus transacciones o servicios.
CR Terminología R5 Sistemas de códigos, conjuntos de valores, mapeos y sistemas de identificación nacionales. Se mantiene como guía común de terminología que referencian Core, HIE y las guías de dominio.

Un perfil de caso de uso derivado de Core puede añadir requisitos y restringir las opciones que Core deja abiertas, pero no puede relajar restricciones heredadas. Por eso los perfiles de Core deben establecer solo las reglas nacionales comunes. Este patrón de capa base reutilizable con guías descendientes se aplica, por ejemplo, en AU Base y AU Core; una guía separada para los servicios de directorio e intercambio se ve en IHE mCSD. Estos precedentes sustentan la organización de responsabilidades; no imponen una estructura única ni son especificaciones FHIR R5.

Distribución inicial de los artefactos de Core

La ubicación actual de algunos artefactos es transitoria mientras se completa la revisión de Core. CRDevice se conserva como perfil base abstracto nacional. CRDeviceSistema, los CapabilityStatement de los servicios del HIE, sus parámetros de búsqueda y las transacciones específicas del repositorio son candidatos a la futura guía CR HIE; no se trasladarán hasta definir esa guía y sus dependencias. El perfil CRDocumentReference actual describe el RLS del HIE y también es candidato a trasladarse. La posible nota quirúrgica en IPS no está confirmada y no justifica ampliar el perfil RLS: si ese caso se adopta, tendrá un perfil IPS propio, derivado del recurso FHIR o de un perfil base nacional solo si se identifican reglas realmente compartidas. Los perfiles de auditoría y procedencia se clasificarán individualmente según si sus reglas son nacionales y transversales o propias de la operación del HIE.

Guías nacionales relacionadas y evolución a R5

El Ministerio de Salud mantiene builds de borrador en FHIR R4 para las notificaciones obligatorias, la notificación de vacunas y los resultados de laboratorio epidemiológicos (Guía de notificaciones). También mantiene una guía R4 para la Receta Digital. Estas guías existentes son parte del contexto nacional de esta Core, pero no son perfiles de FHIR R5 ni se consideran automáticamente conformantes con ella.

Se prevé revisar y mapear estos dominios para su interoperabilidad con Core R5, en coordinación con sus responsables. La orientación inicial es:

Dominio Relación prevista con Core R5
Notificación obligatoria de enfermedades Reutilizar Paciente, organización y profesional cuando corresponda; analizar cada dato del formulario para definir si se mantiene como QuestionnaireResponse o se expresa también con recursos clínicos como Condition u Observation. El formulario por sí solo no determina el modelo de persistencia e intercambio.
Resultados de laboratorio epidemiológicos Perfilar Observation para los análisis y resultados concretos, con categoría laboratory, y determinar en su modelo de dominio cuándo se requieren muestra, método, equipo, informe y contexto de atención.
Vacunación Modelar el acto de inmunización con el recurso FHIR R5 Immunization, reutilizando las referencias comunes a paciente, profesional, organización y ubicación. No se representa como una Observation.
Receta y prescripción digital Definir perfiles R5 de los recursos de medicación que requiera el flujo (por ejemplo, MedicationRequest y MedicationDispense) y reutilizar paciente, profesional, organización y atención.

La transición desde las guías R4 requiere un mapa explícito entre sus cuestionarios, perfiles, terminologías y procesos, y los modelos y perfiles R5 que se acuerden. Si un intercambio nacional necesita aceptar ambos formatos, esa compatibilidad se definirá en una guía de transición o en los servicios correspondientes. Los perfiles Core expresan la semántica acordada para R5; los mapas explicarán su relación con R4.

Antecedentes del proyecto

Los modelos se definen en mesas de trabajo con la participación del Ministerio de Salud, la Caja Costarricense de Seguro Social (CCSS), el Ministerio de Ciencia, Innovación, Tecnología y Telecomunicaciones (MICITT), el Banco Central de Costa Rica (BCCR), por la firma digital con GAUDÍ, el Instituto Nacional de Seguros (INS), la Cámara Costarricense de la Salud, Global Life-Centered Hub, Meddyg, DHIT Costa Rica, Siftia y la Cámara de Tecnologías de Información y Comunicación (CAMTIC). En la guía de informes de imágenes médicas, que parte de esta, participan además el Colegio de Médicos y Cirujanos de Costa Rica, la Asociación Costarricense de Radiología e Imágenes Médicas (ACRIM) y LifeHub. Cada modelo documenta sus datos, sus reglas, sus decisiones y su historial antes de publicarse aquí, y se compara con la guía core de RACSEL para la Ruta Panamericana de Salud Digital (PH4H).

Instituciones participantes

  • Ministerio de Salud de Costa Rica
  • Caja Costarricense de Seguro Social (CCSS)
  • Ministerio de Ciencia, Innovación, Tecnología y Telecomunicaciones (MICITT)
  • Banco Central de Costa Rica (BCCR), por la firma digital con GAUDÍ
  • Instituto Nacional de Seguros (INS)
  • Cámara Costarricense de la Salud
  • Global Life-Centered Hub
  • Meddyg
  • DHIT Costa Rica (Digital Health Institute for Transformation)
  • Siftia
  • CAMTIC, Cámara de Tecnologías de Información y Comunicación

Contenido

Todo el contenido de la guía está en borrador (estado draft, nivel de madurez 0) y en discusión en las mesas de trabajo: ver el ciclo de vida de las guías.

Tema Qué define Artefactos
Personas Quién recibe la atención y quién la da Paciente · Persona relacionada · Profesional de salud · Rol del profesional
Establecimientos Quién presta los servicios de salud, dónde y con qué sistemas Organización · Ubicación · Servicio de salud · Relación entre organizaciones · Sistema de información
Atención y datos clínicos El contexto en que se atiende a la persona y los resultados que se registran Atención · Observación
Documento clínico El documento, su contenido completo y su firma digital con GAUDÍ Documento clínico · Documento clínico (Bundle) · Firma del documento clínico
Intercambio en el HIE Cómo se envían los documentos al HIE, de dónde vienen los datos y quién accedió a ellos Referencia a documento · Lista de documentos enviados · Envío de documentos · Procedencia · Evento de auditoría
Servicios del HIE Qué debe ofrecer cada servidor del HIE, basado en IHE, y las búsquedas propias de Costa Rica Registro de pacientes · Registro de establecimientos · Registro de profesionales · Repositorio de documentos · Repositorio de auditoría · Búsqueda por distrito · Búsqueda por apellido de origen materno
Tipos de datos y extensiones Reglas comunes a todos los perfiles para la dirección y el nombre de las personas Dirección · Nombre · Primer apellido · Segundo apellido
Modelos lógicos Los datos de negocio, independientes de FHIR, con su justificación y su mapeo a FHIR R5 Los 11 modelos

Cada perfil tiene sus reglas (invariantes) y sus ejemplos; todos los perfiles y las extensiones están en Perfiles y extensiones, y la lista completa de artefactos, en el Resumen de artefactos.

Además, la guía explica en páginas propias los servicios del HIE, la firma digital con GAUDÍ y el ciclo de vida de las guías. Los paquetes para descargar, las dependencias y la licencia están en el menú Soporte: Descargas y Licencia y aspectos legales.

Autores y colaboración

Esta guía es producto del trabajo colaborativo de las siguientes personas:

Nombre Rol Organización o institución
Ing. Alejandro Benavides Coordinación, autor y asesor Meddyg - DHIT Costa Rica
Ing. Deivert Sivianny Guiltrichs Coordinación nacional Ministerio de Salud
Ing. Pedro Meckbel Coordinación nacional Ministerio de Salud
Dr. Daniel Quesada Coordinación nacional y estratégica Ministerio de Salud
Ing. Manuel Rodríguez Coordinación institucional Caja Costarricense de Seguro Social (CCSS)
Dr. Eduardo Rodríguez Coordinación institucional y asesor clínico Caja Costarricense de Seguro Social (CCSS)
Lic. Paul Fervoy Asesor técnico Siftia - CAMTIC