Cómo generar los RIPS paso a paso (2026)
Actualizado el
Generar los RIPS suena técnico, pero el proceso tiene una lógica clara. Aquí lo tienes paso a paso, con la estructura real del archivo y los plazos de la norma vigente, para que entiendas qué pasa detrás y por qué conviene que tu software lo haga por ti.
Antes de empezar: lo que necesitas tener
- Estar inscrito y habilitado en el REPS como prestador. El validador del Ministerio comprueba tu habilitación contra el REPS: si el servicio no está habilitado, el archivo se rechaza aunque esté perfecto. → Ver cómo inscribirse en el REPS.
- Estar habilitado como facturador electrónico ante la DIAN. → Ver facturación electrónica para profesionales de la salud.
- Estar registrado en Mi Seguridad Social: para un profesional independiente, ese usuario y esa clave son las credenciales con las que entra al mecanismo de validación.
- Una historia clínica electrónica que produzca RIPS en el formato vigente.
La norma vigente, en una línea
La Resolución 948 de 2026 (14 de mayo de 2026) reglamentó el RIPS como soporte de la Factura Electrónica de Venta en salud y derogó las Resoluciones 2275 de 2023, 558 y 1884 de 2024. El detalle técnico ya no viaja como "anexo" de la resolución: vive en el Documento Técnico 1 ("Especificaciones técnicas de los campos de datos y las reglas de validación del RIPS como soporte de la FEV en salud"), que se publica con número de versión en el micrositio de facturación electrónica del SISPRO. Al escribir esta guía la vigente es la versión 003, del 15 de julio de 2026.
Consecuencia práctica: el formato puede cambiar sin que salga una resolución nueva. Vale la pena mirar la versión del documento técnico una vez al año.
El proceso, paso a paso
1. Documenta la atención. Todo parte de la consulta: registras el paciente, el diagnóstico (código CIE-10), los procedimientos (códigos CUPS cuando aplican) y los datos del servicio. Los RIPS se arman con esta información, así que si documentas bien, los RIPS salen bien.
2. Genera la factura electrónica de venta (FEV). En salud, la factura y los RIPS van de la mano (modelo FEV-RIPS). La factura se emite con validación previa de la DIAN, y el orden importa: según el artículo 7 de la Res. 948 de 2026, "una vez surtido el proceso de validación previa de la […] DIAN a la factura […] se deberá realizar la validación única del Registro Individual de Prestación de Servicios de Salud (RIPS)". Primero la DIAN, después el Ministerio.
3. Construye el archivo RIPS en JSON. Con los datos de la atención se arma el documento RIPS en formato JSON, siguiendo la estructura del Documento Técnico 1.
4. Valida en el MUV. Envías el paquete (JSON del RIPS + XML de la factura) al Mecanismo Único de Validación (MUV). Ahí se revisan las reglas: que los códigos existan en las tablas de referencia, que los datos sean coherentes, que todo cuadre con la factura.
5. Recibe el CUV. Si la validación pasa, obtienes el CUV (Código Único de Validación): una cadena de 96 caracteres hexadecimales que certifica que tus RIPS quedaron aprobados y habilitan la radicación de la factura. → Ver qué es el CUV y para qué sirve.
Cómo es el archivo por dentro
El JSON tiene un objeto raíz con los datos de la transacción y de la factura, un arreglo de usuarios (los pacientes atendidos en esa factura) y, dentro de cada usuario, un objeto servicios con los arreglos de lo que le prestaste:
| Bloque | Qué contiene |
|---|---|
| Raíz | numDocumentoIdObligado, numFactura, tipoNota, numNota |
usuarios |
Un elemento por paciente facturado |
servicios.consultas |
Consultas |
servicios.procedimientos |
Procedimientos |
servicios.urgencias |
Atención de urgencias |
servicios.hospitalizacion |
Internación |
servicios.recienNacidos |
Datos del recién nacido |
servicios.medicamentos |
Medicamentos |
servicios.otrosServicios |
Otros servicios y tecnologías |
Para una consulta externa típica solo se usan usuarios y servicios.consultas.
Campos de cada usuario: tipoDocumentoIdentificacion, numDocumentoIdentificacion, tipoUsuario, fechaNacimiento, codSexo, codPaisResidencia, codMunicipioResidencia, codZonaTerritorialResidencia, incapacidad, consecutivo, codPaisOrigen y registroSIRAS.
Campos de cada consulta: codPrestador, fechaInicioAtencion, numAutorizacion, codConsulta (el CUPS), modalidadGrupoServicioTecSal, grupoServicios, codServicio, finalidadTecnologiaSalud, causaMotivoAtencion, codDiagnosticoPrincipal, codDiagnosticoRelacionado1 a 3, tipoDiagnosticoPrincipal, el documento del profesional que atendió, vrServicio, conceptoRecaudo, valorPagoModerador, numFEVPagoModerador, consecutivo y codigoVIDA. Desde la versión estructural exigible el 1 de julio de 2026 existen además los campos paralelos de CIE-11 (codDiagnosticoPrincipalCIE11 y su nombre, y los equivalentes para los diagnósticos relacionados), que durante la transición se envían vacíos. → Ver CIE-10 y CIE-11 en los RIPS.
Así se ve, simplificado, una consulta de primera vez por medicina general con diagnóstico de hipertensión esencial:
{
"numDocumentoIdObligado": "900123456",
"numFactura": "FE1234",
"usuarios": [
{
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "1020304050",
"tipoUsuario": "01",
"fechaNacimiento": "1975-03-14",
"codSexo": "F",
"consecutivo": 1,
"servicios": {
"consultas": [
{
"codPrestador": "110010123401",
"fechaInicioAtencion": "2026-09-15 09:30",
"codConsulta": "890201",
"codDiagnosticoPrincipal": "I10X",
"codDiagnosticoPrincipalCIE11": "",
"vrServicio": 80000,
"consecutivo": 1
}
]
}
}
]
}
(Es un ejemplo ilustrativo y recortado: el archivo real exige todos los campos del documento técnico.)
Los dos códigos que más se equivocan
CIE-10, el diagnóstico. En el RIPS se escribe sin punto y con exactamente 4 caracteres. La CIE-10 de la OMS escribe I10, E11.9, M54.5; en el RIPS eso se escribe I10X, E119, M545. Las categorías de tres caracteres se completan con X. Informar más o menos de cuatro posiciones es causa de rechazo.
| Código | Descripción en la tabla del SISPRO |
|---|---|
I10X |
Hipertensión esencial (primaria) |
E119 |
Diabetes mellitus no insulinodependiente, sin mención de complicación |
N390 |
Infección de vías urinarias, sitio no especificado |
M545 |
Lumbago no especificado |
J039 |
Amigdalitis aguda, no especificada |
Z000 |
Examen médico general |
(Descripciones normalizadas a minúsculas; la tabla oficial las publica en mayúsculas y sin tildes.)
CUPS, el procedimiento o la consulta. Seis dígitos, de la tabla de referencia CUPSRips:
| Código | Descripción |
|---|---|
890201 |
Consulta de primera vez por medicina general |
890202 |
Consulta de primera vez por otras especialidades médicas |
890301 |
Consulta de control o de seguimiento por medicina general |
890302 |
Consulta de control o de seguimiento por otras especialidades médicas |
890101 |
Atención (visita) domiciliaria, por medicina general |
Las dos tablas de referencia son públicas y se consultan en el portal del SISPRO. El validador no solo comprueba que el código exista: también cruza el diagnóstico contra el sexo y el rango de edad del paciente y contra el CUPS informado.
Cómo se valida: el MUV no es una página web
Esto sorprende a casi todo el mundo. Según el artículo 17 de la Res. 948 de 2026, el Ministerio dispone de dos soluciones que el facturador instala en su propia infraestructura:
- Tipo A: una solución cliente/servidor, pensada para quienes no pueden hacer desarrollos propios.
- Tipo B: una API RESTful empaquetada en contenedores, para quien integra desde su software.
El artículo 18 añade que el registro o actualización de datos en el SISPRO es prerrequisito para usar el mecanismo, y que "los profesionales independientes deberán seguir los lineamientos establecidos en la guía de autenticación del mecanismo único de validación". En la práctica: el independiente se autentica con su usuario de Mi Seguridad Social y debe estar habilitado en el REPS.
Por eso, para un profesional que trabaja solo, lo razonable es que el software haga todo esto: instalar y mantener un contenedor Docker no es parte del oficio de atender pacientes.
Los plazos que sí están en la norma
| Situación | Plazo | Fuente |
|---|---|---|
| Radicar la factura y los RIPS aprobados ante el pagador | 22 días hábiles desde la expedición de la factura validada por la DIAN | Art. 15, Res. 948 de 2026 |
| Si no radicas dentro del plazo | Debes anular la factura y expedir una nueva | Art. 15, parágrafo 1 |
| RIPS de atenciones sin factura | Mínimo diario, máximo mensual, dentro de los 5 primeros días calendario del mes siguiente | Art. 8, Res. 948 de 2026 |
Lo que no existe es un plazo de respuesta del MUV: la norma no fija tiempos de validación. Si lees por ahí que "el MUV responde en X horas", no tiene respaldo normativo.
El cambio de 2026 que no puedes ignorar
El parágrafo transitorio de la Resolución 948 de 2026 lo dice textualmente: "la aplicación de la presente resolución se realizará de manera gradual, de tal forma que, a partir del primero (1) de junio de 2026 entrarán en vigor las reglas de validación que se pasan de notificación a rechazo y a partir del primero (1) de julio de 2026 serán exigibles los ajustes de versión de software de carácter estructural".
Traducción: si tus RIPS tienen errores en una regla de rechazo, no se genera el CUV, y sin CUV la factura queda bloqueada. El propio artículo 3 de la resolución es tajante: "los pagadores no podrán recibir ni tramitar facturas que carezcan del Código Único de Validación (CUV)".
Ya no basta con "enviar algo": tiene que pasar limpio.
Los errores más comunes (y cómo evitarlos)
- Códigos CIE-10 o CUPS mal puestos, inexistentes o con longitud equivocada.
- Código de prestador con el largo equivocado: en el XML de la factura va de 10 posiciones y en el RIPS de 12. Es el clásico.
- Decimales: el RIPS no acepta valores con decimales. Un centavo de diferencia entre la suma del JSON y el total del XML rompe el paquete.
- Datos del paciente incompletos o de relleno. Los documentos "de relleno" ya no pasan.
- El software de facturación no genera la extensión de sector salud en el XML.
- Aprobar con notificaciones y no leerlas. Una notificación no bloquea hoy, pero es un rechazo agendado.
- Enviar fuera de los plazos.
→ Todo esto, con el detalle de cómo leer el reporte de errores, está en errores frecuentes al validar RIPS en el MUV.
La mayoría de estos errores nacen de documentar a mano o en varios sistemas desconectados.
Por qué conviene que el software lo haga por ti
Hacer todo esto manualmente es lento y propenso a errores — y desde 2026, un error te cuesta el cobro. Una historia clínica electrónica bien hecha genera el JSON, lo valida en el MUV y obtiene el CUV automáticamente a partir de lo que documentas. Alira lo hace por ti y, de paso, al firmar cada consulta arma tu RDA en FHIR, listo para el IHCE; el envío se activa en Alira y te acompañamos en el trámite de credenciales.
→ Ver cómo lo resuelve un software para generar RIPS desde la consulta firmada.
→ Empieza gratis 30 días en aliramed.com
Aviso
Esta guía es informativa y no constituye asesoría legal. Para certeza normativa y estructura técnica consulta las fuentes oficiales:
- Resolución 948 de 2026 — MinSalud: https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/DIJ/resolucion-0948-de-2026.pdf
- Documento Técnico 1 (campos y reglas de validación), versión vigente: https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/OT/doc-tec1-tecnicas-datos-validacion-rips-fev-salud.pdf
- Micrositio de facturación electrónica — SISPRO: https://www.sispro.gov.co/central-financiamiento/Pages/facturacion-electronica.aspx
- Tabla de referencia CIE-10 — SISPRO: https://web.sispro.gov.co/WebPublico/Consultas/ConsultarDetalleReferenciaBasica.aspx?Code=CIE10
¿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ósticoPreguntas frecuentes
- ¿Cuáles son los pasos para generar los RIPS?
- Documentas la atención (diagnóstico CIE-10, procedimientos CUPS); generas la factura electrónica de venta (FEV) con validación DIAN; construyes el archivo RIPS en JSON; lo validas en el MUV; y si pasa, recibes el CUV que sirve como soporte de la factura.
- ¿Qué pasa si mis RIPS tienen errores en 2026?
- Con la Resolución 948 de 2026, desde el 1 de junio de 2026 muchas reglas de validación pasaron a modo rechazo. Si los RIPS tienen errores, no se genera el CUV, y sin CUV la factura queda bloqueada y no la puedes cobrar.
- ¿Puedo generar los RIPS a mano?
- Técnicamente sí, pero es lento y propenso a errores, y desde 2026 un error te cuesta el cobro. Lo práctico es que tu historia clínica electrónica genere el JSON, lo valide en el MUV y obtenga el CUV automáticamente a partir de lo que documentas.
- ¿Cuánto tiempo tengo para radicar la factura y los RIPS ante el pagador?
- 22 días hábiles contados desde la expedición de la factura electrónica de venta con validación previa de la DIAN, según el artículo 15 de la Resolución 948 de 2026. Si no radicas dentro de ese plazo, el parágrafo 1 del mismo artículo obliga a anular la factura y expedir una nueva para cobrar esos servicios.
- ¿Cómo se escribe el código CIE-10 en los RIPS?
- Sin punto y con exactamente 4 caracteres. La CIE-10 de la OMS escribe I10, E11.9 o M54.5; en el RIPS eso se informa como I10X, E119 y M545: se elimina el punto y las categorías de tres caracteres se completan con X. Informar más o menos de cuatro posiciones causa el rechazo del archivo.
Guías relacionadas
- Errores frecuentes al validar RIPS en el MUVQué rechaza el validador del MUV, cómo leer el reporte de errores (RVG, RVC, FED), la diferencia entre rechazo y notificación, y cómo corregir y reenviar.
- ¿Qué es el CUV y para qué sirve?El CUV certifica que tus RIPS pasaron la validación del Ministerio. Qué es, en qué se diferencia del CUFE de la DIAN y qué habilita ante el pagador.
- CIE-10 y CIE-11 en los RIPS: qué usar hoyColombia adoptó la CIE-11 (Res. 1442 de 2024), pero la transición corre hasta 2027 y en los RIPS se informa CIE-10 de 4 caracteres sin punto. Las reglas.
Alira arma tu RDA en FHIR, listo para el IHCE, y genera tus RIPS al firmar cada consulta.
Empezar gratis 30 días