Custom invoice upload
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).
Overview
Processes invoices as PDF or TIFF files with AI-assisted data extraction. Optional request headers can supply preset values for supplier, project, and external document ID, overriding fields extracted by the AI parser. Accepts either a single raw PDF/TIFF body (legacy) ormultipart/form-data with an optional xml part and one or more pdf parts. When XML is supplied, automated checks run on the XML while the PDF(s) are used for visualization (multiple PDFs are merged).
Permissions
Headers
Preset header behavior
kreditornamesetssupplier_nameduring invoice processing.projektsetsproject_number. Ifprojektis missing or empty,HQ-{buchungskreis}is used instead (whenbuchungskreisis set).archivdocumentis stored as the invoice external ID (external_id).
Example (legacy PDF body)
Example (multipart with XML + PDF)
Authorizations
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.
Headers
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})
Query Parameters
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)