RIPS JSON e Interoperabilidad: Guía de Gestión Médica

La interoperabilidad y los RIPS JSON en Colombia son hoy una obligación normativa, no una opción tecnológica. La Resolución 2275 de 2023 del Ministerio de Salud reemplazó los archivos planos .txt por el formato JSON como soporte obligatorio de la Factura Electrónica de Venta (FEV) en salud. Simultáneamente, la Resolución 1888 de 2025 impone el estándar HL7 FHIR para el intercambio interoperable de la Historia Clínica Electrónica, redefiniendo estructuralmente la gestión médica en el país.

Introducción: Un sistema de salud en transformación digital irreversible

Durante más de dos décadas, el sector salud colombiano operó con una arquitectura de datos fragmentada, basada en archivos de texto plano (.txt) definidos por la Resolución 3374 de 2000. Este modelo, concebido en los albores de la era digital, resultó progresivamente insuficiente frente a los volúmenes de información, la complejidad asistencial y las exigencias de trazabilidad que demanda el Sistema General de Seguridad Social en Salud (SGSSS).

El análisis técnico demuestra que los archivos planos ofrecían escasa capacidad de validación en tiempo real, generaban errores de estructura difícilmente detectables antes de la facturación, y no permitían integración nativa con sistemas modernos de historia clínica electrónica. La consecuencia directa era la proliferación de glosas, reprocesos administrativos y retrasos en el flujo de pago entre IPS y EPS.

La respuesta del Ministerio de Salud y Protección Social ha sido contundente: una reforma normativa en dos capas complementarias. La primera, de carácter administrativo-financiero, transformó el modelo de reporte mediante la Resolución 2275 de 2023. La segunda, de alcance clínico-asistencial, instauró la interoperabilidad plena de la historia clínica mediante la Resolución 1888 de 2025. Comprender ambas capas es imperativo para cualquier actor del sector.

¿Qué son los RIPS y cuál es su función estructural en el SGSSS?

El Registro Individual de Prestación de Servicios de Salud (RIPS) es el conjunto de datos mínimos y básicos que el Sistema General de Seguridad Social en Salud requiere para los procesos de dirección, regulación y control, y como soporte de la venta de servicio, cuya denominación, estructura y características se ha unificado y estandarizado para todas las entidades.

Los datos del RIPS abarcan cuatro dimensiones fundamentales:

1. Identificación del prestador del servicio de salud
2. Identificación del usuario que recibe la atención
3. Caracterización de la prestación: tipo de servicio, diagnóstico CIE-10/CIE-11, procedimientos CUPS
4. Motivo de la atención: diagnóstico principal, causa externa, finalidad de la consulta

Los RIPS abarcan datos que van desde la identificación del prestador de servicios y del usuario, hasta detalles específicos de la atención médica proporcionada, incluyendo consultas, procedimientos, hospitalizaciones, urgencias, y prescripción de medicamentos.

Este conjunto de registros constituye la fuente de información autorizada para la facturación en salud y alimenta los sistemas de vigilancia epidemiológica, control de calidad asistencial y gestión del riesgo individual y colectivo.

¿Por qué la Resolución 2275 de 2023 reemplazó el modelo de archivos planos?

Durante más de 20 años, los RIPS se enviaron en archivos de texto plano (.txt), un formato heredado de los años 90 que resultaba rígido, propenso a errores y difícil de validar automáticamente. Con la Resolución 2275 de 2023, el Ministerio de Salud reemplazó la antigua Resolución 3374 de 2000 y mandó la transición al formato JSON (JavaScript Object Notation), un estándar moderno que permite estructurar la información de forma más robusta, legible y validable en tiempo real.

El cambio de paradigma no es meramente técnico. Los RIPS en JSON se convierten ahora en el soporte obligatorio de la Factura Electrónica de Venta (FEV) en salud. Es decir, no es posible emitir una factura electrónica médica sin tener el RIPS JSON correspondiente correctamente validado.

Las implicaciones para la cadena de valor del sector son profundas:

• Sin RIPS JSON válido → no hay Código Único de Validación (CUV)
• Sin CUV → la EPS puede objetar o rechazar la factura
• Sin factura válida → el prestador no recibe pago por los servicios prestados

