Tareas programadas

Jobs programados es la lista en configuración de plataforma donde el staff define trabajo en background recurrente (payout semanal de couriers, retención GPS y futuros handlers registrados en código). Cada fila es una instancia ligada a un handler; no se crean tipos de handler nuevos desde la UI.

Vista general

Lista de jobs programados con columnas de estado, cronograma y última ejecución

La tabla muestra cada instancia: Nombre, Handler (etiqueta del catálogo en código), Estado, Cronograma (resumen legible + cron en monospace), Última ejecución y Próxima ejecución. Los jobs de sistema llevan badge Sistema; sus checkboxes y Delete están deshabilitados.

Qué significa cada columna

Estado

  • Activo — BullMQ ejecuta según el cron; Próxima ejecución muestra el próximo disparo en UTC cuando aplica.
  • Pausado — Sin corridas automáticas; Próxima ejecución vacía. Con permiso update podés Ejecutar ahora.
  • Deshabilitado — Sin corridas automáticas ni manuales hasta volver a Activo o Pausado.

Cronograma

El resumen lo calcula el servidor a partir de cron + zona horaria (ej. «Lun 12:00 UTC»). La expresión cron en gris es la fuente de verdad (minuto hora día mes día-semana).

Última ejecución

La corrida más reciente: Exitoso, Fallido o En curso, con marca de tiempo. Los fallos pueden incluir tooltip con failureReason.

Próxima ejecución

Vacía si el job está Pausado o Deshabilitado, o si no hay próximo disparo programado.

Acciones

Agregar job

  • Permiso: platform.scheduled_jobs.create
  • Abre el formulario (S-114) para un handler aún sin instancia (v1: una instancia por handler).

Ejecutar ahora

  • Permiso: platform.scheduled_jobs.update
  • POST manual; oculto/deshabilitado en Deshabilitado.

Eliminar / bulk

  • Permiso: platform.scheduled_jobs.delete
  • Omite filas system; 403 si solo seleccionás system.

La barra bulk aparece con filas eliminables: N seleccionados, Limpiar selección, Eliminar seleccionados.

Permisos

  • Read (platform.scheduled_jobs.read) — listar y abrir detalle.
  • Create — Agregar job + CTA en empty state.
  • Update — Guardar política, Ejecutar ahora.
  • Delete — eliminar fila y bulk (solo no system).

Asignalos en Access → Roles / Usuarios.

Pasos

  1. Abrí Configuración → Jobs programados (/platform/settings/scheduled-jobs).
  2. Filtrá por Estado o Handler; buscá por nombre.
  3. Abrí una fila o Abrir para editar cron, zona horaria, parámetros y estado.
  4. Usá Ejecutar ahora para una corrida puntual.
  5. Exportá columnas visibles desde la toolbar de la tabla.