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

# Exportaciones

Las exportaciones crean archivos descargables a partir de los datos de Syntage. Úsalas cuando tu integración necesite un archivo que pueda almacenarse, compartirse, importarse a otro sistema o entregarse a un equipo de operaciones.

Crear una exportación inicia un procesamiento asíncrono y devuelve un recurso Export. La exportación mantiene un registro de los datos de origen solicitados, el formato de salida, el estado del procesamiento y el archivo generado.

## Cómo funcionan las exportaciones

1. Crea una exportación con la URI de colección y el formato de salida que necesites.
2. Almacena el ID de exportación devuelto.
3. Consulta la exportación hasta que su `status` sea `finished` o `failed`.
4. Descarga el archivo generado desde el recurso File referenciado por la exportación.

Las exportaciones son útiles para flujos de trabajo como reportes financieros, entregas de facturas, investigaciones de soporte al cliente, revisión de back-office y entrega programada de datos.

## Ver tus exportaciones

Consulta tus exportaciones en el [dashboard](https://app.syntage.com/settings/exports) o lístalas con [`GET /exports`](https://docs.syntage.com/api-reference/exports/list-all-exports). Ambas vías devuelven únicamente las exportaciones que tú creaste, no las creadas por otros usuarios de tu organización.

## Exportaciones de reportes en PDF

Además de exportaciones de colecciones en formato `csv`, `xlsx` o `json`, las exportaciones también pueden generar un documento PDF de un [reporte](https://docs.syntage.com/es/resources/insights/reports.md) de una entidad. Establece `format` en `pdf` y `uri` en `/entities/{entityId}/reports/{reportId}?exporting=true`; la exportación terminada referencia un archivo `report.insights.pdf`. El parámetro de consulta `exporting=true` es obligatorio y es el único parámetro de consulta soportado en URIs de reportes. Consulta [Reportes](https://docs.syntage.com/es/resources/insights/reports.md) para el flujo completo.

Para detalles de endpoints, consulta la [Referencia de API de Exportaciones](https://docs.syntage.com/api-reference/exports/export-data.md).

| Estado | Significado |
| - | - |
| `pending` | La exportación fue aceptada y está esperando ejecutarse. |
| `running` | Syntage está construyendo el archivo de exportación. |
| `finished` | El archivo de exportación está listo para descargarse. |
| `failed` | La exportación no pudo completarse. Crea una nueva exportación después de corregir la solicitud. |

> [!TIP]
>
> La respuesta de exportación referencia un recurso File cuando el archivo generado está listo. Usa los metadatos del archivo para inspeccionar el nombre, el tipo de medio y el tamaño antes de descargarlo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.