Obtener peticiones de un empleado

Este endpoint permite consultar las peticiones de un empleado en un periodo de tiempo no superior a 31 días.

GET /api/v1/businesses/{businessId}/employees/{employeeId}/requests?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 peticiones del empleado en el intervalo de tiempo definido:

Ejemplo de respuesta

[
    {
        "employeeId": "1006350",
        "status": "REQUESTED",
        "type": "MANDATORY",
        "from": "2026-08-27",
        "to": "2026-08-27",
        "fromHour": "20:00",
        "toHour": "22:00"
    },
    {
        "employeeId": "1006350",
        "status": "GRANTED",
        "type": "MAYBE",
        "from": "2026-08-29",
        "to": "2026-08-29",
        "fromHour": "20:00",
        "toHour": "22:00"
    }
]
Detalles

  • employeeId: identificador externo del empleado.

  • status: estado de la petición. Los posibles valores son REQUESTED (solicitada), GRANTED (concedida) y DENIED (denegada).

  • type: tipo de disponibilidad que se aplica a la petición. Los posibles valores son MANDATORY (disponibilidad para trabajar), MAYBE (disponibilidad) y NON_WORKED (día libre).

  • from: fecha de inicio de la petición en formato yyyy-MM-dd.

  • to: fecha de fin de la petición en formato yyyy-MM-dd.

  • fromHour: hora de inicio de la petición en formato HH:mm. Se considera la hora local, es decir, la zona horaria del servicio.

  • toHour: hora de fin de la petición en formato HH:mm. Se considera la hora local, es decir, la zona horaria del servicio.

  • comments: texto libre que puede acompañar a la petición.

  • recover: tipo de recuperación que indica cómo se podría compensar la petición del empleado. Las opciones son FREE (día libre) o NONE (no se ofrece ninguna compensación por la petición).

Como se puede apreciar en el ejemplo, la información de la respuesta dependerá de los datos que se hayan definido para cada petición y el estado de estas en el sistema.

Consideraciones

Los campos fromHour y toHour devuelven los valores en la hora local, determinada por la zona horaria configurada para el servicio.

Si no hay peticiones para el empleado en el intervalo de la consulta, 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

406 Not Acceptable

-

El rango entre from y to supera los 31 días permitidos. Se recomienda acotar el intervalo de consulta.

Enlaces de interés

¿Qué es una petición?