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 948 de 2026, 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 948 de 2026, 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.
Sin el CUV, tu factura no está respaldada y puedes enfrentar glosas o rechazos de pago por parte de las EPS.
Qué norma rige hoy: la Resolución 948 de 2026
El RIPS en JSON como soporte de la factura electrónica nació con la Resolución 2275 de 2023, que tuvo su propio calendario de implementación por grupos. Esa resolución ya no está vigente: la Resolución 948 del 14 de mayo de 2026 la derogó junto con la 558 y la 1884 de 2024, y hoy es la norma que reglamenta el RIPS como soporte de la FEV en salud.
- Desde el 1 de junio de 2026 rigen las reglas de validación que pasaron de notificación a rechazo: lo que antes solo generaba una advertencia ahora impide obtener el CUV.
- Desde el 1 de julio de 2026 son exigibles los ajustes estructurales de versión de software.
- Para radicar tienes 22 días hábiles desde la expedición de la factura con validación previa de la DIAN. Si no radicas en ese plazo, debes anular la factura y expedir una nueva.
- Código Único de Contrato (CUCON): la factura debe llevar el código que genera el SIIFA para el contrato con el pagador, conforme al cronograma de implementación del SIIFA, salvo las excepciones de factura sin contrato.
Si todavía generas archivos planos (.txt) del modelo anterior, ese formato ya no sirve para soportar la factura electrónica de venta en salud.
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:
- Transacción (siempre): NIT del prestador, número de factura y datos generales de la factura.
- Usuarios (siempre): documento, fecha de nacimiento, sexo y municipio de residencia del paciente.
- Consultas (si hubo consulta): código CUPS, finalidad, causa y diagnósticos.
- Procedimientos (si se realizó alguno): código CUPS, vía de ingreso, finalidad y diagnósticos.
- Urgencias (si fue una urgencia): causa, diagnósticos y condición al egreso.
- Hospitalización (si la hubo): fechas de ingreso y egreso, vía de ingreso y causa del egreso.
- Recién nacidos (si hubo nacimiento): datos del neonato.
- Medicamentos y otros servicios (si se suministraron): códigos y cantidades.
Los diagnósticos se reportan con la CIE-10; la Resolución 1442 de 2024 adoptó la CIE-11 con un periodo de transición de codificación dual. El detalle de cada campo está en nuestra guía RIPS de cero del centro de ayuda.
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.
Preguntas frecuentes
¿Qué es el FEV-RIPS?
Es el conjunto de la factura electrónica de venta en salud (FEV), en XML y validada por la DIAN, y del RIPS en JSON que la soporta. Los dos se envían juntos al mecanismo único de validación del Ministerio de Salud, que entrega el CUV si están correctos.
¿Qué resolución regula hoy los RIPS en JSON?
La Resolución 948 del 14 de mayo de 2026, que derogó las resoluciones 2275 de 2023, 558 de 2024 y 1884 de 2024. Sus reglas de rechazo rigen desde el 1 de junio de 2026 y los ajustes estructurales desde el 1 de julio de 2026.
¿Qué es el CUV?
El Código Único de Validación: lo entrega el mecanismo único de validación del Ministerio cuando la factura y su RIPS pasan las reglas. Sin CUV la factura no se puede radicar ante el pagador.
¿Cuánto tiempo tengo para radicar la factura?
Veintidós días hábiles desde la expedición de la factura electrónica con validación previa de la DIAN. Si no la radicas en ese plazo, debes anularla y expedir una nueva.
¿Puedo hacer el JSON a mano?
Técnicamente sí, pero cualquier error de estructura o de correspondencia con la factura hace que el validador lo rechace. Lo práctico es que tu software genere el JSON desde la misma atención y lo envíe a validar.
Checklist de la Resolución 948, gratis
Repasa punto por punto lo que exige la Res. 948 de 2026 en tus RIPS y tu factura electrónica, antes de que te lo devuelvan. Déjanos tus datos y pasas directo a la descarga.