Exportar tus datos

Tres formatos

Ztract exporta los datos extraídos en tres formatos. Elige el que tu herramienta destino lea de forma nativa.

JSON

La forma estructurada. JSON conserva la forma completa de tu esquema — objetos anidados, arrays de objetos, arrays de cadenas — tal como los devolvió el motor. Usa JSON cuando:

• Estés canalizando datos hacia otro sistema mediante un script o un flujo de trabajo.
• Tu herramienta destino lea JSON de forma nativa (la mayoría de las apps modernas lo hacen).
• Te importe la anidación (partes en un contrato, condiciones de pago en un acuerdo con proveedor, líneas con impuesto por línea).

CSV

La forma plana. CSV es una fila por documento para los campos escalares, con las líneas emitidas como un CSV aparte cuando existen. Usa CSV cuando:

• Estés cargando en una base de datos, una herramienta BI o cualquier cosa que espere tablas planas.
• Trabajes con herramientas de línea de comandos (awk / cut / csvkit).
• Quieras un formato que se abra correctamente en cualquier hoja de cálculo sin enredarte con delimitadores.

Los campos anidados se aplanan con rutas con puntos (por ejemplo, parties_involved.party_1_name).

Excel

La forma hoja de cálculo. Las exportaciones a Excel usan varias hojas cuando tu esquema tiene arrays — una hoja para los campos escalares a nivel de documento, una hoja por cada array (líneas, transacciones, etc.). Los encabezados son legibles. Usa Excel cuando:

• El destinatario es una persona no técnica que abrirá el archivo directamente.
• Necesitas combinar los datos extraídos con fórmulas antes de enviarlos a otra persona.

Desde dónde exportar

Abre un proyecto, cambia a la pestaña Datos extraídos y haz clic en Exportar. Elige el formato, opcionalmente acota por rango de fechas de extracción y confirma. Las exportaciones tienen el alcance del proyecto — el archivo contiene todos los documentos extraídos de ese proyecto que coinciden con tu filtro de fechas.

Cómo se generan las exportaciones

Las exportaciones se ejecutan como trabajos en segundo plano, no como descargas directas. Después de hacer clic en Exportar, el trabajo aparece en la pestaña Exportaciones del proyecto con uno de tres estados:

• En cola — esperando a que un worker lo recoja.
• Procesando — el archivo se está construyendo.
• Listo — terminado; haz clic para descargar.

El dashboard consulta la cola automáticamente, así que no tienes que refrescar. Para proyectos pequeños el archivo suele estar listo en segundos; para proyectos con miles de documentos puede tardar unos minutos. Puedes cerrar el dashboard y volver más tarde — el archivo permanece disponible hasta que elimines el proyecto.

Qué acaba en cada formato

• JSON: un array de objetos de documento, cada uno coincidiendo con el esquema — objetos anidados, arrays de objetos y arrays de cadenas se conservan tal cual.
• CSV: una disposición plana con una fila por documento extraído (o por página extraída en modo por página). Los campos anidados son rutas con puntos.
• Excel: un libro con la misma forma plana que CSV, formateado para abrirlo directamente.

Cada exportación refleja tus últimas ediciones — si corregiste un valor en el visor en paralelo, la exportación usa tu valor corregido automáticamente (las correcciones se guardan como capas encima de la extracción original; nada vuelve a ejecutar el motor).

Iterar entre revisión y exportación

Un bucle habitual:

1. Primera pasada de extracción (motor).
2. Revisa por encima los campos marcados por confianza, corrige lo necesario.
3. Lanza una exportación, usa el archivo.
4. ¿Te das cuenta de que se te escapó un valor? Corrígelo. Reexporta. Gratis — las reejecuciones del motor consumen páginas, pero los nuevos trabajos de exportación no.

Exportación por API

La exportación programática vía HTTP API está en la hoja de ruta. Hoy, todas las exportaciones se realizan a través del dashboard. Escribe a [support@ztract.com](mailto:support@ztract.com?subject=API early access) si el acceso por API te bloquea y quieres que te avisemos en cuanto se publique.