HL7® Iniciativa Costa Rica

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

Guía de Implementación de Terminología 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/terminology/ImplementationGuide/hl7.fhir.cr.terminology Versión: 0.1.0
IG Standards status: Draft Nivel de madurez: 0 Nombre computable: CRTerminology
Otros identificadores: OID:2.16.188.1.506100.1

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 Terminológica 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 reúne la terminología que usan las guías FHIR R5 de Costa Rica: sistemas de códigos, conjuntos de valores, mapeos hacia terminologías internacionales y sistemas de identificación. Las demás guías del país, empezando por la guía core, dependen de esta para sus bindings y sus identificadores.

Esta guía no define perfiles. Los perfiles que usan estos artefactos están en la guía core.

Antecedentes del proyecto

Los catálogos se definen en mesas de trabajo con la participación del Ministerio de Salud, la Caja Costarricense de Seguro Social (CCSS), el Colegio de Médicos y Cirujanos de Costa Rica, la Asociación Costarricense de Radiología e Imágenes Médicas (ACRIM), Meddyg y LifeHub. Cada catálogo parte de un modelo lógico y documenta su fuente, sus decisiones y su historial antes de publicarse aquí.

La guía reutiliza terminologías internacionales (HL7 Terminology, ISO 3166, LOINC) cuando cubren la necesidad del país, y crea códigos propios solo cuando no existe un equivalente exacto.

Contenido

Área Artefactos
Identificación Tipos de identificación de personas y organizaciones, mapeos a HL7 v2-0203 y sistemas de identificación
Datos demográficos y división territorial Provincias, cantones y distritos de la DTA del SNIT; estado civil, sexo asignado al nacer, origen del apellido, tipo de relación y equivalencia de países ISO 3166-1
Organizaciones, ubicaciones y servicios Tipo de establecimiento, nivel de atención, categoría, autorización de salud, relación entre organizaciones, forma de la ubicación, tipo de servicio, requisito de acceso, idioma y tipo de sistema de información
Profesionales de salud Profesión (con su equivalencia ISCO-08), colegio profesional, especialidad y programas de la CCSS
Atención, documentos y observaciones Función del profesional en la atención; tipo, clase, estado y relaciones del documento clínico; estado y categoría de la observación
Seguridad, procedencia y auditoría Confidencialidad, sensibilidad, propósito de uso, actividad y agentes de la procedencia, categoría y agentes de la auditoría

El detalle está en Terminología y en el Resumen de artefactos.

Cómo leer esta guía

  • Inicio: propósito y alcance.
  • Conformidad: lo que debe cumplir un sistema que declara usar esta terminología.
  • Guía: reglas de uso comunes a todos los artefactos e identificadores.
  • Artefactos FHIR: los CodeSystems, ValueSets, ConceptMaps y NamingSystems.
  • Soporte: descargas, con las dependencias de la guía, y licencia y aspectos legales, con las terminologías de terceros.
  • Registro de cambios: cambios entre versiones.