RIPS en Formato JSON y Factura Electrónica de Venta: Guía para Cumplir la Resolución 2275 en Colombia

Qué son los RIPS y por qué cambiaron a formato JSON

Los RIPS (Registros Individuales de Prestación de Servicios de Salud) son el conjunto de datos que todo prestador de salud en Colombia debe reportar cada vez que atiende a un paciente. Contienen información sobre quién fue atendido, qué servicios se prestaron, qué diagnósticos se realizaron, qué procedimientos se ejecutaron y qué medicamentos se dispensaron.

Durante más de dos décadas, los RIPS se reportaban en archivos de texto plano (.txt) con estructuras fijas separadas por comas. Este formato, aunque funcional en su momento, generaba múltiples problemas: era propenso a errores de formato, difícil de validar automáticamente, y no permitía la interoperabilidad con otros sistemas de información en salud. Las inconsistencias entre lo facturado y lo reportado en RIPS eran frecuentes y difíciles de detectar hasta que el proceso de auditoría ya estaba en curso.

En 2023, el Ministerio de Salud y Protección Social emitió la Resolución 2275 que transformó radicalmente este proceso. Los RIPS dejaron de ser archivos de texto independientes y se convirtieron en documentos JSON (JavaScript Object Notation) que deben adjuntarse como soporte obligatorio de la Factura Electrónica de Venta (FEV) en el sector salud.

¿Por qué JSON? Este formato es un estándar internacional para el intercambio de datos estructurados. A diferencia del texto plano, JSON tiene una estructura jerárquica que permite validar automáticamente la completitud y coherencia de los datos. Además, es legible tanto por máquinas como por humanos, lo que facilita la depuración de errores. Y fundamentalmente, permite la integración directa con la factura electrónica, creando un ecosistema donde la información clínica y la información fiscal viajan juntas y se validan de forma cruzada.

Para los prestadores de salud en Colombia — médicos independientes, consultorios, clínicas, hospitales e IPS de todos los niveles — este cambio significa que ya no pueden gestionar los RIPS y la facturación como procesos separados. Ambos son ahora parte del mismo flujo documental.

Resolución 2275 de 2023: qué exige y a quién aplica

La Resolución 2275 de 2023, emitida por el Ministerio de Salud y Protección Social, es la norma que establece las condiciones técnicas y operativas para la generación y reporte de los RIPS en formato JSON como soporte de la factura electrónica de venta en el sector salud.

¿A quién aplica? La resolución aplica a todos los prestadores de servicios de salud que están obligados a facturar electrónicamente. Esto incluye IPS de todos los niveles de complejidad, profesionales independientes de la salud habilitados, laboratorios clínicos, centros de imágenes diagnósticas, instituciones que prestan servicios de rehabilitación, y cualquier entidad que preste servicios de salud y facture electrónicamente.

En la práctica, si usted como médico, odontólogo, fisioterapeuta o cualquier profesional de salud emite facturas electrónicas por servicios de salud, está obligado a adjuntar los RIPS en formato JSON a cada factura.

¿Qué exige específicamente? La resolución establece varios requisitos clave. Primero, los RIPS deben generarse en formato JSON siguiendo la estructura definida en el Anexo Técnico de la resolución. Esta estructura incluye datos de identificación del usuario, datos de la consulta, datos de los procedimientos, datos de los medicamentos, datos de hospitalización (cuando aplique) y datos del recién nacido (cuando aplique).

Segundo, cada archivo JSON de RIPS debe estar vinculado a una factura electrónica de venta específica. No se pueden reportar RIPS sin factura ni facturar servicios de salud sin RIPS.

Tercero, la información de los RIPS debe ser consistente con la información de la factura electrónica. Los datos del paciente, los servicios prestados, los valores y las fechas deben coincidir exactamente entre ambos documentos.

La Resolución 1884 de 2024 complementó este marco al establecer el Mecanismo Único de Validación (MUV) como el sistema centralizado para la validación cruzada de la FEV y los RIPS, operado conjuntamente por la DIAN y el Ministerio de Salud.

Cómo funciona el modelo FEV-RIPS paso a paso

El modelo FEV-RIPS es el flujo integrado que conecta la atención clínica con la facturación electrónica y el reporte de información en salud. Entenderlo paso a paso es fundamental para implementarlo correctamente en su práctica o institución.

