Exportaciones programadas

Las exportaciones programadas te permiten configurar una exportación una sola vez y que Mosce ERP la ejecute automáticamente cada cierto tiempo. El archivo generado queda guardado en tu almacenamiento privado, recibes una notificación cuando está listo, y los suscriptores de webhooks reciben el evento de exportación completada igual que con una exportación manual.

Es ideal para reportes operativos repetitivos: el listado de facturas pendientes cada lunes, el corte de cartera el día 1 de cada mes, el inventario diario del día anterior, etc. No tienes que recordar entrar a generar la exportación - el archivo te llega solo.

Antes de empezar

• Necesitas un plan Profesional o Empresarial. El plan Inicial y el plan Gratis no incluyen exportaciones programadas.
• Necesitas el permiso data-tools:read para acceder al Centro de datos.
• Necesitas el permiso de exportación de la entidad que quieres programar (por ejemplo, invoices:export para facturas, clients:export para clientes). Si no tienes ese permiso, podrás ver tus programaciones existentes pero no crear nuevas.

Cadencias disponibles por plan

Mosce ERP ofrece tres cadencias predefinidas. Las opciones que puedes elegir dependen de tu plan:

Todos los horarios son hora local de República Dominicana (UTC−4). No es posible elegir otras horas ni otros días - el conjunto de cadencias es fijo y se mantiene corto a propósito para evitar configuraciones difíciles de auditar.

Límite de programaciones activas por plan

El límite cuenta solo las programaciones activas (con cadencia configurada). Una configuración guardada sin cadencia no consume cupo - solo cuenta cuando la programas. Tu administrador puede ajustar este límite en casos especiales.

Cómo programar una exportación

Las exportaciones programadas se crean a partir de una configuración guardada. El flujo es el mismo que cuando guardas una configuración para reutilizarla manualmente, pero ahora eliges una cadencia adicional.

1. Ve a Herramientas → Centro de datos → Exportar datos.
2. Configura la entidad, los campos y los filtros que necesitas, igual que para una exportación normal.
3. Haz clic en Guardar configuración.
4. En el diálogo, además del nombre y el formato (CSV o XLSX), encontrarás la sección Programación:
   • Si eliges No programar, la configuración se guarda solo para reutilización manual y no consume cupo de programaciones activas.
   • Si eliges una cadencia (por ejemplo, Cada lunes a las 8:00), Mosce ERP la programa de inmediato. La próxima ejecución ocurrirá en el siguiente turno de esa cadencia.
5. Haz clic en Guardar. Si tu cuenta ya alcanzó el límite de programaciones activas, verás un mensaje pidiendo que pauses una existente antes de crear otra; el resto de la configuración se mantiene en el formulario para que puedas ajustarla.

También puedes activar la programación más tarde editando una configuración guardada existente desde el panel Mis configuraciones del Constructor de exportación.

La página de Exportaciones programadas

Una vez tienes al menos una programación activa, accede a Herramientas → Centro de datos → Exportaciones programadas. La página muestra todas tus programaciones activas con:

• El nombre de la configuración guardada.
• La entidad que se exporta.
• La cadencia y el formato (CSV o XLSX) en chips visuales.
• La última ejecución completada (o Nunca ejecutado si todavía no ha corrido la primera vez).
• La próxima ejecución prevista.

Acciones disponibles por programación

Dónde queda el archivo

Cada ejecución programada produce un archivo nuevo (no se sobrescribe el anterior) y queda guardado en tu almacenamiento privado durante 30 días. Pasado ese plazo, el archivo se elimina automáticamente para evitar que tu almacenamiento crezca sin control. La próxima ejecución programada generará un archivo nuevo.

Cada ejecución también queda registrada en el Historial de trabajos con el origen marcado como Programada, igual que una exportación manual del Centro de datos. Desde el detalle del trabajo puedes:

• Descargar el archivo (mientras esté dentro del plazo de 30 días).
• Volver a generar el enlace de descarga si el anterior expiró (los enlaces directos duran 60 minutos por seguridad).
• Ver cuántas filas se procesaron.

Notificaciones cuando termina una ejecución

Cuando una ejecución programada termina, recibes la misma notificación instantánea que cuando ejecutas una exportación manual: una tarjeta aparece en la esquina superior derecha de la aplicación con un enlace directo al archivo. No se envía correo electrónico - las exportaciones programadas son predecibles (tú elegiste la cadencia), por lo que un correo en cada ejecución sería ruido.

Si tu integración necesita reaccionar automáticamente a cada ejecución (por ejemplo, copiar el archivo a un Google Drive corporativo o avisar a un canal de Slack), suscríbete al evento de exportación completada desde la sección de webhooks. Las exportaciones programadas disparan ese evento exactamente igual que las manuales - no necesitas configurar nada distinto.

Si pasas a un plan inferior con programaciones activas

Si pasas del plan Empresarial al plan Profesional y tenías más programaciones activas que el límite del plan nuevo (por ejemplo, 7 programaciones activas y bajas a un plan que permite 5), tus programaciones existentes siguen ejecutándose - no se pausan automáticamente. Lo que ocurre es que no podrás crear nuevas programaciones hasta que el total quede por debajo del límite.

La página de Exportaciones programadas mostrará un aviso visible recordándote la situación, con la cifra exacta. Para volver a poder crear nuevas, pausa o elimina suficientes programaciones para quedar dentro del límite. La pausa solo detiene las ejecuciones automáticas - la configuración guardada se conserva, así que puedes recuperarla más adelante si vuelves al plan superior.

Si una exportación programada no produce filas

Si en el momento de la ejecución no hay registros que cumplan los filtros de la configuración (por ejemplo, programaste el listado de facturas vencidas y esa semana no hubo ninguna), Mosce ERP igualmente registra la ejecución en el Historial con 0 filas y archivo CSV vacío. Esto te permite confirmar que la programación está funcionando, no que se cayó silenciosamente.

Cómo eliminar definitivamente una programación

La acción Pausar programación detiene las ejecuciones pero conserva la configuración. Si quieres eliminar la configuración por completo (no solo la cadencia), ve al panel Mis configuraciones del Constructor de exportación y elimínala desde ahí. Eliminar la configuración detiene la programación inmediatamente.

Resumen de buenas prácticas

• Pon nombres descriptivos a las configuraciones que vas a programar (por ejemplo, "Facturas vencidas - corte semanal") para reconocerlas fácilmente en la página de Exportaciones programadas.
• Empieza con cadencias amplias (semanal o mensual) y baja a diario solo cuando confirmes que el archivo se consume rápido. Una programación diaria que nadie revisa solo llena tu almacenamiento.
• Antes de programar una configuración, ejecútala manualmente al menos una vez y revisa el archivo. Es más fácil ajustar filtros antes de que empiece la cadencia.
• Si necesitas que un sistema externo procese cada archivo automáticamente, suscríbelo al evento de exportación completada desde webhooks en lugar de descargarlo manualmente cada turno.