Logo PDFHQ

Documenti

DocumentazioneDocumenti e intelligence

API di esportazione CSV fatture

Scarica un CSV privato e di sola revisione dei campi delle fatture supportati dalla fonte con protezione della formula del foglio di calcolo e citazioni di controllo.

Chiavi API lato server Caricamenti di archiviazione firmati

Esporta un'estrazione di fattura completata#

Esegui pdfhq.ai.extract utilizzando un preventivo HQTools accettato e attendi un lavoro completato. GET /v1/ai/jobs/{job_id}/invoice.csv risponde con un download di testo/csv privato. Solo lo stesso proprietario/progetto che possiede il lavoro AI può recuperarlo. I lavori non riusciti, in sospeso o senza fatturazione non possono essere esportati.

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

Colonne: field, value, source_citations, review_required. Tutti e sette i campi della fattura sono presenti, i valori mancanti sono vuoti e tutte le righe sono contrassegnate review_required=true. I valori CSV che potrebbero essere interpretati come formule di foglio di calcolo sono sfuggiti. Cache-Control è private, no-store; non pubblicare mai esportazioni o registrare i contenuti dei documenti.

Cartelle di lavoro di revisione fattura strutturate#

GET /v1/ai/jobs/{job_id}/invoice.xlsx genera un file Excel privato con l'intestazione della fattura, le voci, gli estratti originali e le note di riconciliazione/revisione. Il server convalida la revisione della fonte e gli offset delle citazioni e memorizza gli importi come testo per preservare i decimali esatti e difendersi dall'inserimento di formule nel foglio di calcolo. Non viene effettuata alcuna chiamata al secondo fornitore o prenotazione HQTools.

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 accetta da 1 a 10 ID di lavoro fattura completati e posseduti distinti dallo stesso progetto API. La richiesta è tutto o niente: un lavoro scaduto, esterno, duplicato o non valido impedisce l'intera esportazione. Ogni fattura viene comunque addebitata solo quando il suo lavoro AI originale è stato elaborato.

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

Politica di revisione prima dell'importazione#

I controlli di convalida del formato verificano le date ISO, i codici valutari in maiuscolo a tre lettere, i totali decimali non negativi e i riferimenti di citazione vincolati alla revisione. Può rifiutare reclami numerici o di numero di fattura non supportati. Non stabilisce che una fattura sia autentica o che un importo sia l'importo legalmente corretto dovuto. Rivedi rispetto al PDF originale prima di esportare in contabilità, ERP o pagamenti.

L'esportazione CSV è di sola lettura: non crea un'altra richiesta al fornitore né ulteriori addebiti per il modello AI. L'attività AI originale utilizza un preventivo approvato in crediti HQTools.

Logo PDFHQ

Strumenti PDF e intelligenza documentale. Prepara, comprendi e lavora con i tuoi documenti.

© 2026 PDFHQ. Tutti i diritti riservati.