¿Qué es FHIR en la historia clínica?
Actualizado el
Desde que el IHCE es obligatorio, "FHIR" aparece en todas las conversaciones sobre historia clínica. No necesitas entenderlo para cumplir, pero sí conviene saber qué es, por qué el Estado lo eligió y qué preguntas hacerle a tu software. Esta guía lo explica sin tecnicismos.
Qué es FHIR, en una frase
FHIR son las siglas de Fast Healthcare Interoperability Resources. Es un estándar internacional para intercambiar información de salud entre sistemas distintos, publicado por HL7 International, una organización que lleva décadas definiendo estándares para el sector.
El propio anexo técnico de la Resolución 1888 de 2025 lo define así, y esta es la definición legal que aplica en Colombia:
"FHIR: Estándar para el intercambio electrónico de información de salud, que tiene como objetivo mejorar la interoperabilidad entre sistemas de salud."
Por qué te lo mencionan a ti
Porque el RDA —el Resumen Digital de Atención en Salud que debes enviar al IHCE en cada atención— viaja en FHIR. El anexo técnico de la Resolución 1888 de 2025 lo exige textualmente en su sección 7.5:
"Se aceptará un archivo en formato JSON […] conforme a las especificaciones del estándar HL7 FHIR […] El archivo deberá contener instancias de recursos HL7 FHIR estructuradas según la Guía de Implementación publicada por el Ministerio de Salud y Protección Social."
Es decir: FHIR no es una recomendación técnica ni una moda del sector. Es el formato que la norma exige para que tus atenciones entren al repositorio nacional. → Ver ¿qué es el IHCE? y la Resolución 1888 explicada.
Los tres conceptos que vale la pena entender
1. El "recurso": cada dato clínico tiene su molde
FHIR parte de una idea simple: en vez de inventar un formato para cada institución, define moldes estándar —llamados recursos— para cada tipo de información clínica. Un recurso tiene identidad propia, un tipo definido por la especificación y una versión que cambia cuando cambia su contenido.
Así se traduce lo que tú registras en la consulta:
| Lo que haces al atender | El recurso FHIR que lo representa |
|---|---|
| Identificar al paciente | Patient |
| Abrir la consulta | Encounter |
| Registrar un diagnóstico | Condition |
| Anotar un signo vital o un resultado | Observation |
| Prescribir un medicamento | MedicationRequest |
| Registrar un procedimiento | Procedure |
| Identificarte como profesional | Practitioner |
| Identificar tu consultorio o sede | Organization / Location |
| Registrar una alergia | AllergyIntolerance |
| Registrar una vacuna | Immunization |
Cuando alguien dice "el RDA lleva un Condition", está diciendo "lleva el diagnóstico en el molde estándar de diagnósticos". Nada más.
2. El "Bundle": el sobre que lleva todo junto
Una atención no es un dato suelto: es el paciente, más el encuentro, más el diagnóstico, más lo que prescribiste. FHIR los empaqueta en un Bundle. La mejor explicación es la del propio anexo técnico de la Resolución 1888:
"Actúa como un contenedor que permitirá organizar los datos de forma coherente, asegurando que los distintos recursos FHIR incluidos mantengan sus relaciones lógicas y contextuales. Por ejemplo, un Bundle puede incluir un recurso Patient, junto con los recursos Encounter, Condition, Procedure y MedicationRequest correspondientes a un evento de atención, lo que permite representar de manera completa un evento clínico."
En el IHCE, el RDA es un Bundle de tipo document con un recurso Composition en la primera entrada: el Composition funciona como la portada que dice qué documento es y qué contiene.
3. La API: los sistemas se hablan solos
FHIR no es solo un formato de archivo: define también cómo se piden y se envían esos datos por internet, con una API REST. Esa es la diferencia entre interoperar de verdad y "exportar un archivo y subirlo a un portal".
Por eso el IHCE funciona con credenciales de máquina —un client_id, un client_secret y las llaves del API— y no con un usuario y clave que tú escribas cada vez. Tu software se autentica y transmite. → El trámite está en cómo cumplir el IHCE.
Qué versión de FHIR usa Colombia
FHIR tiene versiones, y no todas son equivalentes:
| Versión | Publicada | Estado |
|---|---|---|
| R4 (4.0.1) | 2018-2019 | Primera versión con núcleo normativo; la más adoptada en el mundo |
| R4B (4.3.0) | 2022 | Versión intermedia |
| R5 (5.0.0) | 2023 | La más reciente publicada, en trial use |
| R6 | — | En proceso de balotaje, aún no publicada |
Colombia adoptó R4, y está declarado en los documentos oficiales del IHCE. Es la decisión sensata: R4 es la versión cuyo núcleo alcanzó estatus normativo y la que tiene el ecosistema de herramientas más maduro, y es la que usan la mayoría de los programas nacionales de interoperabilidad.
(Un matiz para no exagerar: la especificación R4 se describe a sí misma como "mixed normative and STU" — parte de ella es normativa y parte sigue en uso de prueba.)
La guía colombiana existe y es pública
FHIR es un estándar general; cada país lo aterriza con una guía de implementación que dice qué campos son obligatorios, con qué terminologías y en qué estructura. Colombia tiene la suya:
- Se llama Resumen Digital de Atención en Salud (RDA).
- Va en la versión 1.0.0 (STU1), publicada el 29 de diciembre de 2025.
- Usa FHIR R4 (4.0.1).
- Define 47 perfiles, 25 extensiones y decenas de conjuntos de códigos.
- Define cuatro Bundles de tipo documento, uno por cada tipo de RDA: paciente, hospitalización, consulta externa y urgencias.
Está publicada en el portal del IHCE y cualquiera puede consultarla. Eso es relevante para ti por una razón concreta: puedes verificar si tu proveedor cumple. No hay que creerle de palabra.
Las terminologías: FHIR es el sobre, no el contenido
FHIR estandariza la estructura; los códigos vienen de terminologías aparte. En Colombia, las que aparecen en la guía del Ministerio son CIE-10 para diagnósticos, CUPS para procedimientos, LOINC para resultados de laboratorio y SNOMED CT para conceptos clínicos.
Un apunte honesto sobre SNOMED CT: la guía del Ministerio la incorpora entre sus terminologías, pero Colombia no figura hoy entre los 54 países miembros de SNOMED International. Es un punto abierto que vale la pena seguir, y no algo que convenga dar por resuelto.
Para los códigos que sí te afectan a diario, mira CIE-10 y CIE-11 en los RIPS.
Qué NO es FHIR
Aclarar esto ahorra confusiones caras:
- No es un software. Nadie "compra FHIR". Es un estándar; lo que se compra es un sistema que lo implemente.
- No es una base de datos nacional de historias clínicas. La base es el repositorio del IHCE; FHIR es el idioma en que le hablas.
- No es un formato que tú debas escribir. El RDA en FHIR no se hace a mano, y no se espera que lo hagas.
- No reemplaza tu historia clínica. Tu historia sigue rigiéndose por la Resolución 1995 de 1999. FHIR es lo que sale de ella hacia el IHCE. → Ver la Resolución 1995 de 1999.
- No tiene nada que ver con los RIPS. Los RIPS van en JSON con una estructura propia del Ministerio, no en FHIR. Son dos carriles distintos. → Ver ¿RIPS y RDA son lo mismo?.
Qué preguntarle a tu proveedor de software
Tres preguntas concretas, todas verificables:
- ¿Generan el RDA en FHIR R4 conforme a la Guía de Implementación del Ministerio? La respuesta correcta menciona la guía, no solo "sí, usamos FHIR".
- ¿Lo transmiten automáticamente al firmar la consulta? Si hay que exportar y subir algo a mano, el trabajo quedó de tu lado.
- ¿Qué pasa si el envío falla? Un sistema serio reintenta y te dice qué atenciones quedaron sin transmitir.
Si tu duda de fondo es si a ti te toca reportar, está en ¿quién debe reportar al IHCE?.
Lo que importa para ti
FHIR no cambia cómo atiendes: cambia lo que tu software tiene que saber hacer. Tu parte es documentar bien la consulta y firmarla; la parte del software es convertir eso en un RDA válido y transmitirlo. Alira arma el RDA en FHIR y lo envía al IHCE al firmar cada consulta, sin que toques un archivo.
→ Empieza gratis 30 días en aliramed.com
Aviso
Esta guía es informativa y no constituye asesoría legal ni técnica. Fuentes oficiales:
- Guía de Implementación del RDA (Colombia) — MinSalud: https://vulcano.ihcecol.gov.co/
- Resolución 1888 de 2025 y su anexo técnico — MinSalud: https://www.minsalud.gov.co/Normatividad_Nuevo/Resolucion%20No%201888%20de%202025.pdf
- Especificación HL7 FHIR R4: https://www.hl7.org/fhir/R4/index.html
- Qué es un recurso en FHIR: https://www.hl7.org/fhir/R4/resource.html
- Recurso Bundle: https://www.hl7.org/fhir/R4/bundle.html
- Historial de versiones de FHIR: https://hl7.org/fhir/history.html
- Países miembros de SNOMED International: https://www.snomed.org/members
¿Estás cumpliendo el IHCE hoy?
Responde 6 preguntas y recibe tu diagnóstico personalizado más la guía completa por correo.
Hacer el diagnósticoPreguntas frecuentes
- ¿Qué significa FHIR?
- Fast Healthcare Interoperability Resources. Es un estándar internacional para intercambiar información de salud entre sistemas distintos, publicado por HL7 International. El anexo técnico de la Resolución 1888 de 2025 lo define como el "estándar para el intercambio electrónico de información de salud, que tiene como objetivo mejorar la interoperabilidad entre sistemas de salud".
- ¿Por qué me hablan de FHIR si yo solo atiendo pacientes?
- Porque el RDA que debes enviar al IHCE en cada atención viaja en FHIR: la sección 7.5 del anexo técnico de la Resolución 1888 de 2025 exige un archivo JSON conforme al estándar HL7 FHIR y estructurado según la Guía de Implementación del Ministerio. No tienes que escribirlo tú: es lo que tu software debe saber hacer.
- ¿Qué es un Bundle en FHIR?
- El sobre que agrupa los datos de una atención. El anexo técnico de la Resolución 1888 lo explica así: "actúa como un contenedor que permitirá organizar los datos de forma coherente […] un Bundle puede incluir un recurso Patient, junto con los recursos Encounter, Condition, Procedure y MedicationRequest correspondientes a un evento de atención". En el IHCE el RDA es un Bundle de tipo document con un recurso Composition en la primera entrada.
- ¿Qué versión de FHIR usa Colombia?
- R4 (4.0.1). Es la primera versión de FHIR cuyo núcleo alcanzó estatus normativo y la más adoptada en el mundo, aunque ya existe R5 publicada en 2023 y R6 está en proceso de balotaje. La Guía de Implementación colombiana del RDA, en su versión 1.0.0 (STU1) publicada el 29 de diciembre de 2025, está construida sobre R4.
- ¿FHIR es lo mismo que los RIPS?
- No, y son dos carriles distintos. Los RIPS van en un JSON con estructura propia del Ministerio, definida en el documento técnico de la Resolución 948 de 2026, y sirven de soporte de la factura. El RDA va en FHIR al repositorio del IHCE y sirve para la continuidad clínica. Cumplir uno no implica cumplir el otro.
- ¿Colombia usa SNOMED CT?
- La Guía de Implementación del Ministerio incorpora SNOMED CT entre sus terminologías, junto con CIE-10, CUPS y LOINC. Pero Colombia no figura hoy entre los 54 países miembros de SNOMED International, así que es un punto abierto y no conviene darlo por resuelto. Para el día a día, los códigos que te afectan son CIE-10 y CUPS.
Guías relacionadas
- ¿Qué es el IHCE? Interoperabilidad clínicaQué es el IHCE (Interoperabilidad de la Historia Clínica Electrónica), de dónde viene (Ley 2015 de 2020), cómo funciona con el RDA en FHIR y por qué aplica a los profesionales independientes.
- Resolución 1995 de 1999: historia clínicaLa Resolución 1995 de 1999 regula la historia clínica en Colombia: características obligatorias, por qué un Excel no cumple, y cuánto tiempo debes conservarla (15 años, según la Res. 839 de 2017).
- Firma electrónica en la historia clínicaQué es la firma electrónica en la historia clínica, en qué se diferencia de la firma digital, qué necesitas para cerrar tus historias y facturar, y por qué firmar debe dejar el registro inmutable.
Alira envía tu RDA al IHCE y genera tus RIPS al firmar cada consulta.
Empezar gratis 30 días