Consultar los conceptos acumulados en un rango de fechas.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Versión resumida/agregada por empleado de los conceptos acumulados (a diferencia de Explorador de acumulados por concepto, que desglosa por concepto individual).
Path Params
| Parámetro | Tipo | Descripción |
|---|---|---|
fechaDesde | string | Fecha inicial del rango a consultar, formato AAAA-MM-DD. |
fechaHasta | string | Fecha final del rango a consultar, formato AAAA-MM-DD. |
isDetalleParaAportes | string ("true"/"false") | Si es true, usa la consulta fuente de "detalle para aportes" en vez de la de acumulados genéricos — son dos fuentes de datos distintas, no un simple filtro adicional. |
Reglas de negocio
Es de los pocos endpoints de reportes por concepto que sí pagina (offset/size). No valida permisos especiales en el código, a diferencia de su endpoint hermano Explorador de acumulados por concepto.
- El rango de fechas se aplica sobre la fecha inicial del pago (
fechaDesdedel pago), no sobre la fecha de pago ni sobre la fecha de cada concepto. - Solo considera pagos definitivos; los pagos en preparación o por aprobar no aparecen.
- La paginación funciona únicamente con
offsetysize. El parámetropagese acepta en la URL pero el backend lo ignora, sin devolver error: paginar conpageretorna siempre la primera página. Para la segunda página de 20 registros, enviaroffset=20&size=20. - El campo
tipoCotizantede la respuesta viene con la descripción del tipo de cotizante (ej.Dependiente), no con el código — a diferencia de otros endpoints de pagos que devuelven el código. - Es la alternativa recomendada cuando se necesita la nómina de un mes en un solo llamado, ya que Listar todos los pagos de nómina no acepta filtros por fecha.
Campos de la respuesta
Cada elemento de contenido corresponde a un empleado con sus valores ya sumados en el rango consultado.
| Campo | Tipo | Descripción |
|---|---|---|
uuidVinculado | string | Uuid de la vinculación laboral (contrato) del empleado. Es el identificador que esperan los endpoints de Empleados y Vinculados. |
uuidEmpleado | string | Uuid de la persona (empleado). Corresponde al empleadoUuid de Listar empleados. |
id | string | Número de documento (cédula) del empleado. El nombre del campo viene del modelo de datos; no es un identificador interno. |
nombreCompleto | string | Nombre completo del empleado. |
tipoCotizante | string | Descripción del tipo de cotizante (ej. Dependiente), no el código. |
salarioBase | number | Salario base del empleado en el pago. |
salarioIntegral | boolean | true si el empleado tiene salario integral. |
totalDevengados | number | Suma de devengados del rango. |
totalDeducciones | number | Suma de deducciones del rango. |
totalNeto | number | Suma del neto de los comprobantes del rango. |
Los importes de 10.000.000 o más se serializan en notación científica — un valor de 18.404.777 llega como 1.8404777E7 — y por debajo de ese umbral en notación decimal normal. Los uuid son texto de 32 caracteres hexadecimales en mayúscula sin guiones. Ver la sección "Formato de la respuesta" de Listar todos los pagos de nómina para el detalle de estas convenciones.
Identificadores del empleado
Este endpoint permite cruzar en un solo llamado la cédula con los dos uuid del empleado, sin consultas adicionales:
| Necesito | Campo / endpoint |
|---|---|
| Cédula del empleado | Campo id de esta respuesta. |
| Uuid de la persona | Campo uuidEmpleado de esta respuesta. |
| Uuid del contrato | Campo uuidVinculado de esta respuesta. |
| Cédula → uuid, para todos los empleados | Listar empleados — GET /empleados. Devuelve empleadoUuid, identificacion, vinculadoUuid y tipoDocumento de cada empleado con contrato vigente. |
| Cédula → uuid, para un empleado puntual | Empleado por documento — GET /empleados/{tipoDocumento}/{identificacion}. |
No confundiruuidEmpleadoconuuidVinculado. La mayoría de los endpoints de empleado (información laboral, salarial y adicional) esperan el uuid del vinculado, no el del empleado.