> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/es/using-syntage/extractions). Ú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](https://app.syntage.com/settings/extraction-schedulers).
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](https://app.syntage.com/settings/extraction-schedulers).
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.

<Warning>
  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.
</Warning>

## Crea un planificador recurrente

1. Abre [Planificadores de extracciones](https://app.syntage.com/settings/extraction-schedulers).
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](https://app.syntage.com/settings/extraction-schedulers).
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:

```text theme={null}
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.