Normatividad

Estructura del archivo RIPS: campos obligatorios del JSON según la Resolución 2275 de 2023

06/05/2026  |  10 min de lectura  |  Jorge Andrés Delgado
Estructura del archivo RIPS en JSON: cabecera, bloque usuarios y campos obligatorios por tipo de servicio según la Resolución 2275 de 2023.

La Resolución 2275 de 2023 redefinió por completo la estructura del archivo RIPS: dejó atrás los archivos planos en formato .txt y adoptó un único archivo JSON que viaja como soporte obligatorio de la Factura Electrónica de Venta (FEV) en salud. Conocer su estructura es indispensable para cualquier IPS, integrador o equipo de desarrollo que trabaje con sistemas asistenciales en Colombia.

En este artículo le explicamos cómo está organizado el JSON RIPS, los campos obligatorios por bloque, los tipos de servicio que se reportan y cómo se valida cada nivel. Si todavía no tiene el contexto general del proceso, revise primero la guía completa de RIPS en Colombia.

Del modelo histórico de archivos planos al JSON único

Hasta 2023, el modelo vigente era el establecido por la Resolución 3374 de 2000: ocho archivos de texto separados por comas (AF, US, AC, AP, AM, AT, AU, AH) que se enviaban en un paquete ZIP. La Resolución 2275 de 2023 reemplazó ese modelo por un archivo JSON único que se adjunta a la FEV.

Aspecto Modelo histórico (Res. 3374/2000) Modelo vigente (Res. 2275/2023)
Formato Archivos planos .txt separados por comas JSON único validado contra esquema oficial
Cantidad de archivos 8 archivos en un ZIP 1 archivo JSON
Soporte Independiente de la factura Soporte obligatorio de la FEV
Validación Validación previa por la EPS MUV (Mecanismo Único de Validación) → CUV
Interoperabilidad Limitada Compatible con HL7 FHIR R4 (Res. 1888/2025)

Estructura general del JSON RIPS

El archivo JSON está organizado en dos bloques: una cabecera con datos del prestador y la factura, y un arreglo de usuarios donde cada elemento representa un paciente atendido y los servicios prestados. 

{
  "numDocumentoIdObligado": "900123456",
  "numFactura": "FEV-12345",
  "tipoNota": null,
  "numNota": null,
  "usuarios": [
    {
      "tipoDocumentoIdentificacion": "CC",
      "numDocumentoIdentificacion": "1020304050",
      "tipoUsuario": "01",
      "fechaNacimiento": "1985-03-15",
      "codSexo": "M",
      "codPaisResidencia": "170",
      "codMunicipioResidencia": "11001",
      "codZonaTerritorialResidencia": "01",
      "incapacidad": "NO",
      "consecutivo": 1,
      "codPaisOrigen": "170",
      "servicios": {
        "consultas": [...],
        "procedimientos": [...],
        "urgencias": [...],
        "hospitalizacion": [...],
        "recienNacidos": [...],
        "medicamentos": [...],
        "otrosServicios": [...]
      }
    }
  ]
}

La cabecera identifica al prestador (numDocumentoIdObligado) y a la factura que el RIPS soporta (numFactura). El bloque usuarios es un arreglo: si una misma FEV cubre la atención de varios pacientes, cada uno aparece como un elemento del arreglo con sus propios servicios.

Campos obligatorios del bloque usuarios

Cada elemento de usuarios describe a un paciente atendido. Los campos obligatorios son:

Campo Tipo Descripción
tipoDocumentoIdentificacion String CC, TI, RC, CE, PA, MS, AS, NV, según catálogo MinSalud.
numDocumentoIdentificacion String Número del documento. Debe ser válido para el tipo seleccionado.
tipoUsuario String 01 contributivo, 02 subsidiado, 03 vinculado, 04 particular, etc.
fechaNacimiento Date (YYYY-MM-DD) Debe ser coherente con el tipo de documento (RC en menores, etc.).
codSexo String M masculino, F femenino, según catálogo.
codPaisResidencia String Código DIVIPOLA del país de residencia.
codMunicipioResidencia String Código DIVIPOLA del municipio de residencia.
codZonaTerritorialResidencia String 01 urbana, 02 rural.
incapacidad String SI/NO indicando si la atención generó incapacidad médica.
consecutivo Integer Consecutivo único del usuario dentro del archivo.

Tipos de servicios reportables

El bloque servicios de cada usuario contiene los arreglos de los servicios prestados. Cada tipo tiene su propio conjunto de campos obligatorios:

consultas

Atenciones de consulta médica, odontológica, psicología, nutrición y otras consultas externas. Campos clave: codConsulta (CUPS), fechaInicioAtencion, codDiagnosticoPrincipal (CIE-10/11), finalidadTecnologiaSalud, tipoDiagnosticoPrincipal, vrServicio, conceptoRecaudo.

procedimientos

Procedimientos quirúrgicos, terapéuticos y diagnósticos. Campos clave: codProcedimiento (CUPS), viaIngresoServicioSalud, modalidadGrupoServicioTecSal, grupoServicios, codDiagnosticoPrincipal.

urgencias

Atención en servicios de urgencias. Campos clave: fechaInicioAtencion, causaMotivoAtencion, codDiagnosticoPrincipal, condicionDestinoUsuarioEgreso, fechaEgreso.

hospitalizacion

Egresos hospitalarios. Campos clave: viaIngresoServicioSalud, fechaInicioAtencion, fechaEgreso, codDiagnosticoPrincipal, condicionDestinoUsuarioEgreso.

recienNacidos

Atención de recién nacidos. Campos clave: tipoDocumentoIdentificacion, numDocumentoIdentificacion, fechaNacimiento, edadGestacional, numConsultasPrenatales, peso, talla.

medicamentos

Medicamentos dispensados. Campos clave: codTecnologiaSalud (CUM), nomTecnologiaSalud, concentracionMedicamento, unidadMedida, cantidadMedicamento, vrUnitMedicamento.

otrosServicios

Servicios no incluidos en las categorías anteriores: traslados, dispositivos médicos, ayudas diagnósticas. Campos clave: codTecnologiaSalud, nomTecnologiaSalud, cantidadOServicio, vrUnitOServicio.

Validaciones que aplica el SISPRO sobre el JSON

El Mecanismo Único de Validación (MUV) ejecuta tres niveles de validación sobre el archivo JSON antes de generar el CUV. Los detalles los explicamos en cómo validar RIPS en Colombia, pero a nivel estructural conviene tener presente:

  • Esquema JSON estricto: claves desconocidas o mal escritas son rechazadas
  • Tipos de dato exactos: números no se aceptan como cadenas y viceversa
  • Catálogos vigentes: CUPS, CIE-10/CIE-11, DIVIPOLA, CUM en su versión actual
  • Coherencia interna: fecha de egreso ≥ fecha de ingreso, edad consistente con tipo de documento
  • Coherencia con la FEV: NIT del prestador, valores totales y cantidad de servicios deben coincidir

Genere RIPS con la estructura JSON correcta, sin reprocesos

Medifolios construye el JSON RIPS directamente desde la historia clínica electrónica, con catálogos actualizados (CUPS, CIE, CUM, DIVIPOLA) y validación contra el esquema oficial. Cuando el Ministerio cambia el modelo, su licencia se actualiza automáticamente.

Recursos relacionados