Rechnung verarbeiten (eigenes Format)
Erforderliche Berechtigungen: invoices:write
Verarbeitet ein benutzerdefiniertes Rechnungsformat mittels GPT/KI-Parsing. Akzeptiert PDF- oder TIFF-Dateien bis zu 32MiB und verarbeitet sie mittels generativer KI zur Rechnungsdatenextraktion.
Optionale Request-Header können vordefinierte Werte für Lieferant, Projekt und externe Dokument-ID übergeben und damit die von der KI extrahierten Felder überschreiben.
Der API-Schlüssel muss mit einem Lieferanten verknüpft sein.
Akzeptiert entweder einen einzelnen rohen PDF-/TIFF-Body (Legacy) oder multipart/form-data
mit optionalem xml-Teil und einem oder mehreren pdf-Teilen. Bei XML laufen die
automatisierten Prüfungen auf dem XML; die PDF(s) dienen der Visualisierung (mehrere PDFs werden gemerged).
Übersicht
Verarbeitet Rechnungen als PDF- oder TIFF-Datei mit KI-gestützter Datenextraktion. Optionale Request-Header können vordefinierte Werte für Lieferant, Projekt und externe Dokument-ID übergeben und damit die von der KI extrahierten Felder überschreiben. Akzeptiert entweder einen einzelnen rohen PDF-/TIFF-Body (Legacy) odermultipart/form-data mit optionalem xml-Teil und einem oder mehreren pdf-Teilen. Bei XML laufen die automatisierten Prüfungen auf dem XML; die PDF(s) dienen der Visualisierung (mehrere PDFs werden gemerged).
Berechtigungen
Header
Verhalten der Preset-Header
kreditornamesetztsupplier_namein der Rechnungsverarbeitung.projektsetztproject_number. Wennprojektfehlt oder leer ist, wird stattdessenHQ-{buchungskreis}verwendet (sofernbuchungskreisgesetzt ist).archivdocumentwird als externe Rechnungs-ID (external_id) gespeichert.
Beispiel (Legacy PDF-Body)
Beispiel (multipart mit XML + PDF)
Autorisierungen
API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.
Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.
Header
Lieferantenname; überschreibt den von der KI extrahierten Lieferantennamen
Externe Dokument-ID für Archivierungszwecke; wird als external_id der Rechnung gespeichert
Projektnummer; überschreibt die von der KI extrahierte Projektzuordnung
Buchungskreis (juristische Einheit); Fallback für die Projektnummer, wenn projekt leer ist (HQ-{buchungskreis})
Abfrageparameter
Initialer Rechnungsstatus. Wird nur für Mandanten ohne Invoice-Workflows-Feature ausgewertet; sonst ignoriert.
NEW, PROCESSING, FACTUAL_CHECKING, PRICE_CHECKING, POSITIONS_CHECK, CHECKED, CANCELLED, ERROR, OPEN Body
Rohe PDF-Rechnungsdaten (Legacy, bis zu 32MiB)
Antwort
Rechnung erfolgreich verarbeitet und zur Hintergrundverarbeitung eingereiht