Obtener valores históricos de contadores de un empleado

Este endpoint devuelve el listado de valores históricos de contadores registrados para un empleado en un intervalo de tiempo determinado.

GET /api/v1/businesses/{businessId}/employees/{employeeId}/counter-historical-values?from={yyyy-MM-dd}&to={yyyy-MM-dd}

Si los datos incluidos en la petición son correctos —tanto el businessId como el employeeId—, la respuesta contendrá el listado de valores históricos de contadores del empleado en el intervalo de tiempo definido.

Ejemplo de respuesta

[
    {
        "day": "2026-02-08",
        "counterShortName": "THS-C",
        "key": "counter.weekly_total_hours",
        "value": 240.0
    },
    {
        "day": "2026-02-15",
        "counterShortName": "THM",
        "key": "counter.monthly_total_hours",
        "value": 120.0
    }
]
Detalles

  • day: fecha del valor histórico en formato yyyy-MM-dd.

  • counterShortName: abreviatura del contador al que pertenece el valor histórico. Se devolverá la versión personalizada si se ha modificado o, en caso contrario, la abreviatura por defecto.

  • key: clave interna del contador asociado al valor histórico.

  • value: valor registrado en el contador para el día indicado.

Aspectos que tener en cuenta

Los parámetros from y to no son obligatorios. Si no se incluyen en la petición, el intervalo consultado corresponderá al último año.

Si no hay valores históricos registrados para el empleado en el intervalo consultado, la petición devolverá un array vacío [].

Códigos de error

Además de los errores comunes, este endpoint puede devolver los siguientes códigos:

Código Mensaje Descripción

400 Bad Request

Employee not found

El identificador de empleado indicado no existe en el negocio. A diferencia de otros endpoints, aquí el error se devuelve como 400, no como 404. Se recomienda verificar el identificador a través de Obtener información de un empleado.

Data range is too big

El intervalo entre from y to supera el máximo permitido de 367 días (aproximadamente un año). Se recomienda acotar el rango de fechas consultado.

From date cannot be after to date

La fecha from es posterior a to. Se recomienda comprobar el orden de los parámetros antes de enviarlos.

Enlaces de interés

¿Qué es un contador?