Databeriknings-API:t (Enrichment API) lägger till strukturerad data i leverantörsfakturor och produktdata. Det har två berikningar: konteringsförslag, som föreslår kontering för varje rad i en leverantörsfaktura, och produktklassificering, som sätter UNSPSC-koder på fakturarader och på produkter i kataloger och prislistor.
| Berikning | Det här skickar ni | Det här får ni tillbaka |
| Konteringsförslag | En leverantörsfaktura | Förslag på kontering per fakturarad, som ert team bekräftar |
| Produktklassificering | Produkter med ert eget id och ett produktnamn, eller fakturarader | En UNSPSC-kod per produkt, tillsammans med ert id |
| Datafångst (stödsteg) | En PDF-faktura | Huvuduppgifter och fakturarader som strukturerad data |
Datafångsten gör om en PDF-faktura till strukturerad data, så att berikningarna har data att arbeta med. Fakturor som kommer som Peppol- eller andra XML-dokument behöver inte det steget. Datafångsten finns också som en egen tjänst, OCR API.
Så fungerar ett anrop
- Skicka ett POST-anrop till endpointen för fakturor (
invoice) eller för klassificering (categorisation). - Spara polling-id:t som kommer i svaret.
- Hämta resultatet med ett GET-anrop, högst en gång var 30:e sekund.
- Hämta resultaten för alla berikningstyper på en gång eller för en typ i taget.
● ● ●
Endpoints
POST /enrichment/{accountRegNo}/invoice
POST /enrichment/{accountRegNo}/categorisation
GET /enrichment/{accountRegNo}/{pollingId}
GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}
Testmiljön finns på api-test.qvalia.com och produktionsmiljön på api.qvalia.com. Anropen autentiseras med en API-nyckel eller en JWT från Account API.
Där resultaten används
- Leverantörsfakturor: den bekräftade konteringen följer med fakturan till attest och bokföring.
- Kataloger och prislistor: lägg till UNSPSC-koder på artiklar som saknar dem.
- Spendanalys: gruppera inköp per UNSPSC-segment, familj och klass över alla leverantörer.
- Er egen plattform: visa förslag och klassificeringar i ert eget gränssnitt.
Åtkomst
Databeriknings-API:t faktureras separat och kräver extra behörigheter. Qvalias support aktiverar de berikningar ert konto ska använda.
