Factuur CSV-export-API
Download een privé, alleen-voor-beoordeling CSV van brongestuurde factuutvelden met bescherming van spreadsheetformules en auditreferenties.
Een voltooide factuurextractie exporteren#
Voer pdfhq.ai.extract uit met een geaccepteerd HQTools-citaat en wacht tot de taak is voltooid. GET /v1/ai/jobs/{job_id}/invoice.csv reageert met een privétekst/csv-download. Alleen dezelfde eigenaar/hetzelfde project dat eigenaar is van de AI-taak kan deze ophalen. Mislukte, lopende of niet-gefactureerde opdrachten kunnen niet worden geëxporteerd.
curl 'https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/invoice.csv' \
-H 'x-api-key: PROJECT_API_KEY' -o invoice-review.csvKolommen: field, value, source_citations, review_required. Alle zeven factuurvelden zijn aanwezig, ontbrekende waarden zijn leeg en alle rijen zijn gemarkeerd review_required=true. CSV-waarden die als spreadsheetformules kunnen worden geïnterpreteerd, zijn ontsnapt. Cache-Control is private, no-store; publiceer nooit exports of log documentinhoud.
Gestructureerde werkboeken voor factuurbeoordeling#
GET /v1/ai/jobs/{job_id}/invoice.xlsx genereert een privé Excel-bestand met de factuurkop, regelitems, bronuittreksels en afstemmings-/beoordelingsnotities. De server valideert de bronrevisie en citatie-offsets en slaat bedragen op als tekst om exacte decimalen te behouden en te beschermen tegen injectie van spreadsheetformules. Er wordt geen tweede provideroproep of HQTools-reservering gemaakt.
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 accepteert 1 tot 10 verschillende eigenaar, voltooide factuurbaantje-ID's van hetzelfde API-project. Het verzoek is alles-of-niets: een verlopen, vreemd, dubbel of ongeldig baantje voorkomt de volledige export. Elke factuur wordt nog steeds alleen in rekening gebracht wanneer het originele AI-baantje werd verwerkt.
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.xlsxBeleid voor beoordeling vóór import#
Formaatvalidatie controleert ISO-datums, drielettercodes voor valuta in hoofdletters, niet-negatieve decimale totalen en citatierefenties gebonden aan revisies. Het kan niet-ondersteunde numerieke of factuurnummerclaims afwijzen. Het stelt niet vast dat een factuur authentiek is of dat een bedrag het juridisch juiste verschuldigde bedrag is. Controleer tegen de originele PDF voordat u naar boekhoudkundige, ERP- of betalingssystemen exporteert.
CSV-export is alleen-lezen: dit veroorzaakt geen extra aanvraag aan de aanbieder en geen aanvullende AI-modelkosten. De oorspronkelijke AI-taak gebruikt een goedgekeurde HQTools-tegoedofferte.
