> ## 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.

# Extracciones

> Comprende cómo Syntage recupera y actualiza datos para una entidad.

Una extracción es el proceso que Syntage usa para recuperar o actualizar información desde una fuente de datos para una entidad. Las extracciones son la forma en que Syntage obtiene registros del SAT, facturas, declaraciones, inscripciones RPC, garantías RUG, reportes de Buró de Crédito, reportes BIL y otra información respaldada por fuentes de datos.

Syntage no está conectado a todas las fuentes de datos en tiempo real. Los datos aparecen o se actualizan después de que una extracción se ejecuta y termina.

## Cómo inician las extracciones

Las extracciones pueden iniciar de varias formas:

| Cómo inicia                  | Cuándo usarlo                                                                                                                |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Reglas de extracción inicial | Recuperar automáticamente los datos estándar que tu organización necesita después de crear o hacer onboarding de una entidad |
| Actualización manual         | Actualizar una entidad específica cuando tu equipo necesita información más reciente                                         |
| Planificador recurrente      | Mantener entidades seleccionadas actualizadas en una periodicidad usando etiquetas                                           |
| Solicitud de API             | Iniciar una extracción desde tu propia integración                                                                           |

Para configuración desde el dashboard, lee [Planificadores de extracciones](/es/using-syntage/dashboard/extraction-scheduler). Para ejemplos para desarrolladores, lee [Ejemplos de solicitudes de extracción](/es/developers/extraction-request-examples).

## Estado de extracción

Una extracción pasa por estados mientras Syntage encola, ejecuta y termina el trabajo. En el dashboard, revisa el estado para entender si Syntage todavía está recuperando datos, esperando un requisito previo, terminó o no pudo completar la extracción.

`Waiting` significa que Syntage todavía no puede ejecutar la extracción porque algo sigue bloqueándola, como información faltante de la entidad, autorización, una credencial no disponible o una dependencia interna. Si una extracción falla o queda pendiente más tiempo del esperado, revisa si la fuente de datos está disponible, si la credencial o autorización de la entidad sigue vigente y si la extracción llegó a un límite de la fuente de datos.

Para los valores exactos de estado en la API, el comportamiento de facturación para extracciones detenidas o canceladas y los códigos de error de extracción, consulta la [Guía de recursos de extracciones](/es/resources/core/extractions).

## Extracciones, reportes y datos

Las extracciones recuperan información fuente. Después, Syntage usa esa información en:

* **Reportes**, donde tu equipo revisa indicadores procesados, resúmenes, gráficas y análisis
* **Datos**, donde tu equipo revisa registros fuente, datos estructurados sin procesar y archivos originales
* **Exportaciones**, donde tu equipo descarga información que Syntage ya recuperó

Las exportaciones no crean extracciones nuevas. Empaquetan datos existentes de Syntage en archivos descargables.

## Uso y facturación

Las extracciones pueden contar para el uso del plan. Una entidad procesada es un RFC que tiene al menos una extracción durante el mes actual, y los conteos de extracciones también pueden estar limitados por tu plan.

Puedes revisar el uso en [Plan y facturación](https://app.syntage.com/settings/billing) y el historial de extracciones en [Extracciones](https://app.syntage.com/extractions).

## Referencia técnica

Los desarrolladores pueden crear y monitorear extracciones mediante la API. Usa la [Guía de recursos de extracciones](/es/resources/core/extractions) para el comportamiento del recurso y [Crear una extracción](/api-reference/extractions/create-an-extraction) para detalles del endpoint.