Feature - Databeriknings-API

Databeriknings-API för kontering och produktklassificering

Två berikningar i ett REST-API: konteringsförslag för leverantörsfakturor och UNSPSC-klassificering av fakturarader, kataloger och prislistor. Tolkning stödjer båda genom att först göra PDF-fakturor till strukturerad data, och ni hämtar varje resultat med ett polling-ID.

Berikningar

Kontering och klassificering

Begärs per dokument

Stödsteg

Tolkning

PDF-fakturor till strukturerad data

Taxonomi

UNSPSC

Resultat returneras per produkt-ID

Bearbetning

Asynkron

Hämta resultatet högst var 30:e sekund

Konteringsförslag och UNSPSC-klassificering

Kontering och klassificering är berikningarna. Tolkning är steget som gör en PDF-faktura till strukturerad data, så att båda kan köras.

Konteringsförslag

Föreslagen kontering för varje rad på en leverantörsfaktura, tränad på er organisations konteringshistorik. Ert team bekräftar varje förslag.

Produktklassificering

UNSPSC-koder för fakturarader och för produkter från kataloger och prislistor, var och en returnerad med ert eget ID.

Tolkning som stöd

När en faktura kommer som PDF extraherar tolkningen först huvuddata och fakturarader, så att kontering och klassificering har strukturerad data att arbeta med.

Hämta resultat

Varje anrop returnerar ett polling-ID. Hämta resultatet per berikningstyp, högst en gång var 30:e sekund.

Klassificera en produktlista i två anrop

Skicka produktnamn med era egna ID:n, till exempel artiklar från en katalog, en prislista eller ert artikelregister. Svaret ger er ett polling-ID, och resultatet returnerar varje produkt-ID med dess UNSPSC-klassificering.

  • Era produkt-ID:n returneras i resultatet
  • Autentisera med en API-nyckel eller en JWT från Account API
  • Hämta resultatet högst en gång var 30:e sekund
  • Separata bas-URL:er för testmiljö och produktion

●  ●  ●

Anrop i testmiljön: klassificera produkter

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"

Endpoints för databerikning

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

AnropEndpointReturnerar
Berika en fakturaPOST /enrichment/{accountRegNo}/invoicePolling-ID
Klassificera produkterPOST /enrichment/{accountRegNo}/categorisationPolling-ID
Hämta alla resultatGET /enrichment/{accountRegNo}/{pollingId}Status eller resultat per typ
Hämta ett resultatGET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}Resultat för tolkning, kontering eller klassificering

Testmiljö: api-test.qvalia.com. Produktion: api.qvalia.com. Databeriknings-API:t faktureras separat, och Qvalias support aktiverar de berikningar ert konto använder.

Här används berikad data

Konteringsförslag och UNSPSC-koder matar andra processer, i er egen plattform eller i Qvalia.

  • Leverantörsfakturor
    Bekräftad kontering följer fakturan till attest och bokföring.
  • Kataloger och prislistor
    Lägg till en UNSPSC-kod på katalog- och prislisteartiklar som saknar en.
  • Spendanalys
    Med UNSPSC-koder kan ni gruppera inköp per segment, familj och klass över alla leverantörer.
  • Er egen plattform
    Visa förslag och klassificeringar för era användare i ert eget gränssnitt.

Välj var ni börjar

Kontering

Bokförings-API

Hur konteringsförslag tränas, kontrolleras och bekräftas av ert team.

Produktdata

UNSPSC-klassificering

Hur Qvalia klassificerar fakturarader och produktdata enligt UNSPSC.

Tolkning

OCR-API

Tolkningssteget för sig, med ett kostnadsfritt test för er egen PDF-faktura.

Vanliga frågor om Databeriknings-API:t

Vad är Databeriknings-API:t?

Ett REST-API med två berikningar: konteringsförslag för leverantörsfakturor och UNSPSC-klassificering av fakturarader och produkter. Tolkning är ett stödsteg som gör PDF-fakturor till strukturerad data innan kontering och klassificering körs.

Varför är tolkning ett stödsteg?

Kontering och klassificering arbetar med strukturerad data. Fakturor som kommer som Peppol- eller andra XML-dokument har det redan. En PDF-faktura tolkas först, så att dess huvuddata och fakturarader kan konteras och klassificeras. Tolkning finns också separat via OCR-API:t.

Hur fungerar konteringsförslag?

De tränas på fakturor som er organisation redan har bokfört. Varje ny leverantörsfaktura får föreslagen kontering per rad, och ert team bekräftar den. Läs mer på sidan om Bokförings-API:t.

Kan jag klassificera kataloger och prislistor?

Ja. Klassificeringsanropet tar en lista med produkter, var och en med ert eget ID och ett produktnamn, så artiklar från en katalog, en prislista, ett artikelregister eller fakturarader skickas på samma sätt.

Vilken taxonomi används för klassificeringen?

UNSPSC. Resultatet returnerar varje produkt-ID med dess klassificering, så att ni kan matcha det mot era egna poster.

Finns det en testmiljö?

Ja. Använd api-test.qvalia.com för test och api.qvalia.com i produktion.

Ingår Databeriknings-API:t i Qvalias andra API:er?

Nej. Databeriknings-API:t faktureras separat och kräver ytterligare behörigheter. Qvalias support aktiverar de berikningar ert konto använder.

Alla funktioner