Ver operadores del turno

Asigna un operador a un turno por su ID (el que devuelve GET /v1/shifts), incluso en turnos que ya terminaron. Sin start, el operador toma la máquina desde el inicio del turno. Cómo se suman las asignaciones de operador. Cada turno guarda una línea de tiempo de quién operó la máquina. Una asignación significa "a partir de start, este operador opera la máquina": dura hasta el final del turno, o hasta la siguiente asignación. La única excepción es la primera asignación del turno, que también cubre el tiempo antes de start. * Primera asignación. Si el turno todavía no tiene a nadie asignado, el operador cubre el turno completo, desde su primer minuto, aunque start sea posterior. Ese tiempo anterior le queda atribuido de forma definitiva: después no se puede dejar sin asignar ni dárselo a otra persona, porque cualquier start posterior que sea anterior al suyo se rechaza. Para dejárselo a otro operador, asigna primero a ese operador, desde el inicio del turno. * Asignaciones posteriores. Cada una divide la línea de tiempo en start: quien tenía la máquina la conserva hasta start, y el nuevo operador la toma desde start hasta el final del turno. * El orden importa. Envía las asignaciones en orden cronológico. Un start anterior al último cambio del turno se rechaza con 400, así que después no puedes insertar un operador en medio. Un start igual al último cambio reemplaza al operador que tomó la máquina en ese momento. * Los reintentos no siempre son seguros. Enviar la misma asignación otra vez no cambia nada solo si ninguna otra asignación llegó al turno entre tanto. Si no, el reintento puede deshacer un relevo posterior: si se asigna al operador A desde las 10:00 y luego al operador B desde las 10:00, enviar otra vez la solicitud de A reemplaza a B por A. Antes de reintentar una solicitud cuyo resultado no conoces, como una que agotó el tiempo de espera, revisa que no se haya hecho ninguna asignación posterior al turno, y no dejes que dos sistemas asignen operadores al mismo turno. * start se redondea hacia abajo al minuto, así que dos valores de start en el mismo minuto cuentan como el mismo cambio. Por ejemplo, para un turno Morning de 06:00 a 14:00 sin nadie asignado todavía: | Solicitud | Línea de tiempo después | | --- | --- | | operador 1063 desde las 10:00 | 1063 06:00–14:00 (la primera asignación cubre el turno completo) | | operador 2071 desde las 10:00 | 1063 06:00–10:00, 2071 10:00–14:00 | | operador 3300 desde las 12:00 | 1063 06:00–10:00, 2071 10:00–12:00, 3300 12:00–14:00 | | operador 4410 desde las 08:00 | Rechazada con 400: las 08:00 son antes del último cambio, a las 12:00 | Para registrar un turno que tuvo varios operadores, envía el primero desde el inicio del turno y luego los demás en el orden en que tomaron la máquina. GET /v1/shifts/{shift_id}/operators devuelve la línea de tiempo tal como está, así que puedes revisar el resultado, o lo que ya tiene un turno antes de reintentar. Las métricas de operador del turno se recalculan en segundo plano, así que los reportes pueden tardar un momento en mostrar el cambio. Los errores llevan un code estable (consulta las respuestas abajo): * 400 shift_not_found: ningún turno coincide. * 400 invalid_start: start está fuera del turno, en el futuro, o antes del último cambio de operador del turno. * 403 shift_locked: el turno tiene producción marcada como revisada, lo que lo bloquea. * 404 operator_not_found: el operador no existe en tu empresa.