Las modificaciones buscan promover la eficiencia, transparencia y trazabilidad en la prestación y facturación de los servicios de salud, respondiendo a las exigencias contemporáneas de integración de sistemas y mejora continua en la atención al paciente.

¿Cómo funciona el flujo técnico del RIPS JSON y el Mecanismo Único de Validación (MUV)?

La integración entre la Factura Electrónica de Venta y los RIPS en JSON fue regulada mediante la Resolución 1884 de 2024, que también introdujo el Mecanismo Único de Validación (MUV).

El flujo operativo obligatorio es el siguiente:

1. Registro de la atención en el sistema de historia clínica electrónica con diagnóstico (CIE-10/CIE-11) y procedimientos (CUPS)
2. Generación automática del RIPS en formato JSON por el software médico
3. Emisión de la Factura Electrónica de Venta (FEV) en formato XML con extensión del sector salud
4. Transmisión conjunta (RIPS JSON + FEV XML) al Mecanismo Único de Validación (MUV) del Ministerio
5. Obtención del CUV (Código Único de Validación): certificación de que el RIPS fue aprobado y corresponde a la factura

El RIPS como soporte de la FEV en salud debe generarse simultáneamente, dada la necesidad de conciliar los valores objeto de facturación, los pagos moderadores y garantizar la consistencia de la información entre ambos documentos.

¿Cuáles son los plazos de implementación por grupo de prestadores?

Todos los prestadores de servicios de salud deberán obtener la validación exitosa de información ante el mecanismo en las fechas definidas por el Ministerio: a partir del 1 de febrero de 2025 los PSS del grupo 1, del 1 de abril de 2025 los PSS del grupo 2, y del 1 de julio de 2025 para el grupo 3.

La implementación gradual fue respaldada por un proceso amplio de acompañamiento técnico. Entre abril y septiembre de 2024 se realizaron un total de 102 eventos con la asistencia de 6.740 personas de 2.227 entidades y 324 profesionales independientes, con la participación de proveedores tecnológicos de soluciones informáticas.

Tabla comparativa: Resolución 3374/2000 vs. Resolución 2275/2023

¿Cuáles son los errores más críticos en la generación del RIPS JSON?

El análisis técnico de los rechazos en el MUV revela patrones recurrentes que los equipos de facturación deben conocer:

• Error de sintaxis JSON: una coma adicional, una llave sin cerrar o un campo nulo donde se espera texto invalidan el documento completo. La regla fundamental: nunca editar el JSON manualmente.
• Inconsistencia de NIT: el NIT reportado en el RIPS debe coincidir exactamente con el utilizado en la autenticación ante el MUV.
• Diagnóstico CIE-10 incorrecto: el código debe tener exactamente 4 caracteres y corresponder a la tabla de referencia vigente.
• Desvinculación RIPS-FEV: los valores facturados deben ser consistentes entre ambos documentos; cualquier discrepancia genera rechazo automático.
• Incumplimiento de plazos: los RIPS deben transmitirse dentro de los 5 días hábiles posteriores al cierre del mes de atención.

Con las nuevas versiones del MUV, al disponer de informes de rechazo más detallados, los equipos de facturación pueden corregir errores con mayor rapidez, logrando menor cantidad de reprocesos y una trazabilidad temporal más confiable.

¿Qué es la interoperabilidad de la Historia Clínica Electrónica (IHCE) y por qué va más allá del RIPS?

Si los RIPS JSON representan la capa financiero-administrativa de la transformación digital, la Interoperabilidad de la Historia Clínica Electrónica (IHCE) constituye la capa clínico-asistencial. Ambas son complementarias y forman el ecosistema de salud digital colombiano.

La interoperabilidad en salud dejó de ser una aspiración para convertirse en una obligación normativa en Colombia. Con la Resolución 1888 de 2025, el Ministerio de Salud y Protección Social establece reglas claras para el intercambio de información clínica mediante el Resumen Digital de Atención en Salud (RDA), un documento electrónico clave dentro de la historia clínica electrónica interoperable.

El estándar HL7 FHIR (Fast Healthcare Interoperability Resources) es un estándar de intercambio de datos en el ámbito de la salud desarrollado por HL7 (Health Level Seven International), diseñado para facilitar el intercambio de información entre sistemas de información de salud, como registros médicos electrónicos, aplicaciones móviles de salud, dispositivos médicos y otros sistemas relacionados.

