Clasificar paros
Scope requerido: stop_classifications.update. Relacionados: reports.read para encontrar los paros que hay que clasificar con POST /v1/reports/stops; stop_catalogs.read para listar las causas y los componentes que acepta cada máquina con GET /v1/stops/classification-options.
Clasifica paros: define su causa general, causa específica, componente y descripción. El cuerpo es un arreglo JSON de hasta 1,000 filas, cada una con su propia clasificación.
Cómo identificar un paro. Un paro se identifica por su máquina y la hora en que empezó, no por un id: los ids de paro pueden cambiar cuando se recalcula un turno. Toma machine.id y stop.startTime de POST /v1/reports/stops. También se pueden clasificar los paros abiertos, que siguen en curso.
Cómo elegir una clasificación. Cada máquina acepta solo las causas de su árbol de pérdidas y sus propios componentes, que lista GET /v1/stops/classification-options. Una fila define al menos un generalCauseId o una description; specificCauseId necesita un generalCauseId.
Una fila reemplaza la clasificación del paro. Lo que una fila no incluye se borra: enviar solo generalCauseId quita la causa específica, el componente y la descripción del paro. Enviar las mismas filas otra vez no causa problemas, así que una solicitud que agotó el tiempo de espera se puede reintentar tal cual. Una causa que un operador puso en Pulsar también se sobrescribe.
Cada fila regresa con un status, y solo las filas classified cambiaron algo:
classified: el paro ahora tiene esta clasificación.stopNotFound: la máquinamachineIdno tiene ningún paro que haya empezado enstartTime, o no es una de tus máquinas.duplicateStop: otra fila de la misma solicitud indica el mismo paro, así que no se aplicó ninguna de las dos.generalCauseNotAvailable: la causa general no está en el árbol de pérdidas de la máquina.specificCauseNotAvailable: la causa específica no va debajo de la causa general en esta máquina.componentNotAvailable: el componente no está asignado a la máquina.
El esquema también lista missingClassification y missingGeneralCause. Este endpoint rechaza esas filas con 422 antes de que lleguen a Pulsar, así que no las vas a recibir.
Las filas del resultado repiten tus filas en el orden de la solicitud, con startTime normalizado a UTC; relaciónalas por posición en lugar de comparar los textos de startTime.
Las filas classified de una solicitud se guardan juntas. Las métricas que dependen de las causas de los paros se recalculan en segundo plano, así que los reportes pueden tardar un momento en mostrar el cambio.
Cuerpo de la solicitud
application/json
Definiciones de TypeScript
Usa el tipo request body en TypeScript.
Un arreglo JSON. Cada elemento tiene estos campos:
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/stops/classifications" \ -H "Content-Type: application/json" \ -d '[ { "machineId": 12, "startTime": "2026-10-12T10:00:00Z" } ]'[ { "machineId": 12, "startTime": "2026-10-12T10:00:00Z", "generalCauseId": "d56aece5-a92a-462e-b275-919e15446bba", "specificCauseId": "f89b5866-2d26-45a1-8cfc-8295557594d8", "componentId": "3e8e81cf-7521-4ef9-b6c9-40074aa764c5", "description": "Bearing seized on the main motor", "status": "classified" }]Opciones de clasificación GET
Lista, por máquina, las clasificaciones que PUT /v1/stops/classifications acepta para sus paros: * generalCauses: las causas generales del árbol de pérdidas de la máquina, cada una con las specificCauses que pueden ir debajo de ella. * components: los componentes asignados a la máquina. Una máquina sin árbol de pérdidas no tiene causas generales; a sus paros solo se les puede dar una description. Filtra la lista con machineId, repetido para varias máquinas: ` GET /v1/stops/classification-options?machineId=12&machineId=13 `
Paro creado Webhook
Se envía cuando Pulsar registra un paro de máquina nuevo, esté clasificado o no. Los campos de la causa son null hasta que alguien lo clasifique.