Skip to main content
POST
Rechnung im benutzerdefinierten Format verarbeiten

Ü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) 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).

Berechtigungen

Der API-Schlüssel muss mit einem Lieferanten verknüpft sein.

Verhalten der Preset-Header

  • kreditorname setzt supplier_name in der Rechnungsverarbeitung.
  • projekt setzt project_number. Wenn projekt fehlt oder leer ist, wird stattdessen HQ-{buchungskreis} verwendet (sofern buchungskreis gesetzt ist).
  • archivdocument wird als externe Rechnungs-ID (external_id) gespeichert.

Beispiel (Legacy PDF-Body)

Beispiel (multipart mit XML + PDF)

Autorisierungen

X-API-Key
string
header
erforderlich

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

kreditorname
string

Lieferantenname; überschreibt den von der KI extrahierten Lieferantennamen

archivdocument
string

Externe Dokument-ID für Archivierungszwecke; wird als external_id der Rechnung gespeichert

projekt
string

Projektnummer; überschreibt die von der KI extrahierte Projektzuordnung

buchungskreis
string

Buchungskreis (juristische Einheit); Fallback für die Projektnummer, wenn projekt leer ist (HQ-{buchungskreis})

Abfrageparameter

status
enum<string>

Initialer Rechnungsstatus. Wird nur für Mandanten ohne Invoice-Workflows-Feature ausgewertet; sonst ignoriert.

Verfügbare Optionen:
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

invoiceId
string
erforderlich

Eindeutige ID der erstellten Rechnung

Beispiel:

"invoice-abc123def456"

success
boolean
erforderlich
Beispiel:

true

jobId
string

Job-ID zur Nachverfolgung der Hintergrundverarbeitung

Beispiel:

"job-789xyz012"