Ominaisuus – Enrichment-sovellusliittymä

Enrichment-rajapinta laskujen kirjaamiseen ja tuotteiden luokitteluun

Kaksi lisätoimintoa yhden REST-rajapinnan kautta: toimittajien laskujen suositellut tilikoodit sekä laskurivien, luetteloiden ja hinnastojen UNSPSC-luokitus. Capture tukee molempia muuntamalla PDF-laskut ensin jäsennellyksi dataksi. Pyynnöt suoritetaan asynkronisesti, ja kukin tulos haetaan polling-tunnuksen avulla.

Laskujen kirjaaminen ja tuotteiden luokittelu Qvalian kautta

Rikastukset

Työpaikkailmoitukset ja luokittelu

Pyydetty asiakirjakohtaisesti

Tukivaihe

Capture

PDF-laskut jäsennellyksi dataksi

Taksonomia

UNSPSC

Tulokset tuotetunnuksen mukaan

Käsittely

Asynkroninen

Kysely enintään 30 sekunnin välein

Kaksi rikastusta, joissa käytetään sieppausta tukena

Kirjaaminen ja luokittelu ovat lisätoimintoja. Tietojen kerääminen on vaihe, jossa PDF-lasku muunnetaan jäsennellyksi dataksi, jotta molemmat toiminnot voivat suorittaa tehtävänsä.

Vinkkejä viestien kirjoittamiseen

Ehdotetut tilikoodit toimittajalaskun jokaiselle riville, jotka on määritetty organisaationne kirjaushistorian perusteella. Tiiminne vahvistaa jokaisen ehdotuksen.

Tuotteen luokittelu

Laskurivien sekä luetteloista ja hinnastoista peräisin olevien tuotteiden UNSPSC-koodit, joista jokaisella on oma tunnisteensa.

Tallennus tukitoimintona

Kun lasku saapuu PDF-tiedostona, Capture poimii ensin otsikkotiedot ja rivitiedot, jotta kirjaamisessa ja luokittelussa on käytettävissä jäsenneltyjä tietoja.

Kerää tulokset

Jokainen pyyntö palauttaa kyselytunnuksen. Kerää tulokset rikastustyypeittäin ja suorita kysely enintään kerran 30 sekunnin välein.

Tuoteluettelon luokittelu kahteen pyyntöön

Lähetä tuotenimet omilla tunnisteillasi, esimerkiksi tuotteet luettelosta, hinnastosta tai tuoterekisteristäsi. Vastauksessa saat kyselytunnuksen, ja tulos palauttaa kunkin tuotetunnuksen sekä sen UNSPSC-luokituksen.

  • Tuotteiden tunnisteet näkyvät tuloksessa
  • Kirjaudu sisään API-avaimella tai Account API:sta peräisin olevalla JWT:llä
  • Kysely saa tapahtua enintään kerran 30 sekunnissa
  • Erilliset hiekkalaatikon ja tuotantoympäristön perus-URL-osoitteet

● ● ●

Sandbox-pyyntö: tuotteiden luokittelu

curl -X POST \ “https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/categorisation” \ -H “Authorization: $QVALIA_API_KEY” \ -H “Content-Type: application/json” \ -d ‘{ “enrichmentTypes”: “unspsc”, “products”: [ { “id”: 1, “product_name”: “Nitrile gloves, size M” }, { “id”: 2, “product_name”: “A4 copy paper, 80 g” } ] }’ # Collect the result with the pollingId curl “https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/$POLLING_ID” \ -H “Authorization: $QVALIA_API_KEY”
curl -X POST \
"https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/categorisation" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "enrichmentTypes": "unspsc",
  "products": [
    { "id": 1, "product_name": "Nitrile gloves, size M" },
    { "id": 2, "product_name": "A4 copy paper, 80 g" }
  ]
}'

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

Tulosten arviointikriteerit

Kaikki polut ovat suhteellisia hiekkalaatikon tai tuotantoympäristön perus-URL-osoitteeseen nähden, ja niiden soveltamisala on rajattu tilisi rekisteröintinumeroon.