Paso 1: Atención al paciente y registro clínico. El profesional de salud atiende al paciente y registra toda la información clínica en la historia clínica electrónica: motivo de consulta, anamnesis, examen físico, diagnósticos (codificados en CIE-10), procedimientos realizados (codificados en CUPS), medicamentos formulados, y plan de manejo. La calidad de este registro es crítica porque es la fuente primaria de los RIPS.

Paso 2: Generación automática de los RIPS en JSON. El software médico extrae los datos clínicos relevantes del registro de la atención y los estructura en formato JSON según el esquema definido en la Resolución 2275. El archivo JSON incluye los datos del usuario (tipo y número de documento, nombre, fecha de nacimiento, sexo, zona de residencia), los datos de la consulta (fecha, hora, código CUPS del servicio, finalidad, causa externa, diagnóstico principal y relacionados), los datos de procedimientos si los hubo, y los datos de medicamentos si se dispensaron.

Paso 3: Generación de la factura electrónica (FEV). Simultáneamente o inmediatamente después, el sistema genera la factura electrónica en formato XML. Esta factura contiene los datos fiscales: NIT del prestador, datos del pagador (EPS, aseguradora o paciente particular), detalle de los servicios facturados, valores, copagos, cuotas moderadoras e impuestos aplicables.

Paso 4: Vinculación FEV-RIPS. El sistema vincula el archivo JSON de RIPS con el XML de la factura electrónica. Esta vinculación se realiza mediante identificadores comunes como el número de factura y los datos del paciente.

Paso 5: Envío al Mecanismo Único de Validación (MUV). Ambos documentos se envían al MUV, que realiza la validación cruzada verificando la coherencia entre la información fiscal y la información clínica.

Paso 6: Respuesta de validación. El MUV devuelve una respuesta de aceptación o rechazo. Si es aceptada, la factura queda validada y puede ser radicada ante el pagador. Si es rechazada, el sistema indica los errores específicos que deben corregirse.

El Mecanismo Único de Validación (MUV): qué es y cómo prepararse

El Mecanismo Único de Validación, conocido como MUV, es el sistema centralizado que la DIAN y el Ministerio de Salud implementaron para validar de forma cruzada las facturas electrónicas de venta y los RIPS en el sector salud. Fue establecido formalmente por la Resolución 1884 de 2024 y representa un cambio significativo en cómo se controla la facturación en salud en Colombia.

¿Qué valida el MUV? El MUV realiza múltiples validaciones simultáneas. Verifica que la estructura del XML de la factura cumpla con el Anexo Técnico de la DIAN. Comprueba que la estructura del JSON de RIPS cumpla con el esquema de la Resolución 2275. Cruza los datos entre ambos documentos para detectar inconsistencias: que los valores coincidan, que los servicios facturados correspondan a los reportados en RIPS, que los datos del paciente sean idénticos en ambos documentos, y que las fechas de prestación sean coherentes.

¿Cómo preparar su práctica para el MUV? Hay varias acciones concretas que puede tomar. Primero, asegúrese de que su software médico genere tanto la FEV como los RIPS desde una misma base de datos. La causa número uno de rechazos en el MUV es la inconsistencia de datos, y esta inconsistencia surge cuando los documentos se generan desde fuentes diferentes o con intervención manual.

Segundo, mantenga actualizados sus catálogos de codificación. Los códigos CUPS, CIE-10 y los catálogos de medicamentos deben corresponder a las versiones vigentes. Un código desactualizado generará un rechazo automático.

Tercero, establezca un proceso de revisión antes del envío. Aunque su software automatice la generación, es recomendable que alguien del equipo administrativo revise una muestra de facturas periódicamente para detectar patrones de error antes de que se acumulen.

Cuarto, tenga un protocolo para gestionar rechazos. Cuando el MUV rechace una factura, necesita poder identificar rápidamente el error, corregirlo y reenviar. Su software debe facilitar este proceso mostrando claramente los motivos del rechazo y permitiendo la corrección sin necesidad de rehacer todo el documento desde cero.

Quinto, monitoree los tiempos de respuesta. El envío al MUV debe ser ágil. Si su sistema tiene demoras sistemáticas, puede generar problemas de trazabilidad y afectar el flujo de caja de su IPS al retrasar la radicación de facturas.

