Die Enrichment-API ergänzt Lieferantenrechnungen und Produktdaten um strukturierte Daten. Sie umfasst zwei Funktionen: Buchungsvorschläge, die für jede Position einer Lieferantenrechnung eine Kontierung vorschlagen, und die Produktklassifizierung, die Rechnungspositionen sowie Produkten in Katalogen und Preislisten UNSPSC-Codes zuordnet.
| Anreicherung | Was Sie senden | Was Sie dafür erhalten |
| Vorschläge für Beiträge | Eine Lieferantenrechnung | Vorgeschlagene Kontierung pro Rechnungszeile, bitte von Ihrem Team bestätigen lassen |
| Produktklassifizierung | Produkte mit eigener ID und einem Produktnamen oder Rechnungspositionen | Ein UNSPSC-Code für jedes Produkt, der zusammen mit Ihrer ID zurückgegeben wird |
| Erfassung (Unterstützungsschritt) | Eine PDF-Rechnung | Kopfdaten und Rechnungspositionen als strukturierte Daten |
„Capture“ wandelt eine PDF-Rechnung in strukturierte Daten um, damit die Anreicherungsfunktionen mit Daten arbeiten können. Rechnungen, die als Peppol- oder andere XML-Dokumente eingehen, überspringen diesen Schritt. „Capture“ ist auch eigenständig als OCR-API verfügbar.
So funktioniert eine Anfrage
- Senden Sie eine POST-Anfrage an den Endpunkt für Rechnungen oder die Kategorisierung.
- Speichern Sie die in der Antwort zurückgegebene Abfrage-ID.
- Rufen Sie das Ergebnis mit einer GET-Anfrage ab, jedoch nicht öfter als einmal alle 30 Sekunden.
- Rufen Sie die Ergebnisse für alle Anreicherungstypen auf einmal oder für einen einzelnen Typ ab.
● ● ●
Endpunkte
POST /enrichment/{accountRegNo}/invoice
POST /enrichment/{accountRegNo}/categorisation
GET /enrichment/{accountRegNo}/{pollingId}
GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType}Die Sandkiste befindet sich an api-test.qvalia.com und die Produktion bei api.qvalia.com. Anfragen werden mit einem API-Schlüssel oder einem JWT aus der Account-API authentifiziert.
Wo die Ergebnisse verwendet werden
- Kreditorenbuchhaltung: Die bestätigte Kontierung wird zusammen mit der Rechnung in den Genehmigungs- und Buchungsprozess übernommen.
- Kataloge und Preislisten: Fügen Sie den Artikeln, bei denen noch keine UNSPSC-Codes vorhanden sind, diese hinzu.
- Ausgabenanalyse: Gruppeneinkäufe nach UNSPSC-Segment, -Familie und -Klasse, aufgeschlüsselt nach Lieferanten.
- Ihre eigene Plattform: Zeigen Sie Empfehlungen und Einstufungen in Ihrer eigenen Benutzeroberfläche an.
Zugang
Die Enrichment-API wird separat abgerechnet und erfordert zusätzliche Berechtigungen. Der Qvalia-Support aktiviert die von Ihrem Konto genutzten Anreicherungen.
Siehe auch: So funktionieren Veröffentlichungsvorschläge · So funktioniert die UNSPSC-Klassifizierung · So funktioniert die PDF-Erfassung · API-Referenz
