Cronogramas de mantenimiento preventivo en la Buyer API

Lee cronogramas de PM, omite ejecuciones próximas e integra un planificador externo con registros de ejecución usando la Buyer API de OpenWrench.

Los cronogramas de mantenimiento preventivo (PM) generan órdenes de trabajo recurrentes sobre activos con una cadencia definida. La Buyer API te permite leer cronogramas, omitir una ejecución y registrar logs de ejecución cuando un sistema externo controla la programación. Todos los ejemplos asumen:

export BASE="https://api.useopenwrench.com/api/external"
export KEY="<your-api-key>"
export SECRET="<shared-secret>"

Leer cronogramas

# Todos los cronogramas y un conteo filtrado
curl -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  "$BASE/v1/buyer/pm/planned_maintenance_schedules?limit=25"
curl -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  "$BASE/v1/buyer/pm/planned_maintenance_schedules/count_by?locationId=1204"

# Un cronograma
curl -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  "$BASE/v1/buyer/pm/planned_maintenance_schedules/512"

Aplica la paginación estándar y el filtrado por campos. Las órdenes de trabajo generadas por un cronograma llevan isPM: true y plannedMaintenanceScheduleId, así que puedes listar el historial de un cronograma desde el lado de la orden de trabajo:

curl -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  "$BASE/v1/buyer/work_order/work_orders?plannedMaintenanceScheduleId=512&sort_by=createdAt&order=desc"

Omitir una ejecución

PATCH /v1/buyer/pm/planned_maintenance_schedules/skip_schedule avanza el cronograma más allá de su próxima ejecución programada (por ejemplo, cuando un sitio está cerrado por renovación). El id del cronograma es el campo requerido:

curl -X PATCH "$BASE/v1/buyer/pm/planned_maintenance_schedules/skip_schedule" \
  -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "id": 512 }'

Se devuelve el cronograma actualizado. Este endpoint no tiene límite de tasa.

Controlar el PM desde un planificador externo

Si tu propio sistema decide cuándo se crean las órdenes de trabajo de PM, cierra el ciclo registrando cada ejecución con POST /v1/buyer/pm/scheduler_run_logs:

curl -X POST "$BASE/v1/buyer/pm/scheduler_run_logs" \
  -H "X-API-KEY: $KEY" -H "OW-KEY: $SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduleId": 512,
    "status": "success",
    "lastRunAt": "2026-08-21T06:00:05.000-07:00",
    "lastRunDueAt": "2026-08-21T06:00:00.000-07:00",
    "woId": 9105,
    "log": "Created WO 9105 for August PM."
  }'

scheduleId, status, lastRunAt y lastRunDueAt son requeridos; woId enlaza la orden de trabajo que creó la ejecución (créala primero con el endpoint de órdenes de trabajo, con isPM: true y plannedMaintenanceScheduleId establecidos), y log guarda diagnósticos de formato libre. El ciclo completo del planificador externo:

Lee los cronogramas y su cadencia desde la API.
Cuando toca una ejecución, crea la orden de trabajo de PM.
Registra la ejecución con scheduler_run_logs, enlazando el woId.
Si en cambio hay que omitir una ejecución, llama a skip_schedule para que avance la próxima fecha.

Primeros pasos

Guías

Referencia de la API

Internal Teams API

Planned maintenance

Cronogramas de mantenimiento preventivo en la Buyer API

Leer cronogramas

Omitir una ejecución

Controlar el PM desde un planificador externo

​Cronogramas de mantenimiento preventivo en la Buyer API

​Leer cronogramas

​Omitir una ejecución

​Controlar el PM desde un planificador externo

Cronogramas de mantenimiento preventivo en la Buyer API

Leer cronogramas

Omitir una ejecución

Controlar el PM desde un planificador externo