¿Qué establece concretamente la Resolución 1888 de 2025?

La Resolución 1888 de 2025 adopta el Resumen Digital de Atención en Salud (RDA) como documento electrónico obligatorio para todos los prestadores registrados en el REPS. El intercambio se realiza bajo el estándar internacional HL7 FHIR R4 y la información debe transmitirse de forma cifrada (TLS 1.3 + AES-256) a la plataforma nacional del Ministerio de Salud.

El Resumen Digital de Atención en Salud (RDA) es un resumen clínico estructurado, expresado en estándares como HL7 FHIR y en los catálogos terminológicos definidos por el Ministerio de Salud, que permite que cualquier profesional autorizado acceda a los datos relevantes del paciente sin importar en qué institución se originó la atención.

El flujo operativo del RDA contempla tres fases:

1. Generación: el prestador captura y estructura los datos clínicos desde su sistema HIS, los valida y construye el RDA en formato estandarizado
2. Envío: el documento se transmite de forma segura a la plataforma nacional, donde es validado y recibe el número único de atención VIDA
3. Consulta: profesionales de salud autorizados acceden al RDA en tiempo real para garantizar la continuidad asistencial

A partir de los datos registrados en la atención, el HIS construye un resumen estructurado que puede mapearse a los recursos HL7 FHIR definidos en la guía RDA, reduciendo al mínimo la intervención manual y el riesgo de errores.

¿Cuál es la infraestructura técnica de la plataforma IHCE?

La arquitectura de la plataforma IHCE incluye: un Servidor HL7 FHIR que almacena y gestiona recursos estandarizados; un Master Patient Index (MPI) que asegura la identificación unívoca de los pacientes; un Gestor de RDA y Repositorio que valida y organiza los documentos enviados; un Visor RDA para la consulta por profesionales autorizados; un Servidor terminológico que garantiza coherencia semántica; y un API Gateway que gestiona la seguridad y el control de accesos.

El proyecto de Interoperabilidad de Historia Clínica Electrónica (IHCE) del Ministerio de Salud y Protección Social ha sido financiado con recursos del Banco Interamericano de Desarrollo (BID), con la participación de HL7 Colombia en el diseño de perfiles y la guía de implementación.

¿Cuáles son los plazos de la Resolución 1888 de 2025?

Las entidades obligadas cuentan con un plazo máximo de seis (6) meses, contados a partir del 15 de octubre de 2025, para integrar sus sistemas con el modelo definido en el marco de la Interoperabilidad de la Historia Clínica Electrónica (IHCE). Esto implica que el plazo máximo de cumplimiento es el 15 de abril de 2026.

La Resolución 1888 aplica a todos los prestadores de servicios de salud registrados en el REPS, incluyendo clínicas y hospitales, consultorios odontológicos y médicos, IPS independientes o especializadas, centros de diagnóstico y laboratorios, y profesionales que emitan facturación o reportes RIPS.

Impactos diferenciados por tipo de actor del SGSSS

Los efectos de esta doble transformación normativa no son homogéneos. El análisis por actor del sistema revela lo siguiente:

IPS de alta complejidad

• Requieren integración profunda entre HIS, software de facturación y MUV
• Deben garantizar generación automática del RDA al final de cada atención
• La inversión tecnológica es mayor, pero el retorno en eficiencia es inmediato

Profesionales independientes

• En Colombia hay más de 55.000 prestadores de salud activos, de los cuales cerca del 78% son profesionales independientes. Este grupo enfrenta la mayor curva de adaptación tecnológica
• Desde el 1 de abril de 2025 ya están en obligación plena del RIPS JSON; no hay periodo de gracia para el modelo .txt

EPS y Entidades Responsables de Pago (ERP)

• Se convierten en receptoras de RIPS JSON y FEV XML con validación previa por MUV
• Deben implementar validadores en línea para la recepción y auditoría de documentos
• La glosa por RIPS inválido les genera responsabilidades de gestión adicionales

Proveedores de Tecnología en Salud (PTS)

• Los proveedores de tecnología deben adaptar sus APIs y soluciones cliente-servidor para garantizar la generación automática del JSON con CUV y la ejecución de las validaciones de segundo nivel definidas por el Ministerio.