PyyntöPäätepistePalautukset
Täydennä laskuaPOST /enrichment/{accountRegNo}/invoiceKyselyn tunnus
Tuotteiden luokitteluPOST /enrichment/{accountRegNo}/categorisationKyselyn tunnus
Näytä kaikki tuloksetGET /enrichment/{accountRegNo}/{pollingId}Tila tai tulokset tyypeittäin
Hae yksi tulosGET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}Tallennus-, kirjaamis- tai luokittelutulos

Hiekkalaatikko: api-test.qvalia.com. Tuotanto: api.qvalia.com. Enrichment-sovellusliittymästä veloitetaan erikseen, ja Qvalian tuki ottaa käyttöön tililläsi käytettävät lisätoiminnot.

Missä rikastettuja tietoja käytetään

Ehdotusten ja UNSPSC-koodien syöttäminen ruokkii muita prosesseja joko omalla alustallasi tai Qvalia-järjestelmässä.

  • Ostovelat
    Vahvistettu tilikoodaus siirtyy laskun mukana hyväksyntä- ja kirjaamisvaiheeseen.
  • Luettelot ja hinnastot
    Lisää UNSPSC-koodi niihin luettelon ja hinnaston tuotteisiin, joilta se puuttuu.
  • Kuluanalyysi
    UNSPSC-koodien avulla voit ryhmitellä hankinnat segmentin, tuoteryhmän ja luokan mukaan toimittajista riippumatta.
  • Oma alustasi
    Näytä käyttäjille ehdotuksia ja luokituksia omassa käyttöliittymässäsi.

Valitse lähtöpisteesi

Julkaisu

Kirjanpito API

Miten tiimisi kouluttaa, tarkistaa ja vahvistaa julkaisuehdotuksia.

Tuotetiedot

UNSPSC-luokitus

Miten Qvalia luokittelee laskurivit ja tuotetiedot UNSPSC-luokituksen avulla.

Capture

OCR API

Pelkkä tallennusvaihe, johon sisältyy ilmainen testi omalle PDF-laskullesi.

Enrichment API:n usein kysytyt kysymykset

Mikä on Enrichment API?

REST-rajapinta, jossa on kaksi lisätoimintoa: toimittajien laskujen kirjausehdotukset sekä laskurivien ja tuotteiden UNSPSC-luokittelu. Capture on tukivaihe, jossa PDF-laskut muunnetaan jäsennellyksi dataksi ennen kirjausta ja luokittelua.

Miksi tallennus on tukivaihe?

Järjestelmään syöttö ja luokittelu perustuvat jäsenneltyihin tietoihin. Peppol- tai muina XML-asiakirjoina saapuvissa laskuissa nämä tiedot ovat jo valmiina. PDF-lasku tallennetaan ensin, jotta sen otsikkotiedot ja rivitiedot voidaan syöttää järjestelmään ja luokitella. Tallennus on mahdollista myös erillisenä toiminnon kautta OCR-sovellusliittymän (API) avulla.

Miten julkaisuehdotukset toimivat?

Ne on koulutettu organisaatiosi jo kirjaamien laskujen perusteella. Jokaiselle uudelle toimittajalaskulle ehdotetaan tilikoodia rivikohtaisesti, ja tiimisi vahvistaa sen. Lue lisää Kirjanpito-API- sivulta.

Voinko luokitella luetteloita ja hinnastoja?

Kyllä. Luokittelupyyntö vaatii tuoteluettelon, jossa jokaisella tuotteella on oma tunnisteensa ja tuotenimensä, joten tuotteet luettelosta, hinnastosta, tuoterekisteristä tai laskuriveiltä lähetetään samalla tavalla.

Mitä taksonomiaa luokittelu käyttää?

UNSPSC. Tuloksessa näkyy kunkin tuotteen tunniste ja sen luokitus, joten voit yhdistää tiedot omiin tietueisiisi.

Onko siellä hiekkalaatikkoa?

Kyllä. Käytä osoitetta api-test.qvalia.com testauskäytössä ja osoitetta api.qvalia.com tuotantokäytössä.

Sisältyykö Enrichment-sovellusliittymä muihin Qvalia-sovellusliittymiin?

Ei. Enrichment-sovellusliittymästä veloitetaan erikseen, ja se edellyttää lisäoikeuksia. Qvalian tuki ottaa käyttöön tililläsi käytettävät tietojen rikastustoiminnot.

Kaikki alustan ominaisuudet