Logo PDFHQ

Documents

DocumentationDocuments et intelligence

API d'export CSV de facture

Téléchargez un CSV privé réservé à l'examen des champs de facture soutenus par des sources avec protection par formule de feuille de calcul et citations d'audit.

Clés API côté serveur Importations de stockage signées

Exporter une extraction de facture complétée#

Exécutez pdfhq.ai.extract en utilisant une citation HQTools acceptée et attendez une tâche réussie. GET /v1/ai/jobs/{job_id}/invoice.csv répond par un téléchargement texte/csv privé. Seul le même propriétaire/projet qui possède la tâche AI ​​peut la récupérer. Les travaux en échec, en attente ou non facturés ne peuvent pas être exportés.

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

Colonnes : field, value, source_citations, review_required. Les sept champs de facture sont présents, les valeurs manquantes sont vides et toutes les lignes sont marquées review_required=true. Les valeurs CSV qui pourraient être interprétées comme des formules de feuille de calcul sont échappées. Cache-Control est private, no-store ; ne publiez jamais les exports ni ne consignez le contenu des documents.

Classeurs d'examen de facture structurés#

GET /v1/ai/jobs/{job_id}/invoice.xlsx génère un fichier Excel privé avec l'en-tête de la facture, les éléments de ligne, les extraits de la source et les notes de rapprochement/révision. Le serveur valide les corrections de révision et de citation de la source et stocke les montants sous forme de texte pour conserver les décimales exactes et se défendre contre l'injection de formules dans une feuille de calcul. Aucun deuxième appel auprès du fournisseur ni réservation HQTools n'est effectué.

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 accepte 1 à 10 ID de tâche de facture distincts, possédés et complétés du même projet API. La demande est tout ou rien : une tâche expirée, étrangère, dupliquée ou invalide empêche l'exportation entière. Chaque facture est toujours facturée uniquement lorsque sa tâche IA d'origine a été traitée.

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

Politique d'examen avant importation#

La validation de format vérifie les dates ISO, les codes de devise en trois lettres majuscules, les totaux décimaux non négatifs et les références de citation liées à la révision. Elle peut rejeter les réclamations de numéro de facture ou numériques non prises en charge. Elle n'établit pas qu'une facture est authentique ou qu'un montant est légalement correct. Vérifiez par rapport au PDF original avant d'exporter vers la comptabilité, ERP ou les paiements.

L’export CSV est en lecture seule : il ne déclenche aucune nouvelle requête fournisseur ni frais de modèle IA. La tâche IA d’origine utilise un devis en crédits HQTools approuvé.

Logo PDFHQ

Outils PDF et intelligence documentaire. Préparez, comprenez et travaillez avec vos documents.

© 2026 PDFHQ. Tous droits réservés.