Indtastning
Faktura i PDF- eller XML-format
Én fil pr. anmodning, Base64-kodet
Output
Strukturerede fakturadata
Overskriftsdata og linjeposter
Behandling
Asynkron
Afstemning med et afstemnings-ID, højst hvert 30. sekund
Adgang
Sandkasse og produktion
Faktureres separat, muliggjort af Qvalia-support
Registrer en faktura i to trin
Kod filen med Base64, send den med `enrichmentTypes` indstillet til `capture`, og indhent resultatet ved hjælp af polling-ID’et fra svaret.
- Én fakturafil pr. anmodning, i PDF- eller XML-format
- Medtag filtypen i filnavnet
- Der må højst foretages en forespørgsel hvert 30. sekund
- Hent kun optagelsesresultatet med stien »enrichmentType«
● ● ●
Sandbox-anmodning: registrering af 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"Prøv at indscanne din egen PDF-faktura
Upload en PDF-faktura på op til 4,5 MB i Qvalia’s gratis testversion til dataudtræk, og se de strukturerede data, den genererer. Der kræves ingen integration, og der findes en eksempelrapport, hvis du ikke har en fil ved hånden.
Sådan fungerer registrering af fakturaer
Indlæsningen foregår asynkront. Du uploader filen, Qvalia behandler den, og du henter resultatet, når det er klar.
Upload
Send én PDF- eller XML-faktura pr. anmodning, Base64-kodet, til faktura-endpointet.
Indfangning
Qvalia læser dokumentet og udtrækker overskriftsdata og linjeposter til strukturerede fakturadata.
Afstemning
Brug polling-ID’et. En 202 betyder, at behandlingen fortsætter, mens en 200 returnerer resultatet.
Anmeldelse
Kontroller de fejl og advarsler, der vises for hvert dokument, inden dataene sendes videre i din proces.
Indsamling af endepunkter
Alle stier er relative i forhold til sandkassens eller produktionsmiljøets basis-URL og er knyttet til dit kontonummer.
| Anmodning | Endepunkt | Returvarer |
| Upload en faktura | POST /enrichment/{accountRegNo}/invoice | Afstemnings-ID |
| Se alle resultater | GET /enrichment/{accountRegNo}/{pollingId} | Status eller resultater efter type |
| Hent optagelsesresultatet | GET /enrichment/{accountRegNo}/{pollingId}/capture | Optagelsesresultat |
Sandkasse: api-test.qvalia.com. Produktion: api.qvalia.com. Capture er en del af Enrichment API, som faktureres separat og aktiveres af Qvalia-support.
Hvad man skal tage højde for ved en integration
Indsamlingen foregår uden for din anmodningscyklus. Sørg for at tage højde for disse punkter, inden du går live.
- Asynkron behandling
Gem polling-ID’et sammen med dokumentet, og foretag polling højst én gang hvert 30. sekund. - Fejl og advarsler
Send dokumenter med fejl til manuel gennemgang, og sørg for, at advarslerne forbliver synlige for brugeren. - Ratebegrænsninger
Begrænsningerne gælder pr. konto på tværs af alle Qvalia-API’er. Ved en 429-fejl skal du afvente »Retry-After«-perioden. - Separate miljøer
Test mod api-test.qvalia.com, før du skifter til api.qvalia.com. - Udløbne afstemnings-ID’er
En 404-fejl betyder, at afstemnings-ID’et er ukendt eller udløbet. Upload dokumentet igen, hvis resultatet aldrig blev indsamlet.
Vælg dit udgangspunkt
I webapplikationen
OCR af fakturaer
Indlæs PDF-fakturaer i Qvalia-webapplikationen uden at skulle oprette en integration.
Oplysning og klassificering
Enrichment API
Indsendelse af forslag og UNSPSC-klassificering. »Capture« er det understøttende trin, der forbereder PDF-fakturaer til begge formål.
Kom godt i gang
Hurtigstart til API’et
Konfigurer API-adgang, og send din første anmodning – trin for trin.
Ofte stillede spørgsmål om faktura-OCR-API’en
Hvad er Invoice OCR API?
Et REST-API, der omdanner PDF-fakturaer til strukturerede fakturadata. Det fungerer som indlæsningstype i Enrichment API’et.
Hvilke filer kan jeg sende?
Én PDF- eller XML-faktura pr. anmodning, Base64-kodet i feltet »fileContent«. Angiv filtypen i »fileName«.
Hvad returnerer API’et?
Strukturerede fakturadata med overskriftsoplysninger og linjeposter samt fejl og advarsler vedrørende dokumentet.
Hvor lang tid tager indfangningen?
Behandlingen foregår asynkront, så varigheden varierer fra dokument til dokument. Du bør højst forespørge resultat-endpointet én gang hvert 30. sekund, indtil du får en 200-kode.
Hvordan adskiller OCR-API’en sig fra faktura-OCR?
OCR-indlæsning af fakturaer foregår i Qvalia-webapplikationen. OCR-API’et giver dit eget system mulighed for at indlæse data via et REST-API.
Er der en sandkasse?
Ja. Brug api-test.qvalia.com til test og api.qvalia.com i produktionsmiljøet.
Er OCR-API’et en del af andre Qvalia-API’er?
Nej. Capture er en del af Enrichment API, som faktureres separat. Qvalia-support aktiverer funktionen på din konto.
