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.
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 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.csv' \
-H 'x-api-key: PROJECT_API_KEY' -o invoice-review.csvColonnes : 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 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.xlsx' \
-H 'x-api-key: PROJECT_API_KEY' -o invoice-review.xlsxPOST /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 -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.xlsxPolitique 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é.
