Funksjon – Berikelses-API

Berikelses-API for fakturapostering og produktklassifisering

To berikelser gjennom ett REST API: foreslått kontokoding for leverandørfakturaer og UNSPSC-klassifisering av fakturalinjer, kataloger og prislister. Capture støtter begge deler ved å først gjøre PDF-fakturaer om til strukturerte data. Forespørsler kjøres asynkront, og du samler inn hvert resultat med en polling-ID.

Fakturapostering og produktklassifisering gjennom Qvalia

Berikelser

Postering og klassifisering

Forespurt per dokument

Støttetrinn

Capture

PDF-fakturaer til strukturerte data

Taksonomi

UNSPSC

Resultater returnert per produkt-ID

Behandling

Asynkron

Avstemning maksimalt hvert 30. sekund

Forslag til innlegg og UNSPSC-klassifisering

Bokføring og klassifisering er berikelsene. Registrering er trinnet som omdanner en PDF-faktura til strukturerte data, slik at begge kan kjøres.

Forslag til innlegg

Foreslått kontokoding for hver linje i en leverandørfaktura, trent på organisasjonens bokføringshistorikk. Teamet ditt bekrefter hvert forslag.

Produktklassifisering

UNSPSC-koder for fakturalinjer og for produkter fra kataloger og prislister, hver returnert med din egen ID.

Fang som støtte

Når en faktura ankommer som PDF, må du først trekke ut overskriftsdata og linjeelementer, slik at postering og klassifisering har strukturerte data å jobbe med.

Samle inn resultater

Hver forespørsel returnerer en avspørrings-ID. Samle inn resultatet per berikelsestype, og avspørring ikke mer enn én gang hvert 30. sekund.

Klassifiser en produktliste i to forespørsler

Send produktnavn med dine egne ID-er, for eksempel varer fra en katalog, en prisliste eller vareregisteret ditt. Svaret gir deg en avstemnings-ID, og ​​resultatet returnerer hver produkt-ID med sin UNSPSC-klassifisering.

  • Produkt-ID-ene dine vises i resultatet
  • Autentiser med en API-nøkkel eller en JWT fra Account API-et
  • Avstemning ikke mer enn én gang hvert 30. sekund
  • Separate URL-er for sandkasse og produksjonsbasis

● ● ●

Sandkasseforespørsel: klassifiser 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"

Berikelsesendepunkter

Alle stier er relative til sandkassen eller produksjonsbasis-URL-en og begrenset til kontoregistreringsnummeret ditt.

ForespørselEndepunktReturer
Berik en fakturaPOST /enrichment/{accountRegNo}/invoiceAvstemnings-ID
Klassifiser produkterPOST /enrichment/{accountRegNo}/categorisationAvstemnings-ID
Få alle resultateneGET /enrichment/{accountRegNo}/{pollingId}Status, eller resultater per type
Få ett resultatGET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}Resultat av registrering, publisering eller klassifisering

Sandkasse: api-test.qvalia.comProduksjon: api.qvalia.comBerikelses-API-et faktureres separat, og Qvalia-støtte muliggjør berikelsene kontoen din bruker.

Der berikede data brukes

Forslag til innlegg og UNSPSC-koder mater andre prosesser, på din egen plattform eller i Qvalia.

  • Leverandørgjeld
    Bekreftet kontokontering følger fakturaen inn i godkjenning og kontering.
  • Kataloger og prislister
    Legg til en UNSPSC-kode i katalog- og prislistevarer som mangler en.
  • Forbruksanalyse
    UNSPSC-koder lar deg gruppere kjøp etter segment, familie og klasse på tvers av leverandører.
  • Din egen plattform
    Returner forslag og klassifiseringer til brukerne dine i ditt eget grensesnitt.

Velg ditt utgangspunkt

Innlegg

API for regnskap

Hvordan innleggsforslag trenes, kontrolleres og bekreftes av teamet ditt.

Produktdata

UNSPSC-klassifisering

Hvordan Qvalia klassifiserer fakturalinjer og produktdata med UNSPSC.

Capture

OCR API

Selve registreringstrinnet, med en gratis test av din egen PDF-faktura.

Vanlige spørsmål om berikelses-API

Hva er berikelses-API-et?

Et REST API med to berikelser: forslag til publisering av leverandørfakturaer og UNSPSC-klassifisering av fakturalinjer og produkter. Capture er et støttetrinn som gjør PDF-fakturaer om til strukturerte data før publisering og klassifisering.

Hvorfor er opptak et støttetrinn?

Bokføring og klassifisering fungerer på strukturerte data. Fakturaer som ankommer som Peppol eller andre XML-dokumenter har det allerede. En PDF-faktura registreres først, slik at toppdataene og linjepostene kan registreres og klassifiseres. Registrering er også tilgjengelig separat via OCR API .

Hvordan fungerer forslag til innlegg?

De er opplært på fakturaer organisasjonen din allerede har bokført. Hver ny leverandørfaktura får foreslått kontokoding per linje, og teamet ditt bekrefter den. Les mer på siden for regnskaps-API .

Kan jeg klassifisere kataloger og prislister?

Ja. Klassifiseringsforespørselen tar en liste over produkter, hver med din egen ID og et produktnavn, slik at varer fra en katalog, en prisliste, et vareregister eller fakturalinjer sendes på samme måte.

Hvilken taksonomi bruker klassifiseringen?

UNSPSC. Resultatet returnerer hver produkt-ID med klassifiseringen, slik at du kan matche den tilbake med dine egne poster.

Finnes det en sandkasse?

Ja. Bruk api-test.qvalia.com til testing og api.qvalia.com i produksjon.

Er Enrichment API inkludert i andre Qvalia API-er?

Nei. Enrichment API faktureres separat og krever ytterligere tillatelser. Qvalia-støtte aktiverer berikelsene kontoen din bruker.

Alle plattformfunksjoner