Consultar 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.

El rango máximo de consulta es de un año. Si se supera este límite, la petición devolverá un error 400 Bad Request indicando en el mensaje Data range is too big.

Si el identificador del empleado no existe en el negocio, la petición devolverá un error 400 Bad Request indicando en el mensaje Employee not found.

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

Enlaces de interés

¿Qué es un contador?