Leer cronogramas
isPM: true y plannedMaintenanceScheduleId, así que puedes listar el historial de un cronograma desde el lado de la orden de trabajo:
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:
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 conPOST /v1/buyer/pm/scheduler_run_logs:
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 elwoId. - Si en cambio hay que omitir una ejecución, llama a
skip_schedulepara que avance la próxima fecha.