Obtener horarios por producto

Este endpoint devuelve los horarios de un producto o sección dentro de un periodo de tiempo no superior a 31 días.

GET /api/v1/business/{businessId}/products/{productId}/schedules/from/{yyyy-MM-dd}/to/{yyyy-MM-dd}

Si los datos incluidos en la petición son correctos —tanto el businessId como el productId—, la respuesta contendrá los horarios del producto o sección para el periodo de tiempo indicado en la URL.

Ejemplo de respuesta

[
    {
        "product": "0001-GENERAL",
        "person": "170326",
        "day": "2026-08-12",
        "isWorked": false,
        "rests": [
            {
                "start": "2026-08-12T00:00:00+02:00",
                "end": "2026-08-13T00:00:00+02:00",
                "paid": false
            }
        ]
    },
    {
        "product": "0001-GENERAL",
        "person": "170326",
        "day": "2026-08-11",
        "isWorked": true,
        "shift": [
            {
                "start": "2026-08-11T07:00:00+02:00",
                "end": "2026-08-11T12:00:00+02:00"
            }
        ],
        "rests": [
            {
                "start": "2026-08-11T08:00:00+02:00",
                "end": "2026-08-11T09:00:00+02:00",
                "paid": true
            }
        ]
    }
]
Detalles

  • product: identificador externo del producto o sección.

  • person: identificador externo del empleado.

  • day: día al que corresponde el turno, en formato yyyy-MM-dd.

  • isWorked: indica si el día es un día de trabajo (true) o libre (false).

  • shift: lista de turnos de trabajo del día. Cada tramo contiene:

    • start: inicio del turno en hora local. El formato es yyyy-MM-ddTHH:mm:ssXXX, incluyendo el offset de la zona horaria del servicio.

    • end: fin del turno en hora local. El formato es yyyy-MM-ddTHH:mm:ssXXX, incluyendo el offset de la zona horaria del servicio.

  • rests: lista de descansos del día. Cada descanso contiene:

    • start: inicio del descanso en hora local. El formato es yyyy-MM-ddTHH:mm:ssXXX, incluyendo el offset de la zona horaria del servicio.

    • end: fin del descanso en hora local. El formato es yyyy-MM-ddTHH:mm:ssXXX, incluyendo el offset de la zona horaria del servicio.

    • paid: indica si el descanso es remunerado.

Teniendo en cuenta los datos del ejemplo, los turnos del empleado son:

  • 2026-08-11: día de trabajo ("isWorked": true) con un turno de 07:00 a 12:00, y un descanso remunerado de 08:00 a 09:00.

  • 2026-08-12: día libre ("isWorked": false) no remunerado.

Aspectos que tener en cuenta

Los horarios se expresan en la zona horaria configurada para el servicio asociado al producto o sección.

Si no hay horarios para el periodo de tiempo indicado en la URL, la petición devolverá un array vacío [].

Si el producto indicado en la URL no existe en el negocio, la petición devolverá un error 404 Not Found, especificando en el mensaje not exits.

Si el intervalo indicado en la URL es superior a 31 días, la petición devolverá un error 406 Not Acceptable, especificando en el mensaje The request exceded the maximum number of days allowed.

Esta consulta no devuelve información relacionada con incidencias, solo los datos de las asignaciones: turnos y días libres.

Enlaces de interés

¿Qué es una asignación?