Obtener resumen de asignaciones por servicio

Este endpoint devuelve el resumen de asignaciones de un servicio para un día.

GET /api/v1/businesses/{businessId}/services/{serviceId}/assignments/summary/{yyyy-MM-dd}

Si los datos incluidos en la petición son correctos —tanto el businessId como el serviceId—, la respuesta será un 200 OK con el número de personas asignadas para cada tarea en el día pasado por parámetro. Si no hay ninguna asignación para el servicio en ese día, la respuesta será un 204 No Content sin cuerpo.

Ejemplo de respuesta

[
    {
        "location": "UNLOADING",
        "locationId": "08",
        "product": "0001-G",
        "service": "0001",
        "timeSlots": [
            {
                "from": "2024-09-16T06:45:00.000Z",
                "to": "2024-09-16T07:00:00.000Z",
                "total": 2
            },
            {
                "from": "2024-09-16T07:00:00.000Z",
                "to": "2024-09-16T07:15:00.000Z",
                "total": 2
            },
            {
                "from": "2024-09-16T07:15:00.000Z",
                "to": "2024-09-16T07:30:00.000Z",
                "total": 2
            },
            {
                "from": "2024-09-16T07:30:00.000Z",
                "to": "2024-09-16T07:45:00.000Z",
                "total": 2
            }
        ],
        "zone": "General"
    },
    {
        "location": "OPENING",
        "locationId": "01",
        "product": "0001-G",
        "service": "0001",
        "timeSlots": [
            {
                "from": "2024-09-16T07:00:00.000Z",
                "to": "2024-09-16T07:15:00.000Z",
                "total": 1
            },
            {
                "from": "2024-09-16T07:15:00.000Z",
                "to": "2024-09-16T07:30:00.000Z",
                "total": 1
            },
            {
                "from": "2024-09-16T07:30:00.000Z",
                "to": "2024-09-16T07:45:00.000Z",
                "total": 1
            },
            {
                "from": "2024-09-16T07:45:00.000Z",
                "to": "2024-09-16T08:00:00.000Z",
                "total": 1
            }
        ],
        "zone": "General"
    }
]

Detalles

location: nombre de la tarea.
locationId: identificador externo de la tarea.
product: identificador externo del producto o sección.
service: identificador externo del servicio o tienda.
timeSlots: franjas horarias que indican durante cuánto tiempo se necesitan los empleados en la tarea. Cada franja horaria tiene una duración de 15 minutos y contiene los siguientes campos:
- from: inicio de la franja horaria en UTC.
- to: fin de la franja horaria en UTC.
- total: cantidad de empleados asignados a la franja horaria.
zone: lugar físico del servicio (tienda, restaurante, etc.) donde se realiza la tarea.

Para cada tarea del ejemplo (UNLOADING y OPENING), se especifican los rangos de tiempo en intervalos de 15 minutos y el número de empleados necesarios en cada uno de esos intervalos.

Consideraciones

Si el servicio tiene varios productos o secciones, la respuesta contendrá las tareas de todos ellos.

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?

¿Qué es una tarea?