Syöte
PDF- tai XML-lasku
Yksi tiedosto kutakin pyyntöä kohti, Base64-koodattu
Tulostus
Jäsennellyt laskutiedot
Otsikkotiedot ja rivitiedot
Käsittely
Asynkroninen
Kysely, jolla on kyselytunnus, enintään 30 sekunnin välein
Pääsy
Kokeilu- ja tuotantoympäristö
Laskutetaan erikseen, Qvalia-tuen ansiosta
Kirjaa lasku kahdessa vaiheessa
Koodaa tiedosto Base64-muotoon, lähetä se siten, että enrichmentTypes-asetukseksi on määritetty ”capture”, ja kerää tulos vastauksessa olevan kyselytunnuksen avulla.
- Yksi laskutiedosto kutakin pyyntöä kohti, PDF- tai XML-muodossa
- Lisää tiedostotunniste tiedostonimeen
- Kysely saa tapahtua enintään kerran 30 sekunnissa
- Hae vain tallennustulos, jossa on polku ”enrichmentType”
● ● ●
Sandbox-pyyntö: laskun tallentaminen
# 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"Kokeile tallentaa oma PDF-laskusi
Lataa enintään 4,5 Mt:n kokoinen PDF-lasku Qvalian ilmaiseen tiedonkeruukokeeseen ja katso, millaista jäsenneltyä dataa se tuottaa. Integrointia ei tarvita, ja jos sinulla ei ole tiedostoa käsillä, voit käyttää esimerkkiraporttia.
Kuinka laskujen tallennus toimii
Tiedostojen tallennus tapahtuu asynkronisesti. Lähetät tiedoston, Qvalia käsittelee sen ja voit noutaa tuloksen, kun se on valmis.
Lataa
Lähetä yksi PDF- tai XML-lasku kutakin pyyntöä kohti Base64-koodattuna laskujen lähetyspisteeseen.
Capture
Qvalia lukee asiakirjan ja erittelee otsikkotiedot sekä rivitiedot jäsennellyiksi laskutiedoiksi.
Kysely
Käytä kyselytunnusta. Arvo 202 tarkoittaa, että käsittely jatkuu, ja arvo 200 palauttaa tuloksen.
Arvostelu
Tarkista kunkin asiakirjan osalta palautetut virheet ja varoitukset ennen kuin tiedot siirtyvät eteenpäin prosessissasi.
Tallennuspisteet
Kaikki polut ovat suhteellisia hiekkalaatikon tai tuotantoympäristön perus-URL-osoitteeseen nähden, ja niiden soveltamisala on rajattu tilisi rekisteröintinumeroon.
| Pyyntö | Päätepiste | Palautukset |
| Lataa lasku | POST /enrichment/{accountRegNo}/invoice | Kyselyn tunnus |
| Näytä kaikki tulokset | GET /enrichment/{accountRegNo}/{pollingId} | Tila tai tulokset tyypeittäin |
| Hae kaappaus tulos | GET /enrichment/{accountRegNo}/{pollingId}/capture | Tallennustulos |
Hiekkalaatikko: api-test.qvalia.com. Tuotanto: api.qvalia.com. Capture on osa Enrichment API:ta, josta veloitetaan erikseen ja jonka Qvalian tuki ottaa käyttöön.
Mitä integroinnissa on otettava huomioon
Tallennus suoritetaan pyyntösyklisi ulkopuolella. Ota nämä seikat huomioon ennen järjestelmän käyttöönottoa.
- Asynkroninen käsittely
Tallenna kyselytunnus asiakirjan mukana ja suorita kysely enintään kerran 30 sekunnin välein. - Virheet ja varoitukset
Ohjaa virheitä sisältävät reittidokumentit manuaaliseen tarkastukseen ja pidä varoitukset käyttäjän näkyvillä. - Käyttörajoitukset
Rajoitukset lasketaan tilikohtaisesti kaikkien Qvalia-sovellusliittymien osalta. Jos vastaus on 429, odota Retry-After-ajan kulumista. - Erilliset ympäristöt:
. Suorita testit osoitteessa api-test.qvalia.com ennen siirtymistä osoitteeseen api.qvalia.com. - Vanhentuneet kyselytunnukset
Virhekoodi 404 tarkoittaa, että kyselytunnusta ei tunneta tai se on vanhentunut. Lataa asiakirja uudelleen, jos tulosta ei ole koskaan kerätty.
Valitse lähtöpisteesi
Verkkosovelluksessa
Laskujen OCR
Tallenna PDF-laskut Qvalia-verkkosovellukseen ilman erillistä integraatiota.
Työpaikkailmoitukset ja luokittelu
Enrichment-sovellusliittymä
Ehdotusten lähettäminen ja UNSPSC-luokitus. Capture on tukitoiminto, joka valmistelee PDF-laskut molempia varten.
Aloittaminen
API:n pikaopas
Määritä API-käyttöoikeudet ja lähetä ensimmäinen pyyntösi vaihe vaiheelta.
Laskun OCR-rajapinnan usein kysytyt kysymykset
Mikä on Invoice OCR API?
REST-rajapinta, joka muuntaa PDF-laskut jäsennellyiksi laskutiedoiksi. Se toimii Enrichment-rajapinnan tallennustyyppinä.
Mitä tiedostoja voin lähettää?
Yksi PDF- tai XML-lasku kutakin pyyntöä kohti, Base64-koodattuna fileContent-kentässä. Lisää tiedostotunniste fileName-kenttään.
Mitä API palauttaa?
Jäsennellyt laskutiedot, joihin sisältyvät otsikkotiedot ja rivitiedot, sekä asiakirjaan liittyvät virheet ja varoitukset.
Kuinka kauan tallennus kestää?
Käsittely tapahtuu asynkronisesti, joten kesto vaihtelee asiakirjakohtaisesti. Tarkista tulosliittymää enintään kerran 30 sekunnissa, kunnes saat vastauksen 200.
Miten OCR-sovellusliittymä eroaa laskujen OCR-tunnistuksesta?
Laskujen OCR-tunnistus tapahtuu Qvalia-verkkosovelluksessa. OCR-rajapinta mahdollistaa tunnistuksen omassa järjestelmässäsi REST-rajapinnan kautta.
Onko siellä hiekkalaatikkoa?
Kyllä. Käytä osoitetta api-test.qvalia.com testauskäytössä ja osoitetta api.qvalia.com tuotantokäytössä.
Sisältyykö OCR-rajapinta muihin Qvalia-rajapintoihin?
Ei. Capture on osa Enrichment API:ta, josta veloitetaan erikseen. Qvalian tuki ottaa sen käyttöön tililläsi.
