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 contendrá el número de personas asignadas para cada tarea en el día pasado por parámetro.

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.

Aspectos que tener en cuenta

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

Si no hay asignaciones para el día indicado, la petición devolverá 204 No Content.

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

Enlaces de interés

¿Qué es una asignación?

¿Qué es una tarea?