Errores frecuentes al validar RIPS en el MUV

Actualizado el

El validador del Ministerio no explica los errores: los devuelve en un JSON con códigos. Esta guía te enseña a leer ese reporte, qué significa cada familia de códigos y cuáles son los errores que más frenan cobros — con las causas documentadas por el propio Ministerio.

Qué es lo que valida el MUV

El Mecanismo Único de Validación (MUV) revisa dos archivos a la vez: el JSON del RIPS y el XML de la factura electrónica ya validada por la DIAN. Si todo pasa, devuelve el CUV; si algo falla en una regla de rechazo, no hay CUV y la factura no se puede radicar.

Conviene tener claro el orden: primero la DIAN valida la factura, después el Ministerio valida el RIPS. → El proceso completo está en cómo generar los RIPS paso a paso.

Cómo leer el reporte de validación

El resultado llega como un JSON. Simplificado, se ve así:

{
  "ResultState": true,
  "ProcesoId": 11,
  "NumFactura": "FE1234",
  "CodigoUnicoValidacion": "8d3992db…5896cd",
  "ResultadosValidacion": [
    {
      "Clase": "NOTIFICACION",
      "Codigo": "RVC019",
      "Descripcion": "El código de CUPS se puede validar con el diagnóstico principal.",
      "Observaciones": "Verificar tabla de referencia Dato (890201)",
      "PathFuente": "usuarios[1].servicios.consultas[0].codConsulta",
      "Fuente": "Rips"
    }
  ]
}

Los cinco campos que importan:

Campo Qué te dice
ResultState true = procesamiento correcto. false = hubo una validación de tipo rechazo
Clase RECHAZADO o NOTIFICACION. Es lo primero que hay que mirar
Codigo El código de la regla que falló (ver familias abajo)
PathFuente La ruta exacta del dato que falló dentro del archivo
Fuente RIPS, FacturaElectrónica, NotaCredito o NotaDebito

El PathFuente es el campo más subestimado del reporte. usuarios[1].servicios.consultas[0].codConsulta significa: segundo usuario del arreglo, primera consulta, campo del CUPS. No hay que adivinar dónde está el error: viene señalado.

Las familias de códigos: dónde está el problema

Prefijo Qué significa Dónde buscar
RVG Regla de Validación General En el JSON del RIPS, a nivel de archivo o de sumatorias
RVC Regla de Validación de Campo En un campo concreto (el PathFuente lo señala)
FED, CIN, CND, DND y afines Validaciones sobre el XML de la factura En tu software de facturación, no en la historia clínica

Esa última fila es la que más tiempo ahorra. Si el código empieza por FED o CIN, el problema casi nunca está en tus RIPS: está en que el XML de la factura no trae lo que el sector salud exige. Ejemplos reales de mensajes: CIN001 ("La fecha de la factura no corresponde al periodo reportado") o FED078 (un apartado que "no existe o no tiene valor en el Xml de la Factura Electrónica").

En la versión 003 del Documento Técnico 1 (15 de julio de 2026) hay 18 reglas RVG —16 de rechazo y 2 de notificación— y cerca de un centenar de reglas RVC, repartidas entre rechazo y notificación. La única fuente confiable del estado actual de una regla es la columna de efecto (R o N) de la versión vigente de ese documento.

Rechazo y notificación no son lo mismo (y ahí está la trampa)

El propio documento técnico define la diferencia: R es rechazo, "el procesamiento […] ha encontrado problemas que impiden el procesamiento de la solicitud"; N es notificación, "ha encontrado indicios de potenciales problemas, los cuales no impiden el procesamiento".

Y luego avisa lo que va a pasar con las notificaciones:

"RIPS con notificación: este resultado indica una no conformidad con las reglas de validación, pero que con el fin de no afectar el flujo de recursos transitoriamente no impedirá la radicación de la factura, pero el generador de la información deberá realizar un plan de mejora, ya que periódicamente se convertirán en reglas de rechazo."

Traducción: tu paquete puede salir aprobado, con CUV, y con cuarenta notificaciones dentro. Hoy no pasa nada. El 1 de junio de 2026 se ejecutó una tanda de conversiones de notificación a rechazo, y quien nunca había leído las notificaciones de sus paquetes aprobados fue exactamente quien se quedó sin cobrar ese día.

La rutina que evita el susto: revisar el ResultadosValidacion incluso cuando el paquete fue aprobado.

