Inndata
PDF- eller XML-faktura
Én fil per forespørsel, Base64-kodet
Produksjon
Strukturerte fakturadata
Overskriftsdata og linjeelementer
Behandling
Asynkron
Avstemning med en avstemnings-ID, maksimalt hvert 30. sekund
Adgang
Sandkasse og produksjon
Faktureres separat, aktivert av Qvalia-kundestøtte
Hent en faktura i to forespørsler
Base64-koder filen, send den med enrichmentTypes satt til å fange opp og samle inn resultatet med polling-ID-en fra svaret.
- Én fakturafil per forespørsel, PDF eller XML
- Inkluder filtypen i filnavn
- Avstemning ikke mer enn én gang hvert 30. sekund
- Hent bare fangstresultatet med enrichmentType-banen
● ● ●
Sandkasseforespørsel: Hent 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 å registrere på din egen PDF-faktura
Last opp en PDF-faktura på opptil 4,5 MB i Qvalias gratis testprogram for registrering, og se de strukturerte dataene den returnerer. Ingen integrasjon er nødvendig, og en eksempelrapport er tilgjengelig hvis du ikke har en fil for hånden.
Slik fungerer fakturainnsamling
Opptaket er asynkront. Du laster opp filen, Qvalia behandler den, og du samler inn resultatet når det er klart.
Last opp
Send én PDF- eller XML-faktura per forespørsel, Base64-kodet, til fakturasluttpunktet.
Capture
Qvalia leser dokumentet og trekker ut toppdata og linjeelementer til strukturerte fakturadata.
Avstemning
Bruk avstemnings-ID-en. En 202 betyr at behandlingen fortsetter, og en 200 returnerer resultatet.
Anmeldelse
Sjekk feilene og advarslene som returneres for hvert dokument før dataene går videre i prosessen.
Registrer endepunkter
Alle stier er relative til sandkassen eller produksjonsbasis-URL-en og begrenset til kontoregistreringsnummeret ditt.
| Forespørsel | Endepunkt | Returer |
| Last opp en faktura | POST /enrichment/{accountRegNo}/invoice | Avstemnings-ID |
| Få alle resultatene | GET /enrichment/{accountRegNo}/{pollingId} | Status, eller resultater per type |
| Få fangstresultatet | GET /enrichment/{accountRegNo}/{pollingId}/capture | Fang resultat |
Sandkasse: api-test.qvalia.comProduksjon: api.qvalia.comCapture er en del av Enrichment API, som faktureres separat og aktiveres av Qvalia-kundestøtte.
Hva man bør planlegge for i en integrasjon
Registrering kjører utenfor forespørselssyklusen din. Planlegg for disse punktene før du går live.
- Asynkron prosessering
Lagre avstemnings-ID-en sammen med dokumentet, og avstem ikke mer enn én gang hvert 30. sekund. - Feil og advarsler
Send dokumenter med feil til manuell gjennomgang og hold advarsler synlige for brukeren. - Hastighetsgrenser
Begrenser antall per konto på tvers av alle Qvalia API-er. Vent på perioden for nytt forsøk på en 429-feil. - Separate miljøer
Test mot api-test.qvalia.com før du bytter til api.qvalia.com. - Utløpte valg-ID-er
En 404-feil betyr at avstemnings-ID-en er ukjent eller utløpt. Last opp dokumentet på nytt hvis resultatet aldri ble samlet inn.
Velg ditt utgangspunkt
I nettapplikasjonen
OCR av fakturaer
Hent PDF-fakturaer i Qvalia-nettapplikasjonen uten å bygge en integrasjon.
Postering og klassifisering
Berikelses-API
Forslag til publisering og UNSPSC-klassifisering. Capture er støttetrinnet som utarbeider PDF-fakturaer for begge.
Hvordan komme i gang
API-hurtigstart
Konfigurer API-tilgang og send din første forespørsel, trinn for trinn.
Vanlige spørsmål om faktura-OCR-API
Hva er Faktura-OCR-API-et?
Et REST API som konverterer PDF-fakturaer til strukturerte fakturadata. Det kjører som opptakstypen for Enrichment API.
Hvilke filer kan jeg sende?
Én PDF- eller XML-faktura per forespørsel, Base64-kodet i fileContent-feltet. Inkluder filtypen i filnavn.
Hva returnerer API-et?
Strukturerte fakturadata med overskriftsdata og linjeelementer, samt feil og advarsler for dokumentet.
Hvor lang tid tar fangsten?
Behandlingen er asynkron, så tiden varierer fra dokument til dokument. Undersøk resultatets endepunkt ikke mer enn én gang hvert 30. sekund til du får 200.
Hvordan er OCR API-et forskjellig fra faktura-OCR?
Faktura-OCR fanges opp i Qvalia-nettapplikasjonen. OCR API-et gir ditt eget systemopptak gjennom et REST API.
Finnes det en sandkasse?
Ja. Bruk api-test.qvalia.com til testing og api.qvalia.com i produksjon.
Er OCR API-et inkludert i andre Qvalia API-er?
Nei. Capture er en del av Enrichment API, som faktureres separat. Qvalia-støtten aktiverer det for kontoen din.
