Programación de tareas en segundo plano
Este es el paso de configuración más importante en REDA, y el más fácil de pasar por alto. Una organización REDA recién creada genera contratos de arrendamiento perfectamente bien, y luego nunca los factura, porque la facturación recurrente, los recargos por mora, las cuotas por mes a mes, la inflación, los cronogramas de renta lineal, las instantáneas y las inspecciones recurrentes son todas tareas en segundo plano, y REDA se entrega sin ninguna de ellas programada. Programarlas desde la Consola de administración es una tarea obligatoria para la puesta en producción. Este artículo te muestra qué se ejecuta de fábrica, el catálogo completo de tareas, cómo programarlas y cancelarlas, cuál es el tamaño de sus lotes, y cómo diagnosticar la clásica falla silenciosa en la que "las facturas simplemente nunca se generaron."
Acceso que necesitarás. La consola requiere el conjunto de permisos REDA - Master Data - Admin — el único que otorga acceso a ella. Cualquier otra persona verá "You do not have permission to perform this action in the REDA Admin Console." Pide a tu administrador que te asigne ese conjunto.
Lo que ya viene ejecutándose, y lo que debes programar tú
Dos cosas se ejecutan en una organización REDA recién creada sin que hagas nada. Ambas son programaciones diarias de mantenimiento, y ninguna aparece en el catálogo de tareas de la consola:
| Ya se ejecuta | Qué hace | Dónde está documentado |
|---|---|---|
| Contabilización automática de calendarios de pago | Marca como contabilizados, a diario, los calendarios de pago vencidos | Calendarios de pago |
| Generación de excepciones de franjas de calendario | Crea, a diario, las próximas instancias de excepciones de franjas de calendario recurrentes | Excepciones de franjas horarias |
Todo lo demás — las 13 tareas de la siguiente sección — espera a que las programes. La cadencia de cada una es una decisión del administrador, no algo fijado en la instalación.
El catálogo de 13 tareas
Estas son las tareas que programas en la consola. Los horarios predeterminados a continuación escalonan el trabajo a lo largo de la noche; la última columna indica qué deja de suceder en silencio si dejas una tarea sin programar.
| N.° | Tarea | Qué hace | Programación predeterminada | Si queda sin programar |
|---|---|---|---|---|
| 1 | Inflation Adjustment — Property | Aplica las reglas de inflación vencidas a las configuraciones de renta de propiedades (reajustándolas) | Diario a las 12:00 a. m. | La renta de las propiedades nunca se indexa por inflación |
| 2 | Inflation Adjustment — Leases | Aplica las reglas de inflación vencidas a los contratos de arrendamiento activos, reajustando sus cargos | Diario a las 12:15 a. m. | Las rentas del arrendamiento nunca se ajustan; las fechas de vencimiento se acumulan (se autocorrige al programarla) |
| 3 | Recurring Charges — Monthly | Genera las facturas del período para los cargos mensuales que vencen hoy | Diario a la 1:00 a. m. | No se generan facturas de renta recurrente — la consecuencia más importante |
| 4 | Recurring Charges — Daily | Lo mismo, para los cargos de ciclo diario | Diario a la 1:15 a. m. | Los cargos de ciclo diario nunca se facturan |
| 5 | Recurring Charges — Weekly | Lo mismo, para los cargos de ciclo semanal | Diario a la 1:30 a. m. | Los cargos de ciclo semanal nunca se facturan |
| 6 | Delayed Move-Out Recurring Charges | Factura un período adicional a los inquilinos que superaron su fecha de desocupación programada sin que se haya registrado una desocupación real | Diario a las 3:00 a. m. | Los inquilinos en holdover dejan de facturarse |
| 7 | Straight-Line Schedule Calculation | Construye los cronogramas de renta lineal para los contratos de arrendamiento marcados como pendientes | Diario a las 4:30 a. m. | Los contratos marcados conservan cronogramas "pendientes" para siempre (la acción por contrato individual sigue funcionando) |
| 8 | Recurring Inspections | Clona la próxima ocurrencia de las inspecciones recurrentes que vencen hoy | Diario a las 5:00 a. m. | Las inspecciones recurrentes dejan de regenerarse |
| 9 | Reconciliation Snapshots | Construye las instantáneas de facturación y ocupación del mes anterior para las propiedades marcadas | Día 1 del mes, 6:00 a. m. | No se generan instantáneas mensuales (la acción por propiedad individual sigue funcionando) |
| 10 | MTM Fees — Per Day | Factura las cuotas por mes a mes por día en contratos de arrendamiento vencidos | Diario a las 10:00 a. m. | Las cuotas por mes a mes por día nunca se facturan |
| 11 | MTM Fees — Monthly | Factura las cuotas mensuales por mes a mes | Diario a las 10:15 a. m. | Las cuotas mensuales por mes a mes nunca se facturan |
| 12 | Late Fees — Per Day | Crea facturas de recargo por mora por día sobre las facturas vencidas | Diario a las 10:00 p. m. | Los recargos por mora por día nunca se cobran |
| 13 | Late Fees — Monthly | Crea facturas hijas de recargo por mora mensual sobre las facturas vencidas | Diario a las 10:15 p. m. | Los recargos por mora mensuales nunca se cobran |
Algunos anclajes que vale la pena recordar: los cargos recurrentes se ejecutan a la 1:00 a. m., los recargos por mora a las 10:00 p. m., y la única tarea que por defecto se ejecuta el día 1 del mes es la de las instantáneas (6:00 a. m.). Ten en cuenta que las dos tareas de cuotas mensuales se ejecutan por defecto a diario: 10:15 a. m. y 10:15 p. m., quince minutos después de sus equivalentes por día. Es deliberado: la cuota es mensual (se cobra una vez por factura), pero la tarea debe ejecutarse cada día para detectar las facturas a medida que se vuelven elegibles. Si las programas mensualmente, la mayoría de las cuotas nunca se cobrarán. Las facturas de recargo por mora y de mes a mes se crean como registros hijos vinculados a la factura vencida o al registro padre, y es seguro ejecutarlas a diario — REDA rastrea lo que ya cobró y no las duplica.
Programar una tarea
Cancelar una tarea
Para detener una tarea programada, cancélala desde la misma pestaña. REDA te pide que confirmes con "Abort this scheduled job? Future runs will stop immediately. In-flight executions complete normally." — así que una ejecución ya en curso termina con normalidad, y solo se detienen las ejecuciones futuras. Cancelar está deliberadamente restringido al catálogo propio de tareas de REDA; no puedes cancelar tareas de plataforma que no le pertenecen desde aquí.
Tamaño de los lotes
Varias tareas procesan registros por lotes, y el tamaño del lote es una configuración. Hay seis configuraciones de tamaño de lote, todas fijadas en 50 de forma predeterminada: cargos recurrentes, desocupación demorada, recargos por mora mensuales, recargos por mora por día, cuotas mensuales por mes a mes y cuotas por mes a mes por día. Se encuentran en Configuración global de la aplicación, y cada tarea lee su configuración al momento de ejecutarse — así que un cambio tiene efecto en la siguiente ejecución sin necesidad de volver a programarla.
Dos tareas son fijas y no configurables: ambas tareas de Inflation Adjustment procesan un registro a la vez por diseño. No tienen una configuración de tamaño, así que no intentes acelerarlas con una. Solo necesitarás revisar los tamaños de lote si una ejecución es lenta o choca con los límites de la plataforma.
Horarios, zonas horarias y días omitidos
Aquí importan dos hechos operativos, y ambos pueden sorprender a un administrador nuevo.
Las tareas se ejecutan en la zona horaria del usuario que las programó. Si programas la tarea de cargos recurrentes de la 1:00 a. m. desde un usuario cuya zona horaria difiere de tu región operativa, se ejecutará a la 1:00 a. m. de esa zona horaria. Prográmala desde un usuario configurado con la zona horaria operativa de la organización, para que los horarios signifiquen lo que esperas.
Cada lote registra un log de ejecución con los conteos de éxitos y fallas, y las fallas envían un correo a tus administradores. Monitorea las ejecuciones en Registros asincrónicos de REDA.
La lista de verificación para la puesta en producción
- Inicia sesión como un usuario configurado con la zona horaria operativa de la organización, con REDA - Master Data - Admin.
- Abre la Admin Console → Scheduled Jobs y programa las 13 tareas — con los valores predeterminados, o desplazadas hacia tus horas de menor actividad, manteniendo su orden relativo.
- Confirma en la lista de Scheduled Jobs de Salesforce que ahora hay 13 entradas con prefijo REDA junto a las 2 programaciones de mantenimiento que vinieron ejecutándose de fábrica.
- A la mañana siguiente, revisa los Registros asincrónicos de REDA de las primeras ejecuciones y confirma que existen las facturas esperadas.
- Solo revisa los tamaños de lote si una ejecución es lenta o choca con los límites (consulta Configuración global de la aplicación).
Los valores predeterminados están escalonados para que las dependencias se cumplan: la inflación reajusta un contrato de arrendamiento antes de que la facturación recurrente de la 1:00 a. m. lo facture. Cuando desplaces los horarios, mantén la inflación antes de los cargos recurrentes.
Ejemplo resuelto: la puesta en producción de Meridian
El día de la puesta en producción, el administrador de Meridian Properties programa las 13 tareas con sus horarios predeterminados. Tres contratos de arrendamiento tienen cada uno una renta mensual de 1,200.00, todos con vencimiento de facturación el día 1. A la mañana siguiente, la ejecución de cargos recurrentes de la 1:00 a. m. creó tres facturas de 1,200.00; la ejecución de recargos por mora de las 10:00 p. m. no creó nada, porque nada estaba vencido.
Compáralo con la misma organización donde las tareas nunca se programaron: los mismos tres contratos, el mismo día 1 del mes — y ninguna factura en ninguna parte, y ningún error en ninguna parte. El único síntoma es la ausencia. Esa ausencia, en una organización recién creada, casi nunca es un error del sistema; es una tarea sin programar.
Qué sigue
- Lista de verificación para la puesta en producción — este paso de programación es su núcleo.
- Registros asincrónicos de REDA — monitorea lo que hizo cada tarea y detecta fallas.
- Configuración global de la aplicación — dónde viven las seis configuraciones de tamaño de lote.
- Cómo funciona la facturación recurrente — qué genera la tarea de cargos recurrentes, y la recuperación tras un día omitido.
- Recargos por mora y Ajustes por inflación — las otras automatizaciones que impulsan estas tareas.
Preguntas frecuentes
Las tareas de cargos recurrentes no están programadas. REDA se entrega sin ninguna tarea de facturación programada, así que esto es lo esperado hasta que actúes. Programa las tareas 3 a 5 en la consola y revisa los Registros asincrónicos de REDA después de la siguiente ejecución.
No. REDA mantiene una única instancia de cada tarea; volver a programarla reemplaza la programación existente en lugar de agregar una segunda.
Todavía se está ejecutando una corrida de esa tarea. Espera a que termine y vuelve a intentarlo.
Las tareas se ejecutan en la zona horaria del usuario que las programó. Vuelve a programarlas desde un usuario configurado con tu zona horaria operativa.
Los recargos por mora, las cuotas por mes a mes y los ajustes por inflación se ponen al día automáticamente en su siguiente ejecución ("vencido en o antes de hoy"). Los cargos recurrentes no lo hacen — coinciden exactamente con la fecha de hoy, así que los días omitidos necesitan atención manual (consulta Cómo funciona la facturación recurrente).
Cancelar está deliberadamente restringido al catálogo propio de tareas de REDA, para que no puedas detener accidentalmente una tarea de plataforma que no le pertenece.
¿Te resultó útil?