De Enrichment API voegt gestructureerde gegevens toe aan leveranciersfacturen en productgegevens. De API biedt twee soorten verrijking: boekingssuggesties, waarbij voor elke regel van een leveranciersfactuur een rekeningcode wordt voorgesteld, en productclassificatie, waarbij UNSPSC-codes worden toegewezen aan factuurregels en aan producten in catalogi en prijslijsten.
| Verrijking | Wat je verstuurt | Wat je ervoor terugkrijgt |
| Suggesties plaatsen | Een leveranciersfactuur | Voorgestelde boekingscode per factuurregel, ter bevestiging door uw team |
| Productclassificatie | Producten met een eigen ID en een productnaam, of factuurregels | Een UNSPSC-code voor elk product, samen met uw ID |
| Vastleggen (ondersteunende stap) | Een factuur in PDF-formaat | Kopgegevens en factuurregels als gestructureerde gegevens |
Capture zet een PDF-factuur om in gestructureerde gegevens, zodat de verrijkingsmodules over gegevens beschikken om mee te werken. Facturen die binnenkomen als Peppol- of andere XML-documenten, slaan deze stap over. Capture is ook afzonderlijk beschikbaar als OCR-API.
Hoe een verzoek in zijn werk gaat
- Stuur een POST-verzoek naar het eindpunt voor facturen of categorisering.
- Sla het polling-ID op dat in het antwoord is teruggestuurd.
- Haal het resultaat op via een GET-verzoek, niet vaker dan eens per 30 seconden.
- Haal de resultaten voor alle verrijkingstypen in één keer op, of voor één type.
● ● ●
Eindpunten
POST /enrichment/{accountRegNo}/invoice
POST /enrichment/{accountRegNo}/categorisation
GET /enrichment/{accountRegNo}/{pollingId}
GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}De zandbak staat bij api-test.qvalia.com en productie bij api.qvalia.com. Verzoeken worden geauthenticeerd met een API-sleutel of een JWT van de Account-API.
Waar de resultaten worden gebruikt
- Crediteuren: de bevestigde rekeningcodering wordt samen met de factuur doorgestuurd naar de goedkeurings- en boekingsprocedure.
- Catalogi en prijslijsten: voeg UNSPSC-codes toe aan artikelen waarvoor deze nog ontbreken.
- Uitgavenanalyse: groepsinkopen per UNSPSC-segment, -familie en -klasse, uitgesplitst per leverancier.
- Je eigen platform: toon suggesties en categorieën in je eigen interface.
Toegang
De Enrichment API wordt apart in rekening gebracht en vereist aanvullende machtigingen. De ondersteuning van Qvalia zorgt ervoor dat de verrijkingen die uw account gebruikt, worden ingeschakeld.
Zie ook: Hoe suggesties voor berichten werken · Hoe de UNSPSC-classificatie werkt · Hoe het vastleggen van PDF-bestanden werkt · API-referentie
