Logo PDFHQ

Dokumenty

DokumentacjaDokumenty i informacje wywiadowcze

API eksportu faktur w formacie CSV

Pobierz prywatny plik CSV przeznaczony wyłącznie do przeglądu, zawierający pola faktury oparte na źródle, z ochroną formuł arkusza kalkulacyjnego i cytatami z audytu.

Klucze API po stronie serwera Podpisane przesyłanie danych do magazynu

Eksportuj ukończoną ekstrakcję faktury#

Uruchom plik pdfhq.ai.extract, korzystając z zaakceptowanej oferty HQTools i poczekaj na pomyślne zakończenie zadania. POBIERZ /v1/ai/jobs/{job_id}/invoice.csv odpowiada, przesyłając prywatny plik tekstowy/csv do pobrania. Tylko ten sam właściciel/projekt, który jest właścicielem zadania AI, może je odzyskać. Nie można eksportować zadań zakończonych niepowodzeniem, oczekujących lub niezafakturowanych.

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

Kolumny: pole, wartość, source_citations, review_required. Występuje wszystkie siedem pól faktury, brakujące wartości są puste, a wszystkie wiersze są oznaczone jako review_required=true. Wartości CSV, które można zinterpretować jako formuły arkusza kalkulacyjnego, są uwzględniane ze zmianą znaczenia. Kontrola pamięci podręcznej jest prywatna, nie wymaga przechowywania; nigdy nie publikuj eksportów ani nie rejestruj zawartości dokumentów.

Ustrukturyzowane skoroszyty przeglądu faktur#

GET /v1/ai/jobs/{job_id}/invoice.xlsx generuje prywatny plik Excel zawierający nagłówek faktury, pozycje, wyciągi źródłowe oraz uwagi do uzgodnienia/przeglądu. Serwer sprawdza poprawność wersji źródła i przesunięcia cytowań oraz przechowuje kwoty w postaci tekstu, aby zachować dokładne miejsca po przecinku i chronić się przed wstrzyknięciem formuły z arkusza kalkulacyjnego. Nie wykonano żadnego połączenia z drugim operatorem ani rezerwacji 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 akceptuje od 1 do 10 odrębnych, posiadanych, ukończonych identyfikatorów zadań fakturowania z tego samego projektu API. Żądanie jest typu „wszystko albo nic”: wygasłe, zagraniczne, zduplikowane lub nieprawidłowe zadanie uniemożliwia cały eksport. Każda faktura jest nadal obciążana dopiero po przetworzeniu pierwotnego zadania AI.

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

Zasady przeglądu przed importem#

Walidacja formatu sprawdza daty ISO, trzyliterowe kody walut z wielkich liter, nieujemne sumy dziesiętne i odniesienia do cytatów związanych z wersją. Może odrzucić nieobsługiwane roszczenia liczbowe lub dotyczące numeru faktury. Nie pozwala stwierdzić, czy faktura jest autentyczna ani czy dana kwota jest prawnie prawidłową kwotą należną. Przed eksportem do księgowości, systemu ERP lub płatności przejrzyj oryginalny plik PDF.

Eksport CSV jest tylko do odczytu: nie generuje kolejnego żądania do dostawcy ani dodatkowej opłaty za model AI. Oryginalne zadanie AI korzysta z zatwierdzonej wyceny kredytów HQTools.

Logo PDFHQ

Narzędzia PDF i inteligencja dokumentów. Przygotuj, zrozum i pracuj ze swoimi dokumentami.

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.