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.

Consideraciones

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 [].

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

Códigos de error

Este endpoint no devuelve códigos de error propios que no se encuentren descritos en errores comunes.

Enlaces de interés

¿Qué es una asignación?