Saltar al contenido

Tareas programadas (Crontab)

Revisa y configura tareas automáticas del sistema (cortes, avisos, sync).

6 min de lectura

Configura las tareas diarias que dispara php artisan schedule:run (avisos, facturas, cortes, backups, etc.).

Antes de empezar:

  • Permiso crontab_access.
  • El servidor debe ejecutar el scheduler de Laravel cada minuto (cron del SO o Task Scheduler de Windows).
  • Sin scheduler del SO, guardar horarios en esta pantalla no ejecuta nada.

1. Abrir el módulo

  1. Menú Ajustes → Sistema → Crontab.
  2. Entras a /crontab.

Vista: Tareas programadas (Crontab)

Verás:

  • Aviso Crontab conectado al scheduler y lista de tareas activas cableadas.
  • KPIs: Notificaciones activas, Procesos activos, Próxima ejecución, Tareas totales.
  • Paneles Notificaciones y Facturación & Corte.
  • Cronograma del día (tareas activas ordenadas por hora).

2. Entender cada fila

Cada tarea muestra:

  • Nombre y descripción.
  • Selector de hora (H:i).
  • Botón play (probar).
  • Switch activo/inactivo.

Tareas típicas cableadas al sistema (nombres pueden variar según tu BD):

Área Ejemplos de task_name Efecto
Facturación Crear facturas y aplicar mora Genera ciclo + mora
Facturación Recordatorio de pago (1)(2)(3) SMS/avisos por slot
Facturación Aviso en pantalla (portal) Aviso en portal cliente
Facturación Corte de servicio por mora Suspende por deuda
Facturación Sincronizar CxC (facturas vencidas) Sync de vencidas
Otras Backup, cierre chats WhatsApp idle, auto-pay portal Según task_key

3. Configurar notificaciones

  1. Panel Notificaciones.
  2. Para cada tarea: define hora y switch.
  3. Guardar (botón del panel).
  4. Mensaje de éxito: configuración de notificaciones actualizada.

4. Configurar facturación y corte

  1. Panel Facturación & Corte.
  2. Ajusta horas sin solapar procesos pesados (ej. facturar temprano, corte al mediodía).
  3. Activa solo lo que la operación use.
  4. Guardar.

Importante: Evita el mismo minuto para crear facturas y corte si el volumen es alto; deja margen.

5. Probar una tarea

  1. La tarea debe estar activa y guardada.
  2. Pulsa el botón play.
  3. Si no está activa: el sistema pide activarla y guardar primero.
  4. Si no tiene comando Artisan asociado, verás aviso de que aún no está cableada.

6. Revisar el cronograma

Abajo, Cronograma del día agrupa por hora con badge Notif. / Fact. / Mixto. Tras guardar, confirma que la Próxima ejecución del KPI tiene sentido.

7. Checklist

  1. Scheduler del servidor corriendo (schedule:run)
  2. Tareas necesarias activas con hora correcta
  3. Ambos paneles Guardar aplicados
  4. Prueba play en una tarea no crítica
  5. Cronograma del día coherente (sin choques graves)