Descripción
Crea, asigna, prioriza y cierra órdenes de trabajo de mantenimiento con trazabilidad completa.
Parámetros de la Tool
| Parámetro | Tipo | Req. | Default |
|---|---|---|---|
action | string | ✓ Sí | — |
assetId | string | ✓ Sí | — |
priority | string | — | — |
description | string | — | — |
| Campo | Tipo | Formato |
|---|---|---|
workOrderId | string | — |
status | string | — |
assignedTechnician | string | — |
estimatedCompletionHours | number | — |
Guía de Implementación
Se necesita `action` para enrutar la lógica correcta (crear, actualizar, cerrar o listar) sin ambigüedad en el handler. `assetId` es obligatorio porque toda orden de trabajo debe estar vinculada a un activo físico para mantener el historial de mantenimiento por equipo. `priority` define el SLA de respuesta del técnico y la cola de despacho: una OT critical puede requerir respuesta inmediata mientras que low puede programarse. `description` captura el síntoma o trabajo requerido en texto libre para que el técnico entienda el contexto antes de llegar al sitio.
Para `create`: generar un `workOrderId` único (UUID v4 o prefijo+secuencial). Consultar disponibilidad de técnicos en la tabla de recursos filtrada por habilidades requeridas para ese tipo de activo. Calcular `estimatedCompletionHours` basado en el historial de trabajos similares para ese `assetId` o usando tiempos estándar del catálogo de tareas. Asignar estado inicial `open`. Para `update`: validar transiciones de estado permitidas (open → in_progress, in_progress → waiting_parts, etc.). Para `close`: registrar timestamp de cierre, calcular tiempo real transcurrido y actualizar el historial del activo. Para `list`: filtrar por `assetId` y devolver paginado.
`workOrderId` es la referencia que todos los sistemas (SCADA, ERP, historial) usarán para enlazar eventos a esta OT. `status` permite al agente decidir si escalar, esperar o continuar el flujo de mantenimiento. `assignedTechnician` habilita notificaciones push al técnico correcto. `estimatedCompletionHours` es el dato que alimenta la planificación de capacidad y el cálculo de KPIs de MTTR.
Formulario con dropdown de `action` que muestra/oculta campos condicionalmente. Badge de prioridad con colores (rojo=critical, naranja=high, amarillo=medium, azul=low). Lista de OTs abiertas en tabla con columnas: ID, Activo, Prioridad, Técnico, Estado y tiempo transcurrido. Botón de acción contextual por fila según estado actual.
Conexiones con otras Tools
Condición de activo degradada genera orden de trabajo automáticamente
Orden de trabajo aprobada verifica y reserva repuestos necesarios
Evento ISO que genera esta tool
standardEvent.module.iddebe usar este nombre exacto.work_order_event→ se visualiza en el Dashboard ISO y Reporte de AuditoríaCláusulas ISO que cubre este evento
Gestión de órdenes de trabajo de mantenimiento correctivo y preventivo.
Demo en vivo
Presiona Ejecutar Demo para ver cómo actúa esta tool en tiempo real