Exportando seus dados

Três formatos

O Ztract exporta os dados extraídos em três formatos. Escolha aquele que sua ferramenta seguinte lê nativamente.

JSON

A forma estruturada. O JSON preserva todo o formato do seu esquema — objetos aninhados, arrays de objetos, arrays de strings — exatamente como o motor devolveu. Use JSON quando:

• Você está canalizando os dados para outro sistema via script ou workflow.
• Sua ferramenta seguinte lê JSON nativamente (a maioria dos apps modernos lê).
• Você se importa com o aninhamento (partes de um contrato, condições de pagamento de um acordo com fornecedor, itens de linha com imposto por linha).

CSV

A forma plana. O CSV traz uma linha por documento para os campos escalares, e os itens de linha são emitidos em um CSV separado quando existem. Use CSV quando:

• Você está carregando em um banco de dados, ferramenta de BI ou qualquer coisa que espera tabelas planas.
• Você está trabalhando em ferramentas de linha de comando (awk / cut / csvkit).
• Você quer um formato que abre certinho em qualquer planilha sem precisar mexer em delimitador.

Campos aninhados ficam achatados em caminhos com ponto (por exemplo, parties_involved.party_1_name).

Excel

A forma de planilha. As exportações em Excel usam várias abas quando o seu esquema tem arrays — uma aba para os campos escalares do nível do documento, uma aba por array (itens de linha, transações etc.). Os cabeçalhos vêm legíveis. Use Excel quando:

• O destinatário é uma pessoa não técnica que vai abrir o arquivo diretamente.
• Você precisa combinar os dados extraídos com fórmulas antes de passar adiante.

De onde exportar

Abra um projeto, vá para a aba Dados extraídos e clique em Exportar. Escolha o formato, opcionalmente filtre por intervalo de data de extração e confirme. As exportações são por projeto — o arquivo contém todos os documentos extraídos daquele projeto que correspondem ao seu filtro de data.

Como as exportações são produzidas

As exportações rodam como jobs em segundo plano, não como downloads diretos. Depois que você clica em Exportar, o job aparece na aba Exportações do projeto com um destes três status:

• Na fila — esperando um worker pegar.
• Processando — o arquivo está sendo montado.
• Pronto — finalizado; clique para baixar.

O dashboard consulta a fila automaticamente, então você não precisa atualizar a página. Para projetos pequenos o arquivo costuma ficar pronto em segundos; para projetos com milhares de documentos pode levar alguns minutos. Você pode fechar o dashboard e voltar depois — o arquivo continua disponível até você apagar o projeto.

O que vai parar em cada formato

• JSON: um array de objetos de documento, cada um correspondendo ao esquema — objetos aninhados, arrays de objetos e arrays de strings ficam preservados como estão.
• CSV: um layout plano com uma linha por documento extraído (ou por página extraída no modo por página). Campos aninhados viram caminhos com ponto.
• Excel: uma pasta de trabalho com o mesmo formato plano do CSV, formatado para abertura direta.

Toda exportação reflete suas últimas edições — se você corrigiu um valor no visualizador lado a lado, a exportação usa automaticamente o seu valor corrigido (as correções ficam armazenadas como sobreposições em cima da extração original; nada reexecuta o motor).

Iterando entre revisão e exportação

Um ciclo comum:

1. Primeira passagem da extração (motor).
2. Confira por amostragem os campos marcados por confiança e corrija o que for necessário.
3. Rode uma exportação e use o arquivo.
4. Notou um valor que passou batido? Corrija. Exporte de novo. Sem custo — reexecuções do motor consomem páginas, mas novos jobs de exportação não.

Exportação por API

A exportação programática via HTTP API está no roadmap. Hoje, todas as exportações acontecem pelo dashboard. Mande um e-mail para [support@ztract.com](mailto:support@ztract.com?subject=API early access) se a falta de API estiver te travando e você quiser ser avisado assim que ela for lançada.