Resultados de Validación - Indice Manual Integración Directa HKA Fácil RIPS

Resultados de Validación - Indice Manual Integración Directa HKA Fácil RIPS

Cuando se realiza una petición a los métodos de la API HKA Fácil RIPS, el sistema interactúa con el Ministerio de Salud para validar el documento. El resultado de esta validación se entrega dentro del objeto archivoRetornado.

Object.archivoRetornado

Este objeto contiene los detalles del resultado retornado por el Ministerio de Salud. Solo estará presente (no nulo) cuando el RIPS haya alcanzado la etapa de validación en el Ministerio.

Atributo	Tipo Dato	Formato	Descripción
codigoUnicoValidacion	String	AN	Código Único de Validación (CUV) asignado por el Ministerio de Salud al RIPS aceptado. Solo presente cuando el RIPS fue aceptado (resultState: true). Cuando el RIPS es rechazado, este campo retorna: "No aplica a paquetes procesados en estado [RECHAZADO]"
fechaRadicacion	String	datetime	Fecha y hora de radicación del RIPS ante el Ministerio de Salud. Formato: YYYY-MM-DDThh:mm:ssZ
fechaRespuesta	String	datetime	Fecha y hora de la respuesta del Ministerio de Salud. null si el Ministerio aún no ha emitido respuesta.
numFactura	String	AN	Número de la factura electrónica asociada al RIPS. Para RIPS sin FEV (tipoRips: "02"), retorna el valor "SINFEV".
procesoId	integer	INT32	Identificador interno del proceso de validación en el Ministerio de Salud. Retorna 0 cuando el RIPS es rechazado.
resultadosValidacion	Array <Object.ResultadoValidacion>	-	Lista de errores de validación retornados por el Ministerio de Salud cuando el RIPS es rechazado. Array vacío [] cuando el RIPS es aceptado. (ver detalle en Object.ResultadoValidacion)
resultState	boolean	boolean	Resultado de la validación por parte del Ministerio de Salud. true El Ministerio aceptó el RIPS (estado: VALIDADO). false El Ministerio rechazó el RIPS (estado: RECHAZADO).
rutaArchivos	String	AN	Ruta interna de almacenamiento de los archivos generados del RIPS.
message	String	AN	Mensaje adicional retornado por el Ministerio de Salud. null si no hay mensajes adicionales.

Object.ResultadoValidacion

Cuando el Ministerio de Salud rechaza un RIPS (código de negocio 99), el campo resultadosValidacion contendrá una lista de objetos que describen cada uno de los errores encontrados en la estructura o contenido de los datos.

Atributo	Tipo Dato	Formato	Descripción
clase	String	AN	Clasificación del resultado de validación. Valor posible: RECHAZADO
codigo	String	AN	Código único del error de validación asignado por el Ministerio de Salud. Ejemplo: RVG06
descripcion	String	AN	Descripción general del error de validación.
fuente	String	AN	Componente del paquete RIPS donde se encontró el error. Ejemplo: Rips
observaciones	String	AN	Detalle específico del error. Incluye el valor incorrecto enviado y los valores permitidos según la normativa.
pathFuente	String	AN	Ruta JSON al campo específico donde se encontró el error. Usar esta ruta para localizar y corregir el dato incorrecto en el ripsJson original. Ejemplo: usuarios[0].servicios.otrosServicios[0].conceptoRecaudo

Ejemplo de Rechazo del Ministerio

El siguiente es un ejemplo de cómo se visualizan los errores de validación cuando el Ministerio rechaza el RIPS por un valor inválido en el campo conceptoRecaudo:

{

 "codigo": 99,
 "mensaje": "Error al enviar el RIPS: El dato informado no corresponde al contenido requerido.",
 "estado": false,
 "idRips": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
 "archivoRetornado": {
   "codigoUnicoValidacion": "No aplica a paquetes procesados en estado [RECHAZADO]",
   "fechaRadicacion": "2025-10-27T10:30:00Z",
   "fechaRespuesta": null,
   "numFactura": "SINFEV",
   "procesoId": 0,
   "resultadosValidacion": [
     {
       "clase": "RECHAZADO",
       "codigo": "RVG06",
       "descripcion": "El dato informado no corresponde al contenido requerido.",
       "fuente": "Rips",
       "observaciones": "El valor del campo conceptoRecaudo no es válido. Debe ser uno de los valores permitidos: 01, 02, 03, 04, 05.",
       "pathFuente": "usuarios[0].servicios.otrosServicios[0].conceptoRecaudo"
     }
   ],
   "resultState": false,
   "message": "Error al enviar el RIPS: El dato informado no corresponde al contenido requerido."
 }

}

Interpretación del error:

• Código de error: RVG06 - Error de validación de dato incorrecto.
• Campo con error: usuarios[0].servicios.otrosServicios[0].conceptoRecaudo - El campo conceptoRecaudo del primer servicio del primer usuario tiene un valor no permitido.
• Acción: Corregir el valor de conceptoRecaudo usando uno de los valores válidos (01, 02, 03, 04, 05) y volver a enviar el RIPS.