RIPS JSON y Facturación Electrónica en Salud: Guía Completa para Colombia
Si eres médico o administrativo de una IPS en Colombia, lo más probable es que hayas escuchado hablar del cambio en los RIPS. Pero ¿qué implica exactamente la transición al formato JSON? ¿Cómo se conecta con la facturación electrónica? Y lo más importante: ¿qué pasa si no cumples? Aquí te lo explicamos sin tecnicismos.
¿Qué son los RIPS y por qué cambiaron de formato?
Los Registros Individuales de Prestación de Servicios de Salud (RIPS) son el reporte que cada prestador de salud en Colombia debe enviar al sistema de información del Ministerio de Salud cada vez que atiende a un paciente. En ellos se registra qué servicio se prestó, a quién, cuándo y bajo qué diagnóstico.
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 no es solo técnico: los RIPS en JSON se convierten ahora en el soporte obligatorio de la Factura Electrónica de Venta (FEV) en el sector salud. Es decir, no puedes emitir tu factura electrónica médica sin tener el RIPS JSON correspondiente correctamente validado.
El nuevo sistema FEV-RIPS: cómo funciona paso a paso
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). Este es el flujo que debes seguir hoy:
- Registra la atención en tu sistema de historia clínica electrónica con todos los datos del paciente, diagnóstico (CIE-10), procedimientos (CUPS) y medicamentos.
- Genera el RIPS en formato JSON a partir de los datos de esa atención. Tu software médico debe hacer esto automáticamente.
- Emite la Factura Electrónica de Venta (FEV) en formato XML con extensión del sector salud.
- Transmite ambos documentos juntos (RIPS JSON + FEV XML) a las plataformas de validación del Ministerio de Salud a través del MUV.
- Recibe el CUV (Código Único de Validación): un código alfanumérico encriptado que certifica que tu RIPS fue aprobado y corresponde correctamente a la factura emitida.
El sistema opera las 24 horas del día, los 7 días de la semana, lo que permite una validación casi inmediata. Sin el CUV, tu factura no está respaldada y puedes enfrentar glosas o rechazos de pago por parte de las EPS.
Cronograma de implementación obligatoria
La transición se hizo por fases para darles tiempo a los prestadores de adaptarse. Este fue el cronograma establecido por el Ministerio de Salud:
| Fase | Fecha de inicio | ¿Quiénes aplican? |
|---|---|---|
| Fase 1 | 1 de febrero de 2025 | IPS de alta y mediana complejidad (Grupo 1 y 2) |
| Fase 2 | 1 de abril de 2025 | Prestadores de baja complejidad, profesionales independientes y proveedores de tecnología en salud (Grupo 3) |
| Implementación total | 1 de junio de 2025 | Todo el sector salud sin excepciones |
| Cierre modelo anterior | 31 de diciembre de 2025 | Última fecha para facturar bajo el modelo antiguo |
| Auditoría EPS | Hasta diciembre de 2026 | Las EPS tienen hasta esta fecha para auditar servicios facturados bajo el modelo anterior |
Si eres un profesional independiente o tienes una IPS pequeña, desde el 1 de abril de 2025 ya estás en la obligación plena. No hay más período de gracia para el modelo de archivos .txt.
Los errores más comunes en RIPS JSON (y cómo evitarlos)
El cambio de formato trajo consigo una nueva curva de aprendizaje. Estos son los errores que más frecuentemente generan rechazos en el MUV y retrasos en el cobro:
1. JSON mal estructurado
El archivo no comienza con un token JSON válido o tiene un error de sintaxis (una coma de más, una llave sin cerrar, un campo con valor nulo donde se espera texto). El validador lo rechaza de inmediato. La solución: usar siempre un software que genere el JSON automáticamente y no editarlo manualmente.
2. NIT incorrecto o con dígito de verificación erróneo
El NIT reportado en el RIPS no coincide con el NIT con el que te autenticaste en la plataforma. Este error es más común de lo que parece, especialmente cuando hay confusión entre si se debe incluir o no el dígito de verificación. Verifica siempre con tu contador o con el RUT actualizado.
3. Códigos CUPS o CIE-10 inválidos o no vigentes
Usar un código de procedimiento (CUPS) o de diagnóstico (CIE-10) que está desactualizado o que no corresponde al servicio efectivamente prestado genera inconsistencias que derivan en glosas. Mantén tu tabla de códigos siempre actualizada.
4. Campos obligatorios vacíos
Hay campos que el nuevo estándar JSON exige como obligatorios pero que en el modelo antiguo de .txt eran opcionales. Ejemplos: tipo de documento del paciente, fecha de nacimiento, código del prestador. Un campo vacío donde no debe estarlo causa rechazo automático.
5. Inconsistencias entre el RIPS y la FEV
Los datos del paciente, el NIT del prestador, los valores y los servicios facturados en la FEV deben coincidir exactamente con lo reportado en el RIPS JSON. Cualquier discrepancia entre los dos documentos genera rechazo del MUV.
Estructura del RIPS JSON: ¿qué datos incluye?
Para quienes quieren entender qué información debe contener el RIPS en el nuevo formato, aquí hay un resumen de los conjuntos de datos que lo componen:
| Conjunto de datos | ¿Qué registra? | ¿Es siempre obligatorio? |
|---|---|---|
| Transacción | NIT del prestador, fecha, número de factura, entidad pagadora | Sí |
| Usuarios | Datos del paciente: documento, nombre, fecha de nacimiento, municipio | Sí |
| Consultas | Diagnóstico CIE-10, tipo de consulta, causa de atención | Si hubo consulta |
| Urgencias | Causa de atención urgente, diagnóstico, condición al egreso | Si fue urgencia |
| Procedimientos | Código CUPS, ámbito, finalidad, personal que lo realizó | Si se realizó procedimiento |
| Hospitalizaciones | Fecha de ingreso/egreso, vía de ingreso, causa de egreso | Si hubo hospitalización |
| Recién nacidos | Datos del neonato y de la madre | Si hay nacimiento |
Cada conjunto de datos tiene sus propias reglas de validación. Lo importante es que tu software médico sepa exactamente cuándo incluir cada bloque y con qué campos, de acuerdo al tipo de atención que prestaste.
¿Qué pasa si no cumples con los RIPS JSON?
Esta es probablemente la pregunta que más le preocupa a los médicos y administradores de IPS: ¿qué consecuencias tiene no cumplir?
Las consecuencias más directas son económicas. Si tu RIPS no es válido o no obtienes el CUV, la EPS o entidad pagadora puede:
- Objetar (glosar) tu factura por falta de soporte técnico válido, lo que retrasa o impide el pago.
- Rechazar completamente la cuenta de cobro por incumplimiento del requisito FEV-RIPS.
- Generar reportes ante la Superintendencia de Salud por incumplimiento de obligaciones de información.
Además, sin RIPS correctos no puedes contribuir a las estadísticas del sistema de salud, lo que puede afectar indicadores de habilitación y contratos futuros con entidades.
La buena noticia es que si tu software médico genera los RIPS automáticamente a partir de la historia clínica electrónica, el riesgo de error humano se reduce drásticamente. El sistema hace el trabajo por ti.
Cómo preparar tu consultorio o IPS para el cumplimiento
Si todavía no has completado la transición al sistema FEV-RIPS, estos son los pasos concretos que debes seguir:
- Verifica que tu software médico genere RIPS en formato JSON de manera automática y que esté certificado para transmitir al MUV. Pregúntale directamente a tu proveedor si ya tienes esta funcionalidad activa.
- Actualiza tu tabla de códigos CUPS y CIE-10 a las versiones vigentes. Un código desactualizado puede invalidar todo el RIPS.
- Revisa que tu RUT esté al día y que el NIT configurado en tu sistema coincida exactamente con el registrado en la DIAN y el Ministerio de Salud.
- Capacita a tu equipo administrativo en el nuevo flujo de generación y transmisión. El proceso es diferente al antiguo y requiere que quienes gestionan la facturación entiendan la validación del MUV.
- Haz pruebas antes de facturar en producción. Usa el ambiente de pruebas del Ministerio para validar que tus RIPS JSON pasan sin errores antes de enviarlos con facturas reales.
- Guarda todos los CUV que recibas. Son el comprobante de que tu RIPS fue validado y el respaldo ante cualquier disputa de pago.