Funktion – Enrichment API

Udvidelses-API til bogføring af fakturaer og produktklassificering

To tilvalg via ét REST-API: foreslået kontokodning for leverandørfakturaer og UNSPSC-klassificering af fakturalinjer, kataloger og prislister. Capture understøtter begge dele ved først at omdanne PDF-fakturaer til strukturerede data. Anmodningerne kører asynkront, og du henter hvert resultat ved hjælp af et polling-ID.

Fakturabogføring og produktklassificering via Qvalia

Udvidelser

Oplysning og klassificering

Anmodet pr. dokument

Støttetrin

Indfangning

PDF-fakturaer til strukturerede data

Taksonomi

UNSPSC

Resultater vist pr. produkt-ID

Behandling

Asynkron

Aflæser højst hvert 30. sekund

Forslag til indlæg og UNSPSC-klassificering

Indlæsning og klassificering er de tilførte værdier. Indlæsning er det trin, der omdanner en PDF-faktura til strukturerede data, så begge dele kan fungere.

Forslag til indlæg

Forslag til kontoinddeling for hver linje på en leverandørfaktura, baseret på jeres organisations bogføringshistorik. Jeres team bekræfter hvert forslag.

Produktklassificering

UNSPSC-koder for fakturalinjer og for produkter fra kataloger og prislister, som hver især er forsynet med dit eget ID.

Optagelse som støtte

Når en faktura modtages som PDF, indhenter Capture først data fra fakturaoversigten og de enkelte linjer, så bogføringen og klassificeringen har strukturerede data at arbejde ud fra.

Indsaml resultater

Hver forespørgsel returnerer et polling-ID. Indsaml resultaterne for hver berigelsestype, og foretag polling højst én gang hvert 30. sekund.

Opdel en produktliste i to anmodninger

Send produktnavne sammen med dine egne ID’er, f.eks. varer fra et katalog, en prisliste eller dit vareregister. I svaret modtager du et forespørgsels-ID, og resultatet viser hvert produkt-ID sammen med dets UNSPSC-klassifikation.

  • Dine produkt-ID’er vises i resultatet
  • Log ind med en API-nøgle eller et JWT fra Account API’et
  • Der må højst foretages en forespørgsel hvert 30. sekund
  • Adskilte URL’er til test- og produktionsmiljøet

● ● ●

Sandkasseanmodning: klassificering af 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"

Endepunkter for berigelse

Alle stier er relative i forhold til sandkassens eller produktionsmiljøets basis-URL og er knyttet til dit kontonummer.

AnmodningEndepunktReturvarer
Udvid en fakturaPOST /enrichment/{accountRegNo}/invoiceAfstemnings-ID
Klassificer produkterPOST /enrichment/{accountRegNo}/categorisationAfstemnings-ID
Se alle resultaterGET /enrichment/{accountRegNo}/{pollingId}Status eller resultater efter type
Få ét resultatGET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}Resultat af registrering, bogføring eller klassificering

Sandkasse: api-test.qvalia.com. Produktion: api.qvalia.com. Enrichment API faktureres separat, og Qvalia-supporten aktiverer de udvidelser, som din konto benytter.

Når der anvendes berigede data

Indlæg med forslag og UNSPSC-koder indgår i andre processer, enten på din egen platform eller i Qvalia.

  • Leverandørgæld
    Den bekræftede kontokode følger fakturaen gennem godkendelses- og bogføringsprocessen.
  • Kataloger og prislister
    Tilføj en UNSPSC-kode til varer i kataloger og prislister, der mangler en sådan.
  • Med UNSPSC-koder fra udgiftsanalyse
    en kan du gruppere indkøb efter segment, familie og klasse på tværs af leverandører.
  • Din egen platform
    Vis forslag og klassificeringer til dine brugere i dit eget brugergrænseflade.

Vælg dit udgangspunkt

Indlæg

Regnskabs-API

Hvordan forslag til indlæg trænes, kontrolleres og godkendes af dit team.

Produktoplysninger

UNSPSC-klassifikation

Sådan klassificerer Qvalia fakturalinjer og produktdata ved hjælp af UNSPSC.

Indfangning

OCR API

Selve indlæsningstrinnet, med en gratis test af din egen PDF-faktura.

Ofte stillede spørgsmål om Enrichment API

Hvad er Enrichment API?

Et REST-API med to udvidelser: bogføringsforslag til leverandørfakturaer og UNSPSC-klassificering af fakturalinjer og produkter. Capture er et understøttende trin, der omdanner PDF-fakturaer til strukturerede data inden bogføring og klassificering.

Hvorfor er indfangning et understøttende trin?

Bogføring og klassificering af strukturerede data. Fakturaer, der modtages som Peppol- eller andre XML-dokumenter, indeholder allerede disse oplysninger. En PDF-faktura indlæses først, så dens overskriftsdata og linjeposter kan bogføres og klassificeres. Indlæsning kan også foretages separat via OCR-API’et.

Hvordan fungerer forslag til indlæg?

De trænes på fakturaer, som jeres organisation allerede har bogført. Hver ny leverandørfaktura får foreslået en kontoinddeling for hver linje, og jeres team bekræfter den. Læs mere på siden om regnskabs-API’en.

Kan jeg kategorisere kataloger og prislister?

Ja. Klassificeringsanmodningen modtager en liste over produkter, hvor hvert produkt har sit eget ID og et produktnavn, så varer fra et katalog, en prisliste, et vareregister eller fakturalinjer sendes på samme måde.

Hvilken taksonomi anvender klassificeringen?

UNSPSC. Resultatet viser hvert produkt-ID sammen med dets klassificering, så du kan sammenholde det med dine egne optegnelser.

Er der en sandkasse?

Ja. Brug api-test.qvalia.com til test og api.qvalia.com i produktionsmiljøet.

Er Enrichment API en del af andre Qvalia-API’er?

Nej. Enrichment API faktureres separat og kræver yderligere tilladelser. Qvalia-support aktiverer de udvidelser, som din konto bruger.

Alle platformens funktioner