Reporte de métricas
Devuelve OEE, disponibilidad, calidad y minutos perdidos por máquina y turno.
Cada fila trae los indicadores del turno (tiempo disponible, tiempo muerto separado por causa) junto con las métricas de producción derivadas: availability, effectiveness, quality, oee y netOee, además de los minutos perdidos por baja velocidad y por baja calidad.
Es un POST que solo lee: basta con el scope reports.read. Es preferible a calcular el OEE a partir de los registros de producción: los límites de turno, la clasificación de paros y los factores de conteo ya están aplicados.
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/reports/metrics" \ -H "Content-Type: application/json" \ -d '{}'{ "totalCount": 100, "totalPages": 10, "currentPage": 1, "metrics": [ { "company": { "id": 1, "name": "company 1" }, "machine": { "id": 1, "name": "machine 1" }, "shift": { "endTime": "2025-11-02T00:00:00", "id": 1, "isActive": true, "name": "morning", "startTime": "2025-11-01T00:00:00" }, "shiftIndicators": { "annotatedDowntime": 0, "availability": 100, "availableTime": 480, "earlyStopTime": 0, "indicatorId": 1, "lateStartTime": 0, "netAvailability": 100, "noDataTime": 0, "nonProgrammedDowntime": 0, "otherStopsTime": 0, "programmedDowntime": 0, "unavailableTime": 0 }, "productionMetrics": { "availability": 100, "effectiveness": 100, "minutesLostByLowQuality": 0, "minutesLostByLowSpeed": 0, "netAvailability": 100, "netOee": 100, "oee": 100, "quality": 100 } } ]}Agregar un operador al turno actual POST
Asigna un operador al turno que la máquina está corriendo en el momento de la llamada. Ambos campos son obligatorios: `operatorId` y `start`, el momento en que empieza la asignación. Úsalo para el registro de entrada en una terminal. Escribe en el turno en curso y tiene efecto de inmediato.
Reporte de paros POST
Devuelve los paros individuales de las máquinas con su duración, causa y clasificación. Es el detalle detrás de los totales de tiempo muerto del reporte de métricas. `stopId` acepta la gramática de comparación completa, así que se puede obtener directamente un paro específico o un rango de ellos.