Conclusión: Próximos pasos y hoja de ruta para el sector salud colombiano

La implementación de RIPS JSON e interoperabilidad HL7 FHIR en Colombia no es un proyecto aislado de modernización tecnológica: es la base sobre la cual se construirá la inteligencia en salud del país. Las métricas empíricas sugieren que los sistemas con mayor nivel de automatización en la generación del RIPS reducen los tiempos de ciclo de facturación en más del 60% y eliminan prácticamente los rechazos por errores de estructura.

Los próximos pasos prácticos para los actores del sector son:

1. Auditar de inmediato el estado actual del software de historia clínica y facturación frente a los requisitos de la Resolución 2275/2023 y la Resolución 1888/2025
2. Verificar la integración con el MUV en ambiente de pruebas antes de la transmisión en producción, utilizando el validador oficial disponible en la plataforma SISPRO
3. Capacitar a los equipos clínicos y administrativos en el manejo del nuevo flujo RIPS JSON + FEV, dado que los errores más frecuentes tienen origen en el diligenciamiento de los datos asistenciales
4. Implementar la conectividad con la plataforma IHCE para el envío del RDA bajo HL7 FHIR R4, asegurando cifrado TLS 1.3 y autenticación vía el API Gateway del Ministerio
5. Establecer tableros de control y alertas para monitorear en tiempo real el estado de los RIPS transmitidos, los CUV obtenidos y los rechazos del MUV con sus causas específicas

La implementación en entornos reales requiere una arquitectura tecnológica que integre de manera nativa la historia clínica, la facturación electrónica y los mecanismos de interoperabilidad. Los prestadores que adopten este ecosistema de manera proactiva no solo cumplirán la normativa vigente, sino que estarán posicionados para operar en el modelo de salud basado en datos que el Ministerio de Salud está construyendo sistemáticamente para Colombia.

Referencias Oficiales

1. Resolución 3374 de 2000 — Ministerio de Salud. Reglamenta los datos básicos de RIPS (derogada). https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/DIJ/Resolución_3374_de_2000.pdf
2. Resolución 2275 de 2023 — Ministerio de Salud y Protección Social. Resolución única reglamentaria de RIPS como soporte de la FEV en salud. https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/DIJ/resolucion-2275-de-2023.pdf
3. Resolución 1884 de 2024 — Ministerio de Salud y Protección Social. Reglamenta el Mecanismo Único de Validación (MUV) de RIPS + FEV. https://www.sispro.gov.co/central-financiamiento/Pages/facturacion-electronica.aspx
4. Resolución 1888 de 2025 — Ministerio de Salud y Protección Social. Adopta el Resumen Digital de Atención (RDA) en el marco de la IHCE. https://consultorsalud.com/colombia-resumen-digital-de-atencion-en-salud/
5. Ley 2015 de 2020 — Congreso de Colombia. Crea la Historia Clínica Electrónica Interoperable (IHCE). https://www.minsalud.gov.co/ihc/Paginas/Interoperabilidad-de-Historia-Clinica-QA.aspx
6. Lineamientos para la generación, validación y envío del RIPS como soporte de la FEV — Ministerio de Salud y Protección Social. https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/OT/lineamientos-generacion-validacion-rips-factura-electronica-fev-doc-electronicos.pdf
7. Manual de usuario Convertidor JSON — Resolución 2275 de 2023 — Ministerio de Salud y Protección Social. https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/OT/manual-usuario-convertidor-json-resolucion-2275-de-2023.pdf
8. Manual de Operaciones IHCE — Interoperabilidad Historia Clínica Electrónica — Ministerio de Salud y Protección Social. https://www.minsalud.gov.co/ihce/Manuales/Manual_de_operaciones_Historia_Clinica_Interoperable_IHCE_V1.pdf
9. Guía de Implementación HL7 FHIR — Resumen Digital de Atención (RDA) — HL7 Colombia / MinSalud. https://vulcano.ihcecol.gov.co/
10. SISPRO — Plataforma de Facturación Electrónica en Salud — Ministerio de Salud y Protección Social. https://www.sispro.gov.co/central-financiamiento/Pages/facturacion-electronica.aspx