Logo PDFHQ

Documentos

DocumentaçãoDocumentos e inteligência

API de exportação de CSV de fatura

Baixe um CSV privado, somente para revisão, de campos de faturas com base na fonte, com proteção de fórmula de planilha e citações de auditoria.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Exporte uma extração de fatura concluída#

Execute pdfhq.ai.extract usando uma cotação HQTools aceita e aguarde um trabalho bem-sucedido. GET /v1/ai/jobs/{job_id}/invoice.csv responde com um download de texto/csv privado. Somente o mesmo proprietário/projeto que possui o trabalho de IA pode recuperá-lo. Trabalhos com falha, pendentes ou sem fatura não podem ser exportados.

cURL
curl 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.csv' \
  -H 'x-api-key: PROJECT_API_KEY' -o invoice-review.csv

Colunas: field, value, source_citations, review_required. Todos os sete campos de fatura estão presentes, valores ausentes ficam em branco e todas as linhas são marcadas review_required=true. Valores CSV que podem ser interpretados como fórmulas de planilha são escapados. Cache-Control é private, no-store; nunca publique exportações ou registre conteúdo de documentos.

Pastas de trabalho de revisão de fatura estruturada#

GET /v1/ai/jobs/{job_id}/invoice.xlsx gera um arquivo Excel privado com o cabeçalho da fatura, itens de linha, trechos de origem e notas de reconciliação/revisão. O servidor valida a revisão da fonte e as compensações de citação e armazena os valores como texto para preservar os decimais exatos e proteger contra a injeção de fórmulas de planilhas. Nenhuma segunda chamada de provedor ou reserva HQTools é feita.

cURL
curl 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.xlsx' \
  -H 'x-api-key: PROJECT_API_KEY' -o invoice-review.xlsx

POST /v1/ai/jobs/invoices/batch.xlsx aceita 1 a 10 IDs de trabalho de fatura distintos, próprios e concluídos do mesmo projeto de API. A solicitação é tudo ou nada: um trabalho expirado, estrangeiro, duplicado ou inválido impede toda a exportação. Cada fatura ainda é cobrada apenas quando seu trabalho de IA original foi processado.

cURL
curl -X POST 'https://api.pdfhq.io/v1/ai/jobs/invoices/batch.xlsx' \
  -H 'x-api-key: PROJECT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"job_ids":["FIRST_JOB_UUID","SECOND_JOB_UUID"]}' \
  -o invoice-batch-review.xlsx

Política de revisão antes da importação#

A validação de formato verifica datas ISO, códigos de moeda em maiúsculas com três letras, totais decimais não negativos e referências de citação vinculadas a revisão. Pode rejeitar reivindicações de número de fatura ou numéricas não suportadas. Não estabelece que uma fatura é genuína ou que um valor é o valor legalmente correto devido. Revise em relação ao PDF original antes de exportar para contabilidade, ERP ou pagamentos.

A exportação CSV é só de leitura: não cria outro pedido ao fornecedor nem um novo débito do modelo de IA. A tarefa original de IA utiliza um orçamento de créditos HQTools aprovado.

Logo PDFHQ

Ferramentas PDF e inteligência de documentos. Prepare, compreenda e trabalhe com seus documentos.

© 2026 PDFHQ. Todos os direitos reservados.