Asignar por hora
Asigna un operador al turno que la máquina machineId estaba corriendo en start, a partir de start. Úsalo para registrar a posteriori quién operó una máquina, por ejemplo un día después desde un sistema de planeación, cuando conoces la máquina y la hora pero no el ID del turno (GET /v1/shifts lista los IDs). Para un turno en curso en una terminal de planta, POST /v1/realtime/{machine_id}/operator es la llamada más corta.
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.
- Primera asignación. Si el turno todavía no tiene a nadie asignado, el operador cubre el turno completo, desde su primer minuto, aunque
startsea posterior. - Asignaciones posteriores. Cada una divide la línea de tiempo en
start: quien tenía la máquina la conserva hastastart, y el nuevo operador la toma desdestarthasta el final del turno. - El orden importa. Envía las asignaciones en orden cronológico. Un
startanterior al último cambio del turno se rechaza con400, así que después no puedes insertar un operador en medio. Unstartigual al último cambio reemplaza al operador que tomó la máquina en ese momento. - Los reintentos son seguros. Enviar la misma asignación otra vez no cambia nada.
startse redondea hacia abajo al minuto.
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.
Las métricas de operador del turno se recalculan en segundo plano, así que los reportes pueden tardar un momento en mostrar el cambio.
Errores:
400: ningún turno coincide, ostartestá fuera del turno, en el futuro, o antes del último cambio de operador del turno.403: el turno tiene producción marcada como revisada, lo que lo bloquea.404: el operador no existe en tu empresa.
Cuerpo de la solicitud
application/json
Definiciones de TypeScript
Usa el tipo request body en TypeScript.
Cuerpo de la respuesta
application/json
application/json
curl -X POST "https://example.com/v1/shifts/operator" \ -H "Content-Type: application/json" \ -d '{ "machineId": 12, "operatorId": 1063, "start": "2026-10-12T10:00:00Z" }'{ "shiftId": 48213, "machineId": 12, "operatorId": 1063, "start": "2026-10-12T10:00:00Z"}Definir metas de turnos PUT
Define la meta de producción de turnos existentes, para días próximos o pasados. El cuerpo es un **arreglo** JSON de hasta 1,000 filas, así que un plan completo (o su exportación a CSV) cabe en una sola llamada. Cada fila indica un turno por su máquina (`uuid` o `name`), la fecha (`date`) en que empieza en la zona horaria de la empresa, y su nombre (`title`, por ejemplo `Morning`). Enviar los mismos valores otra vez no causa problemas: la meta se sobrescribe, no se suma. Cada fila regresa con un `status`, y solo las filas `updated` cambiaron algo: * `updated`: la meta del turno ahora es `targetQuantity`. * `machineNotFound` / `ambiguousMachine`: ninguna máquina, o más de una, coincide con `machine`. * `shiftNotFound` / `ambiguousShift`: la máquina no tiene ningún turno, o tiene más de uno, con ese nombre que empiece en esa fecha. * `duplicateShift`: otra fila de la misma solicitud apunta al mismo turno, así que no se aplicó ninguna de las dos. Las metas se leen en vivo del turno, así que las vistas de tiempo real y de turnos muestran el nuevo valor de inmediato. No se recalcula nada: la meta no interviene en el OEE.
Asignar operador a turno POST
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. * **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. * **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 son seguros.** Enviar la misma asignación otra vez no cambia nada. * `start` se redondea hacia abajo al minuto. 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. Las métricas de operador del turno se recalculan en segundo plano, así que los reportes pueden tardar un momento en mostrar el cambio. Errores: * `400`: ningún turno coincide, o `start` está fuera del turno, en el futuro, o antes del último cambio de operador del turno. * `403`: el turno tiene producción marcada como revisada, lo que lo bloquea. * `404`: el operador no existe en tu empresa.