Sanciones por incumplimiento y cómo evitarlas

El incumplimiento en la generación correcta de RIPS y facturación electrónica puede acarrear consecuencias serias para cualquier prestador de salud en Colombia. Las sanciones provienen de dos frentes: la DIAN por el componente fiscal y el Ministerio de Salud por el componente de información en salud.

Desde el frente de la DIAN, las sanciones por no facturar electrónicamente o hacerlo de forma incorrecta incluyen multas que pueden ir del 1% al 5% de las operaciones facturadas durante el periodo de incumplimiento, cierre temporal del establecimiento por 3 días en la primera vez y hasta 30 días en reincidencia, y la posibilidad de ser incluido en procesos de fiscalización prioritaria. Para una IPS que facture $100 millones mensuales, una multa del 1% equivale a $1 millón por mes de incumplimiento.

Desde el frente del Ministerio de Salud, el no reporte o reporte incorrecto de RIPS puede resultar en requerimientos y procesos administrativos sancionatorios a través de la Superintendencia Nacional de Salud. Además, las EPS y entidades responsables de pago pueden objetar y devolver facturas que no vengan acompañadas de RIPS correctamente estructurados, lo que afecta directamente el flujo de caja de la IPS.

Pero más allá de las multas formales, hay un costo operativo que muchos prestadores subestiman: las glosas. Cada vez que una factura es rechazada por inconsistencias entre la FEV y los RIPS, su equipo administrativo debe invertir tiempo en identificar el error, corregirlo y reenviar. A escala, esto puede representar horas de trabajo perdidas cada semana.

¿Cómo evitar estas sanciones? La respuesta es sencilla en concepto pero requiere disciplina en la ejecución. Use un software médico que genere automáticamente los RIPS desde la historia clínica y los vincule a la factura electrónica. Mantenga sus catálogos actualizados. Revise periódicamente sus tasas de rechazo y corrija los patrones de error. Conserve toda la documentación electrónica por el periodo exigido. Y capacite a su equipo clínico para que entienda que la calidad del registro en la historia clínica impacta directamente la facturación.

Cómo generar RIPS JSON automáticamente desde su software médico

La generación manual de RIPS en formato JSON es técnicamente compleja y operativamente inviable para la mayoría de consultorios y clínicas. Cada archivo JSON debe seguir una estructura específica con campos obligatorios, codificaciones estandarizadas y validaciones cruzadas con la factura electrónica. Hacerlo manualmente para cada atención sería como escribir código de programación después de cada consulta médica.

La solución práctica es contar con un software médico que automatice completamente este proceso. Así es como debería funcionar en una implementación ideal:

El médico atiende al paciente y registra la consulta normalmente en la historia clínica electrónica. Durante este registro, selecciona los diagnósticos de una lista codificada CIE-10, los procedimientos de una lista codificada CUPS, y registra los medicamentos formulados. El software toma toda esta información clínica y la transforma automáticamente en el archivo JSON de RIPS, respetando la estructura del Anexo Técnico de la Resolución 2275.

Al momento de facturar, el sistema genera la factura electrónica en XML y adjunta automáticamente el JSON de RIPS como soporte. Luego envía ambos documentos al MUV para validación. Todo este proceso debería ocurrir sin que el médico ni el personal administrativo tengan que intervenir en la generación del JSON — su único trabajo es registrar correctamente la información clínica.

¿Qué debe buscar en un software médico para que esto funcione? Busque que tenga historia clínica electrónica con codificación CIE-10 y CUPS integrada, generación automática de RIPS JSON desde el registro clínico, módulo de facturación electrónica con validación DIAN, integración nativa FEV-RIPS sin necesidad de herramientas externas, conexión directa al MUV, y gestión de rechazos con indicación clara de errores.

Nevatal ofrece exactamente esta integración. Desde la historia clínica hasta la factura electrónica y los RIPS, todo fluye de forma automática en una sola plataforma. Sin archivos separados, sin procesos manuales, sin riesgo de inconsistencias. Si su consultorio o IPS necesita simplificar el cumplimiento de la Resolución 2275, Nevatal puede ser la solución que estaba buscando.