Planificadores de extracciones

Configura extracciones iniciales y recurrentes para las entidades que tu organización monitorea.

Los planificadores de extracciones automatizan la creación de extracciones. Úsalos para decidir qué información debe recuperar Syntage cuando una entidad se registra y qué información debe actualizarse de forma recurrente.

​

Tipos de planificadores

Planificador	Propósito
Primera vez	Se ejecuta cuando una entidad se crea o completa onboarding por primera vez
Recurrente	Se ejecuta periódicamente para entidades que coinciden con las etiquetas del planificador

Los planificadores de primera vez ayudan a que tu organización tenga los datos que necesita inmediatamente después del onboarding. Los planificadores recurrentes mantienen entidades seleccionadas actualizadas con el tiempo.

​

Revisa reglas de extracción inicial

1. Abre Planificadores de extracciones.
2. Edita el planificador llamado Primera vez.
3. Revisa las reglas configuradas.

Cada regla define el extractor y cualquier parámetro requerido, como periodo, tipo de factura o tipo de documento.

​

Cambia reglas de extracción inicial

1. Abre Planificadores de extracciones.
2. Edita Primera vez.
3. Agrega, edita o elimina reglas.
4. Haz clic en Actualizar para guardar el planificador.

Para deshabilitar las extracciones automáticas de primera vez, apaga Habilitar y guarda el planificador.

Si deshabilitas el planificador de primera vez, las entidades nuevas no tendrán datos disponibles automáticamente después del onboarding. Tu equipo tendrá que crear extracciones manualmente.

​

Crea un planificador recurrente

1. Abre Planificadores de extracciones.
2. Haz clic en Agregar nuevo.
3. Nombra el planificador.
4. Selecciona las etiquetas que identifican las entidades objetivo de este planificador.
5. Guarda el planificador.
6. Agrega reglas con el extractor, frecuencia, periodo y opciones específicas del extractor.
7. Habilita el planificador.
8. Haz clic en Actualizar.

Usa etiquetas con cuidado. Una etiqueta demasiado amplia puede hacer que el planificador se ejecute para más entidades de las esperadas.

​

Expresiones cron para reglas del planificador

Cada regla del planificador usa un campo cronExpression que controla cuándo se ejecuta. El campo acepta cualquier expresión cron válida, y también se admiten alias con nombre como @daily, @weekly y @monthly.

Ejemplos comunes:

Expresión	Se ejecuta
@hourly	Cada hora, en el minuto 0
@daily	Todos los días a la medianoche
@weekly	Cada domingo a la medianoche
@monthly	El primer día de cada mes a la medianoche
0 9 * * *	Todos los días a las 09:00
0 9 * * 1	Cada lunes a las 09:00
0 6 1 * *	El primer día de cada mes a las 06:00
0 */6 * * *	Cada 6 horas

Las expresiones se evalúan en UTC. Convierte desde tu hora local antes de guardar la regla.

​

Deshabilita un planificador recurrente

1. Abre Planificadores de extracciones.
2. Edita el planificador recurrente.
3. Apaga Habilitar.
4. Haz clic en Actualizar.

Regresa a la lista de planificadores y confirma que el estado cambió a deshabilitado.

​

Estima el uso mensual

El uso de extracciones recurrentes depende de cuántas entidades coinciden con el planificador, cuántas reglas tiene y con qué frecuencia se ejecutan.

Usa esta estimación antes de habilitar un planificador:

entidades coincidentes x ejecuciones mensuales totales

Por ejemplo, si 55 entidades coinciden con un planificador y se ejecuta 37 veces en un mes, el planificador puede crear aproximadamente 2,035 solicitudes de extracción durante ese mes.

El uso real depende de las reglas configuradas, disponibilidad de fuentes de datos, límites del plan y si las extracciones terminan correctamente.

Cuando habilitas un planificador recurrente, Syntage envía un correo de activación que resume las reglas configuradas y las extracciones que el planificador probablemente generará.