Rozširujúce rozhranie API dopĺňa štruktúrované údaje do faktúr od dodávateľov a údajov o produktoch. Obsahuje dve funkcie rozširovania: návrhy zaúčtovania, ktoré navrhujú účtovné kódovanie pre každú položku faktúry od dodávateľa, a klasifikáciu produktov, ktorá priraďuje kódy UNSPSC k položkám faktúr a k produktom v katalógoch a cenníkoch.
| Obohatenie | Čo posielate | Čo za to dostanete |
| Návrhy na príspevky | Faktúra od dodávateľa | Navrhované účtovné kódovanie pre jednotlivé položky faktúry, ktoré má váš tím potvrdiť |
| Klasifikácia výrobkov | Produkty s vlastným identifikačným číslom a názvom produktu alebo fakturačné položky | Kód UNSPSC pre každý produkt, ktorý sa zobrazí spolu s vaším identifikačným číslom |
| Zaznamenanie (podporný krok) | Faktúra vo formáte PDF | Údaje v hlavičke a riadky faktúry ako štruktúrované údaje |
Funkcia Capture prevádza faktúru vo formáte PDF na štruktúrované údaje, aby mali moduly na obohacovanie údajov s čím pracovať. Faktúry, ktoré prichádzajú vo formáte Peppol alebo ako iné dokumenty XML, tento krok preskakujú. Funkcia Capture je k dispozícii aj samostatne ako OCR API.
Ako funguje žiadosť
- Odošlite požiadavku typu POST na koncový bod faktúry alebo kategorizácie.
- Uložte identifikátor dotazovania, ktorý bol vrátený v odpovedi.
- Výsledok získajte pomocou požiadavky GET, najviac raz za 30 sekúnd.
- Načítajte výsledky pre všetky typy obohatenia naraz alebo pre jeden typ.
● ● ●
Koncové body
POST /enrichment/{accountRegNo}/invoice
POST /enrichment/{accountRegNo}/categorisation
GET /enrichment/{accountRegNo}/{pollingId}
GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}
Pieskovisko sa nachádza na api-test.qvalia.com a výroba v api.qvalia.com. Žiadosti sa overujú pomocou kľúča API alebo JWT z rozhrania API účtu.
Kde sa výsledky využívajú
- Záväzky: Potvrdené kódovanie účtov sa spolu s faktúrou prenáša do schvaľovacieho procesu a zaúčtovania.
- Katalógy a cenníky: doplňte kódy UNSPSC k položkám, ktoré ich nemajú.
- Analýza výdavkov: skupinové nákupy podľa segmentu UNSPSC, skupiny a triedy v rámci jednotlivých dodávateľov.
- Vaša vlastná platforma: zobrazujte odporúčania a klasifikácie vo vašom vlastnom rozhraní.
Prístup
Za rozhranie Enrichment API sa účtuje osobitne a vyžaduje si dodatočné oprávnenia. Podpora spoločnosti Qvalia aktivuje obohatenia, ktoré váš účet využíva.