Los errores más frecuentes (documentados por el Ministerio)

Estos vienen de la base de conocimiento de la mesa de ayuda oficial de FEV-RIPS y de los documentos técnicos, no de anécdotas.

1. El código de prestador con la longitud equivocada. Es el clásico absoluto. En el XML de la factura el dato va de 10 posiciones; en el archivo RIPS va de 12. Se manifiesta como un error que dice que el código del prestador no está registrado o es diferente al de la FEV.

2. Decimales en los valores. El RIPS no acepta valores con decimales: hay que redondear. Y hay reglas que comparan la sumatoria del JSON contra el total del XML, así que un centavo de diferencia por redondeo rompe el paquete. La recomendación oficial es generar también la factura sin decimales, aproximando al peso.

3. El XML no trae la extensión de sector salud. Si tu proveedor de facturación electrónica no genera el XML con los campos adicionales del sector salud, el RIPS se rechaza por más bien armado que esté. La respuesta oficial del Ministerio a este caso es directa: hay que ajustar el software de facturación o cambiar de proveedor.

4. Pacientes sin identificación válida. No se admiten pacientes anónimos ni documentos "de relleno". Y desde julio de 2026 existe una regla de rechazo de integridad de códigos: solo se aceptan códigos que existan en las tablas de referencia (CUPS, CUM, IUM).

5. El profesional no está en RETHUS, o el prestador no está habilitado en REPS. El MUV no valida solo el archivo: cruza los datos contra bases externas como BDUA, RETHUS, MIPRES, RUAF-ND y REPS. Un RIPS impecable se rechaza si el profesional que firmó no aparece en RETHUS o si el servicio no está habilitado en el REPS. → Ver cómo inscribirse en el REPS.

6. Códigos que existen pero no encajan. El validador cruza el diagnóstico contra el sexo y el rango de edad del paciente, y contra el CUPS informado. Un codDiagnosticoPrincipal con la longitud equivocada también es rechazo: son 4 caracteres exactos, sin punto. → Ver CIE-10 y CIE-11 en los RIPS.

7. Notas crédito enviadas con RIPS cuando no corresponde. Las notas crédito que anulan totalmente la factura referenciada no deben llevar RIPS. Las parciales, sí.

8. La red bloquea el validador. Si el paquete nunca llega, antes de revisar el archivo conviene descartar que el firewall esté bloqueando el host y el puerto del validador. Es una causa documentada y no da un error de contenido: da silencio.

Cómo corregir y reenviar

La regla general está en la mesa de ayuda oficial: si el mecanismo genera rechazos, se hacen las correcciones en el XML o en el archivo RIPS y se vuelve a validar. No hay un tope documentado de reintentos.

Pero hay un candado que sorprende a mucha gente: una vez el paquete fue aprobado, ese número de factura queda usado. Si lo reenvías, el sistema lo rechaza por duplicado. Para corregir después de tener CUV no se reenvía: se va por nota crédito, nota débito o nota de ajuste del RIPS.

Situación Qué hacer
Rechazo Corregir y volver a validar el mismo número de factura
Aprobado, con notificaciones Radicar, y corregir el origen para los siguientes paquetes
Aprobado, pero mal Nota crédito, nota débito o nota de ajuste
"Rechazo por factura ya existente" Leer el mensaje completo antes de refacturar

Ese último caso merece su propio párrafo. Los lineamientos oficiales describen el escenario en que la transmisión fue correcta pero la respuesta con el CUV no llegó: al reenviar, el sistema responde con rechazo porque la factura ya figura en la base de datos, "pero se ha incluido en el mensaje el CUV, el cual debe ser aceptado como prueba alterna de validación exitosa por los pagadores". Existe además un método específico para recuperar un CUV ya generado. Antes de anular y refacturar por un "duplicado", busca el CUV dentro del mensaje.

Lo que el pagador no puede exigirte

Vale saberlo porque pasa: el artículo 7 de la Resolución 948 de 2026 prohíbe a las entidades responsables de pago "usar, ni adicionar otras reglas o establecer mecanismos alternos de validación, como condición para radicar las facturas". Si una EPS te devuelve una radicación por una regla que no está en el documento técnico del Ministerio, esa norma es tu respaldo.

Y al revés: obtener el CUV no significa que te van a pagar. El propio documento técnico aclara que el CUV "habilita la radicación de la factura y los demás soportes para que inicie la etapa de auditoría a cargo del pagador". El CUV es el permiso para entrar, no el cheque.

