Skip to main content
POST
Rechnung im benutzerdefinierten Format verarbeiten

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) or multipart/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

The API key must be linked to a supplier.

Headers

Preset header behavior

  • kreditorname sets supplier_name during invoice processing.
  • projekt sets project_number. If projekt is missing or empty, HQ-{buchungskreis} is used instead (when buchungskreis is set).
  • archivdocument is stored as the invoice external ID (external_id).

Example (legacy PDF body)

Example (multipart with XML + PDF)

Authorizations

X-API-Key
string
header
required

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

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})

Query Parameters

status
enum<string>

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

Available options:
NEW,
PROCESSING,
FACTUAL_CHECKING,
PRICE_CHECKING,
POSITIONS_CHECK,
CHECKED,
CANCELLED,
ERROR,
OPEN

Body

Rohe PDF-Rechnungsdaten (Legacy, bis zu 32MiB)

Response

Rechnung erfolgreich verarbeitet und zur Hintergrundverarbeitung eingereiht

invoiceId
string
required

Eindeutige ID der erstellten Rechnung

Example:

"invoice-abc123def456"

success
boolean
required
Example:

true

jobId
string

Job-ID zur Nachverfolgung der Hintergrundverarbeitung

Example:

"job-789xyz012"