OCR-API för PDF-fakturor till strukturerad data

Indata

PDF- eller XML-faktura

En fil per anrop, Base64-kodad

Utdata

Strukturerad fakturadata

Huvuddata och fakturarader

Bearbetning

Asynkron

Hämta resultatet med ett polling-ID, högst var 30:e sekund

Åtkomst

Testmiljö och produktion

Faktureras separat, aktiveras av Qvalias support

Tolka en faktura i två anrop

Base64-koda filen, skicka den med enrichmentTypes satt till capture och hämta resultatet med polling-ID:t från svaret.

En fakturafil per anrop, PDF eller XML
Ange filändelsen i fileName
Hämta resultatet högst en gång var 30:e sekund
Hämta bara tolkningsresultatet med sökvägen för enrichmentType

Läs referensen för Databeriknings-API:t

● ● ●

Anrop i testmiljön: tolka en faktura

# capture-request.json
{
  "fileName": "invoice.pdf",
  "fileContent": "<Base64-encoded PDF>",
  "enrichmentTypes": "capture"
}

curl -X POST \
"https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/invoice" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-d @capture-request.json

# Collect the result with the pollingId
curl "https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/$POLLING_ID/capture" \
-H "Authorization: $QVALIA_API_KEY"

Testa tolkningen på er egen PDF-faktura

Ladda upp en PDF-faktura på upp till 4,5 MB i Qvalias kostnadsfria tolkningstest och se vilken strukturerad data den returnerar. Ingen integration behövs, och det finns en exempelrapport om ni inte har någon fil till hands.

Till tolkningstestet

Så fungerar fakturatolkning

Tolkningen är asynkron. Ni laddar upp filen, Qvalia bearbetar den och ni hämtar resultatet när det är klart.

Ladda upp

Skicka en PDF- eller XML-faktura per anrop, Base64-kodad, till fakturaendpointen.

Tolka

Qvalia läser dokumentet och extraherar huvuddata och fakturarader till strukturerad fakturadata.

Hämta

Använd polling-ID:t. 202 betyder att bearbetningen pågår, och 200 returnerar resultatet.

Granska

Kontrollera fel och varningar som returneras för varje dokument innan datan går vidare i er process.

Endpoints för tolkning

Alla sökvägar är relativa till bas-URL:en för testmiljön eller produktionen och gäller ert kontos registreringsnummer.

Anrop	Endpoint	Returnerar
Ladda upp en faktura	`POST /enrichment/{accountRegNo}/invoice`	Polling-ID
Hämta alla resultat	`GET /enrichment/{accountRegNo}/{pollingId}`	Status eller resultat per typ
Hämta tolkningsresultatet	`GET /enrichment/{accountRegNo}/{pollingId}/capture`	Tolkningsresultat

Testmiljö: api-test.qvalia.com. Produktion: api.qvalia.com. Tolkning är en del av Databeriknings-API:t, som faktureras separat och aktiveras av Qvalias support.

Att planera för i en integration

Tolkningen körs utanför ert anropsflöde. Planera för de här punkterna innan ni går live.

Asynkron bearbetning
Spara polling-ID:t med dokumentet och hämta resultatet högst en gång var 30:e sekund.
Fel och varningar
Skicka dokument med fel till manuell granskning och låt varningar synas för användaren.
Anropsgränser
Gränserna räknas per konto över alla Qvalias API:er. Vid 429, vänta den tid som anges i Retry-After.
Separata miljöer
Testa mot api-test.qvalia.com innan ni byter till api.qvalia.com.
Utgångna polling-ID
404 betyder att polling-ID:t är okänt eller har gått ut. Ladda upp dokumentet igen om resultatet aldrig hämtades.