Checklist antes de enviar

  1. El código de prestador va con 12 posiciones en el RIPS y 10 en el XML.
  2. Ningún valor tiene decimales, y la suma del JSON cuadra con el total de la factura.
  3. Los CIE-10 tienen exactamente 4 caracteres y existen en la tabla del SISPRO.
  4. Los CUPS existen en la tabla CUPSRips y corresponden al servicio prestado.
  5. El paciente tiene documento real y los datos completos.
  6. Tu habilitación está activa en el REPS y el profesional está en RETHUS.
  7. Después de enviar: leer las notificaciones, incluso si salió aprobado.

Cómo evitar la mayoría de estos errores de raíz

Casi todos estos errores nacen en el mismo sitio: datos que se escriben dos veces, en dos sistemas que no se hablan. Cuando la historia clínica es la que arma el RIPS con lo que ya documentaste, valida contra las tablas de referencia antes de enviar y guarda el CUV junto a la factura, el reporte de validación deja de ser una lotería. Alira genera tus RIPS a partir de la consulta y, al firmarla, envía tu RDA al IHCE.

→ Empieza gratis 30 días en aliramed.com


Aviso

Esta guía es informativa y no constituye asesoría legal. Las reglas de validación cambian de versión: consulta siempre la vigente. Fuentes oficiales:

Test gratis · 1 minuto

¿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óstico

Preguntas frecuentes

¿Por qué el MUV rechaza mis RIPS?
Las causas más frecuentes y documentadas por el Ministerio son: el código de prestador con longitud equivocada (10 posiciones en el XML de la factura y 12 en el archivo RIPS), valores con decimales o sumatorias que no cuadran con el total de la factura, un XML de factura sin la extensión de sector salud, pacientes sin identificación válida, códigos CIE-10 o CUPS inexistentes o con longitud errada, y el cruce contra bases externas: profesional que no aparece en RETHUS o servicio no habilitado en el REPS.
¿Qué significan los códigos RVG, RVC y FED?
RVG son las Reglas de Validación General y RVC las Reglas de Validación de Campo: ambas apuntan al archivo JSON del RIPS. Los prefijos FED, CIN, CND y DND corresponden a validaciones sobre el XML de la factura electrónica, es decir, el problema está en tu software de facturación y no en la historia clínica. El campo PathFuente del reporte señala la ruta exacta del dato que falló.
¿Cuál es la diferencia entre rechazo y notificación?
El rechazo impide el procesamiento: no se genera el CUV y la factura no se puede radicar. La notificación advierte una no conformidad que transitoriamente no impide radicar. El documento técnico del Ministerio avisa que las notificaciones "periódicamente se convertirán en reglas de rechazo": un paquete puede salir aprobado con decenas de notificaciones dentro, y esas son rechazos agendados. Conviene leerlas incluso cuando el resultado fue aprobado.
¿Puedo corregir y reenviar un RIPS rechazado?
Sí, y no hay un tope documentado de reintentos: se corrige el XML o el JSON y se vuelve a validar. Lo que no se puede es reenviar un número de factura ya aprobado, porque queda registrado y el sistema lo rechaza por duplicado. Para corregir después de haber obtenido el CUV hay que ir por nota crédito, nota débito o nota de ajuste del RIPS.
Me dice que la factura ya existe. ¿Debo anularla?
Antes de anular, lee el mensaje completo. Los lineamientos oficiales describen el caso en que la transmisión fue correcta pero la respuesta con el CUV no llegó: al reenviar, el sistema responde rechazo porque la factura ya figura en la base de datos, pero incluye el CUV en el mensaje, y ese CUV debe ser aceptado por los pagadores como prueba alterna de validación exitosa. Existe además un método específico para recuperar un CUV ya generado.
¿Tener el CUV significa que me van a pagar?
No. El documento técnico del Ministerio aclara que obtener el CUV habilita la radicación de la factura y los soportes para que inicie la etapa de auditoría a cargo del pagador. El CUV es el permiso para entrar al proceso, no la aprobación del cobro: las glosas y devoluciones siguen su propio manual.

Guías relacionadas

Alira envía tu RDA al IHCE y genera tus RIPS al firmar cada consulta.

Empezar gratis 30 días

Conoce el software de historia clínica de Alira