Ergänzungen
Buchung und Kontierung
Pro Dokument angefordert
Unterstützungsschritt
Erfassen Sie
PDF-Rechnungen in strukturierte Daten
Taxonomie
UNSPSC
Pro Produkt-ID zurückgegebene Ergebnisse
Verarbeitung
Asynchron
Abfrage höchstens alle 30 Sekunden
Vorschläge für Beiträge und UNSPSC-Klassifizierung
Die Erfassung und Klassifizierung sind die Erweiterungen. Die Erfassung ist der Schritt, bei dem eine PDF-Rechnung in strukturierte Daten umgewandelt wird, damit beide Prozesse ausgeführt werden können.
Vorschläge für Beiträge
Vorschläge für die Kontierung jeder Zeile einer Lieferantenrechnung, die auf der Grundlage der Buchungshistorie Ihres Unternehmens generiert werden. Ihr Team bestätigt jeden Vorschlag.
Produktklassifizierung
UNSPSC-Codes für Rechnungspositionen sowie für Produkte aus Katalogen und Preislisten, die jeweils mit einer eigenen ID zurückgegeben werden.
Erfassung als Unterstützung
Wenn eine Rechnung als PDF eingeht, erfasst Capture zunächst Auszüge aus den Kopfdaten und den Einzelposten, damit für die Buchung und Zuordnung strukturierte Daten zur Verfügung stehen.
Ergebnisse erfassen
Jede Anfrage gibt eine Abfrage-ID zurück. Erfassen Sie das Ergebnis nach Anreicherungstyp und führen Sie die Abfrage höchstens einmal alle 30 Sekunden durch.
Eine Produktliste in zwei Anfragen aufteilen
Senden Sie Produktnamen mit Ihren eigenen IDs, beispielsweise Artikel aus einem Katalog, einer Preisliste oder Ihrem Artikelverzeichnis. In der Antwort erhalten Sie eine Abfrage-ID, und das Ergebnis enthält jede Produkt-ID mit der zugehörigen UNSPSC-Klassifizierung.
- Ihre Produkt-IDs werden im Ergebnis ausgegeben.
- Authentifizieren Sie sich mit einem API-Schlüssel oder einem JWT aus der Account-API
- Nicht öfter als einmal alle 30 Sekunden abfragen
- Getrennte Basis-URLs für Sandbox und Produktion
● ● ●
Sandbox-Anfrage: Produkte klassifizieren
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"Endpunkte der Anreicherung
Alle Pfade beziehen sich auf die Basis-URL der Sandbox oder der Produktionsumgebung und sind auf Ihre Kontoregistrierungsnummer beschränkt.
| Anfrage | Endpunkt | Rücksendungen |
| Eine Rechnung ergänzen | POST /enrichment/{accountRegNo}/invoice | Umfrage-ID |
| Produkte klassifizieren | POST /enrichment/{accountRegNo}/categorisation | Umfrage-ID |
| Alle Ergebnisse anzeigen | GET /enrichment/{accountRegNo}/{pollingId} | Status bzw. Ergebnisse nach Typ |
| Ein Ergebnis anzeigen | GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType} | Erfassungs-, Buchungs- oder Klassifizierungsergebnis |
Sandkasten: api-test.qvalia.com. Produktion: api.qvalia.com. Die Enrichment-API wird separat abgerechnet, und der Qvalia-Support aktiviert die von Ihrem Konto genutzten Anreicherungen.
Wo angereicherte Daten verwendet werden
Die Eingabe von Vorschlägen und UNSPSC-Codes speist andere Prozesse – sei es auf Ihrer eigenen Plattform oder in Qvalia.
- Kreditorenbuchhaltung
Die bestätigte Kontenzuordnung wird bei der Genehmigung und Buchung der Rechnung übernommen. - Kataloge und Preislisten
Fügen Sie den Artikeln im Katalog und in der Preisliste, denen noch ein UNSPSC-Code fehlt, einen solchen hinzu. - Mit den UNSPSC-Codes von „
“ zur Ausgabenanalyse können Sie Einkäufe nach Segment, Produktfamilie und Produktklasse über verschiedene Lieferanten hinweg gruppieren. - Ihre eigene Plattform
Geben Sie Ihren Nutzern Suchergebnisse und Klassifizierungen in Ihrer eigenen Benutzeroberfläche zurück.
Wählen Sie Ihren Ausgangspunkt
Beitrag
Rechnungswesen-API
Wie Beitragsvorschläge von Ihrem Team geschult, geprüft und bestätigt werden.
Produktdaten
UNSPSC-Klassifizierung
Wie Qvalia Rechnungspositionen und Produktdaten anhand der UNSPSC klassifiziert.
Erfassen Sie
OCR-API
Der Erfassungsschritt allein, mit einem kostenlosen Test für Ihre eigene PDF-Rechnung.
Häufig gestellte Fragen zur Enrichment-API
Was ist die Enrichment-API?
Eine REST-API mit zwei Erweiterungsfunktionen: Buchungsvorschläge für Lieferantenrechnungen und UNSPSC-Klassifizierung von Rechnungspositionen und Produkten. „Capture“ ist ein unterstützender Schritt, bei dem PDF-Rechnungen vor der Buchung und Klassifizierung in strukturierte Daten umgewandelt werden.
Warum ist die Erfassung ein unterstützender Schritt?
Buchungs- und Klassifizierungsvorgänge für strukturierte Daten. Rechnungen, die als Peppol- oder andere XML-Dokumente eingehen, verfügen bereits über diese Daten. Eine PDF-Rechnung wird zunächst erfasst, damit ihre Kopfdaten und Einzelposten gebucht und klassifiziert werden können. Die Erfassung ist auch separat über die OCR-API möglich.
Wie funktionieren Beitragsvorschläge?
Sie werden anhand von Rechnungen trainiert, die Ihr Unternehmen bereits verbucht hat. Für jede neue Lieferantenrechnung werden pro Zeile Kontierungsvorschläge gemacht, die Ihr Team dann bestätigt. Weitere Informationen finden Sie auf der Seite zur Buchhaltungs-API.
Kann ich Kataloge und Preislisten klassifizieren?
Ja. Der Klassifizierungsauftrag erwartet eine Liste von Produkten, die jeweils eine eigene ID und einen Produktnamen enthalten. Daher werden Artikel aus einem Katalog, einer Preisliste, einem Artikelverzeichnis oder Rechnungspositionen auf dieselbe Weise übermittelt.
Welche Taxonomie wird bei der Klassifizierung verwendet?
UNSPSC. Das Ergebnis enthält jede Produkt-ID mit ihrer Klassifizierung, sodass Sie diese mit Ihren eigenen Datensätzen abgleichen können.
Gibt es eine Sandkiste?
Ja. Verwenden Sie „api-test.qvalia.com“ für Testzwecke und „api.qvalia.com“ im Produktivbetrieb.
Ist die Enrichment-API in anderen Qvalia-APIs enthalten?
Nein. Die Enrichment-API wird separat abgerechnet und erfordert zusätzliche Berechtigungen. Der Qvalia-Support aktiviert die von Ihrem Konto genutzten Anreicherungen.
