Agregar defectos a turno

Agrega unidades defectuosas de un SKU a un turno por su ID (el que devuelve GET /v1/shifts), incluso en turnos que ya terminaron.

Cómo se suman los defectos. A diferencia de los operadores, los defectos no tienen línea de tiempo ni orden. Cada llamada agrega un nuevo registro de producción de defectos de quantity unidades del SKU, que cubre el turno completo, y la Calidad y el OEE del turno lo toman en cuenta en segundo plano. Una llamada nunca reemplaza a las anteriores:

  • Enviar quantity: 2 y luego quantity: 3 registra 5 defectos.
  • Enviar la misma solicitud dos veces registra los defectos dos veces, así que reintenta solo las solicitudes que fallaron.
  • Para deshacer una llamada, elimina el registro que devolvió con DELETE /v1/production-logs/{id}. Para ver lo que ya tiene un turno, lista sus registros con POST /v1/production-logs/filters.

Los defectos no se atribuyen a ningún operador, y se pueden agregar a turnos pasados, incluso a los que tienen la producción revisada. El SKU se indica por id o por name; un nombre desconocido crea un SKU nuevo, así que revisa cómo está escrito.

Errores:

  • 400: ningún turno coincide, el turno todavía no empieza, o el turno no tiene suficiente producción de ese SKU para contener los defectos.
  • 404: sku.id no es uno de tus SKUs.

Parámetros de ruta

shift_id*Shift Id

El ID del turno.

Cuerpo de la solicitud

application/json

Definiciones de TypeScript

Usa el tipo request body en TypeScript.

Cuerpo de la respuesta

application/json

application/json

Pruébalo en vivo
POST
/v1/shifts/{shift_id}/defects

Este endpoint requiere autenticación. Pega un token en la sección Autorización, más abajo.

curl -X POST "https://example.com/v1/shifts/0/defects" \  -H "Content-Type: application/json" \  -d '{    "sku": {}  }'
{  "id": "5b0f6a52-3c1e-4d5b-9f0e-8a7c6d5e4f3a",  "shiftId": 48213,  "machineId": 12,  "quantity": 3,  "start": "2026-10-12T06:00:00Z",  "end": "2026-10-12T14:00:00Z"}

Agregar defectos por hora POST

Agrega unidades defectuosas de un SKU al turno que la máquina `machineId` estaba corriendo en `time`, incluso en turnos que ya terminaron. Úsalo cuando conoces la máquina y aproximadamente cuándo se encontraron los defectos, pero no el ID del turno. **Cómo se suman los defectos.** A diferencia de los operadores, los defectos no tienen línea de tiempo ni orden. Cada llamada agrega un nuevo registro de producción de defectos de `quantity` unidades del SKU, que cubre el turno completo, y la Calidad y el OEE del turno lo toman en cuenta en segundo plano. Una llamada nunca reemplaza a las anteriores: * Enviar `quantity: 2` y luego `quantity: 3` registra 5 defectos. * Enviar la misma solicitud dos veces registra los defectos dos veces, así que reintenta solo las solicitudes que fallaron. * Para deshacer una llamada, elimina el registro que devolvió con `DELETE /v1/production-logs/{id}`. Para ver lo que ya tiene un turno, lista sus registros con `POST /v1/production-logs/filters`. Los defectos no se atribuyen a ningún operador, y se pueden agregar a turnos pasados, incluso a los que tienen la producción revisada. El SKU se indica por `id` o por `name`; un nombre desconocido crea un SKU nuevo, así que revisa cómo está escrito. Errores: * `400`: ningún turno coincide, el turno todavía no empieza, o el turno no tiene suficiente producción de ese SKU para contener los defectos. * `404`: `sku.id` no es uno de tus SKUs.

Listar las señales de una máquina GET

Devuelve las señales de sensor en crudo que expone una máquina, con el `public_id` necesario para leer sus muestras. Una señal es un canal de sensor que lee la máquina, nombrado según la magnitud física que transporta (`current`, `count`, `product_count`, `cycle`, `energy`, `temperature`, `pressure`, ...). Una máquina puede exponer varias señales con el mismo `name`; su `display_name` las distingue. No se listan las señales eliminadas ni las que no tienen un tipo. `description` viene en inglés por defecto; pasa `language=es` para obtenerla en español. Una descripción sin traducción al idioma pedido se devuelve en inglés.