Obohatenia
Zverejňovanie a klasifikácia
Požadované na jeden dokument
Podporný stupeň
Zachytávanie
Faktúry vo formáte PDF na štruktúrované údaje
Taxonómia
UNSPSC
Výsledky zobrazené podľa ID produktu
Spracovanie
Asynchrónny
Odotazovanie najviac každých 30 sekúnd
Dve obohatenia s využitím zachytávania ako podpory
Zverejňovanie a klasifikácia predstavujú obohatenie. Zaznamenávanie je krok, ktorý premení faktúru vo formáte PDF na štruktúrované údaje, aby bolo možné spustiť oba procesy.
Návrhy na príspevky
Navrhované účtovné kódovanie pre každý riadok faktúry od dodávateľa, vygenerované na základe histórie účtovných záznamov vašej organizácie. Váš tím potvrdzuje každý návrh.
Klasifikácia výrobkov
Kódy UNSPSC pre položky faktúr a pre výrobky z katalógov a cenníkov, z ktorých každý má pridelené vlastné identifikačné číslo.
Zachytiť ako podporu
Keď príde faktúra vo formáte PDF, systém najprv zachytí údaje z hlavičky a jednotlivých položiek, aby mal systém zaúčtovania a klasifikácie k dispozícii štruktúrované údaje, s ktorými môže pracovať.
Zozbierať výsledky
Každá požiadavka vráti identifikátor dotazovania. Výsledky zhromažďujte podľa typu obohatenia, pričom dotazovanie vykonávajte najviac raz za 30 sekúnd.
Roztrieďte zoznam produktov do dvoch požiadaviek
Odošlite názvy produktov spolu s vašimi vlastnými identifikátormi, napríklad položky z katalógu, cenníka alebo vášho zoznamu položiek. V odpovedi dostanete identifikátor dotazu a výsledok vám vráti každý identifikátor produktu spolu s jeho klasifikáciou podľa UNSPSC.
- ID vašich produktov sa vo výsledku zobrazujú
- Prihláste sa pomocou kľúča API alebo JWT z rozhrania API účtu
- Vykonávajte dotazovanie najviac raz za 30 sekúnd
- Oddelené základné URL adresy pre testovacie a produkčné prostredie
● ● ●
Žiadosť v sandboxe: klasifikácia produktov
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"Konečné body obohatenia
Všetky cesty sú relatívne voči základnej URL adresy sandboxu alebo produkčného prostredia a sú viazané na registračné číslo vášho účtu.
| Žiadosť | Koncový bod | Vrátenie tovaru |
| Doplniť faktúru | POST /enrichment/{accountRegNo}/invoice | ID ankety |
| Klasifikovať výrobky | POST /enrichment/{accountRegNo}/categorisation | ID ankety |
| Zobraziť všetky výsledky | GET /enrichment/{accountRegNo}/{pollingId} | Stav alebo výsledky podľa typu |
| Získať jeden výsledok | GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType} | Výsledok zachytenia, zaevidovania alebo klasifikácie |
Pieskovisko: api-test.qvalia.com. Produkcia: api.qvalia.com. Za rozhranie Enrichment API sa účtuje osobitne a technická podpora spoločnosti Qvalia aktivuje obohatenia, ktoré váš účet využíva.
Kedy sa používajú obohatené údaje
Zadávanie návrhov a kódov UNSPSC slúži ako vstup pre ďalšie procesy, a to buď na vašej vlastnej platforme, alebo v systéme Qvalia.
- Záväzky voči spoločnosti
Potvrdené kódovanie účtov sa prenáša spolu s faktúrou do schvaľovacieho procesu a následného zaúčtovania. - Katalógy a cenníky
Pridajte kód UNSPSC k položkám v katalógu a cenníku, ktoré ho nemajú. - Analýza výdavkov
Kódy UNSPSC vám umožňujú zoskupovať nákupy podľa segmentu, skupiny a triedy naprieč dodávateľmi. - Vaša vlastná platforma
Poskytujte svojim používateľom návrhy a klasifikácie vo vašom vlastnom rozhraní.
Vyberte si východiskový bod
Zverejnenie
Účtovné API
Ako váš tím pripravuje, kontroluje a schvaľuje návrhy príspevkov.
Údaje o produkte
Klasifikácia UNSPSC
Ako spoločnosť Qvalia klasifikuje položky faktúr a údaje o produktoch pomocou UNSPSC.
Zachytávanie
OCR API
Samotný proces naskenovania, vrátane bezplatného testu pre vašu vlastnú faktúru vo formáte PDF.
Často kladené otázky k rozširujúcemu API
Čo je rozhranie Enrichment API?
REST API s dvoma rozšíreniami: návrhy na zaúčtovanie faktúr od dodávateľov a klasifikácia fakturačných položiek a produktov podľa UNSPSC. Capture je podporný krok, ktorý pred spustením zaúčtovania a klasifikácie prevádza faktúry vo formáte PDF na štruktúrované údaje.
Prečo je zachytenie podporným krokom?
Zaznamenávanie a klasifikácia štruktúrovaných údajov. Faktúry, ktoré prichádzajú vo formáte Peppol alebo ako iné dokumenty XML, už tieto údaje obsahujú. Faktúra vo formáte PDF sa najskôr naskenuje, aby bolo možné zaznamenať a klasifikovať údaje v hlavičke a položky faktúry. Skenovanie je možné vykonať aj samostatne prostredníctvom rozhrania OCR API.
Ako fungujú návrhy na príspevky?
Sú trénované na faktúrach, ktoré vaša organizácia už zaúčtovala. Ku každej novej dodávateľskej faktúre sa pre každú položku navrhne účtovné kódovanie, ktoré váš tím následne potvrdí. Viac informácií nájdete na stránke Accounting API.
Môžem kategorizovať katalógy a cenníky?
Áno. Žiadosť o klasifikáciu vyžaduje zoznam produktov, z ktorých každý má svoje vlastné ID a názov produktu, takže položky z katalógu, cenníka, registra položiek alebo fakturačných riadkov sa odosielajú rovnakým spôsobom.
Ktorú taxonómiu využíva klasifikácia?
UNSPSC. Výsledok obsahuje ID každého produktu spolu s jeho klasifikáciou, takže ho môžete priradiť k vašim vlastným záznamom.
Je tam pieskovisko?
Áno. Na testovanie použite adresu api-test.qvalia.com a v produkčnom prostredí adresu api.qvalia.com.
Je rozhranie Enrichment API súčasťou iných rozhraní Qvalia API?
Nie. Za rozhranie Enrichment API sa účtuje osobitne a vyžaduje si dodatočné oprávnenia. Podpora Qvalia aktivuje obohatenia, ktoré váš účet využíva.
