# Rechnungen per API konvertieren: einfache Anleitung

- Date: 2026-07-29
- Modified: 2026-08-29
- Geprüft: 29. August 2026
- Reading time: 1 Min. Lesezeit

Rechnungskonvertierung per API integrieren: Zugang erhalten, Datei idempotent senden, Task abfragen, Ergebnis laden und Fehler behandeln.

> Geprüft anhand von Invoice-Converter-Developer-API, OASIS-UBL-2.1-Spezifikation.

Die Rechnungskonvertierungs-API verbindet ERP, Buchhaltung oder eine eigene Anwendung. Sie arbeitet asynchron: Ihr System erstellt einen Task, fragt den Status ab und lädt das Ergebnis herunter.

## Der API-Ablauf in fünf Schritten

- Erstellen Sie mit einem aktiven Enterprise-Tarif einen API-Schlüssel in Ihrem Profil.
- Senden Sie die Quelle mit Zielformat und Idempotency-Key an POST /api/v1/invoices:convert.
- Speichern Sie die zurückgegebene Task-ID.
- Fragen Sie GET /api/v1/tasks/{task_id} mit wachsendem Abstand ab, bis ein Endstatus vorliegt.
- Laden Sie Ergebnis und Validierungsbericht. Leiten Sie Validierungsfehler zur Korrektur statt zum unveränderten Retry.
## Eingaben und Formate

Der Upload-Endpunkt nimmt PDF, DOCX und TXT an. Für strukturierte Eingaben gibt es einen eigenen Endpunkt. Ziele sind unter anderem XRechnung, ZUGFeRD, EN 16931, UBL und CII. ZUGFeRD braucht eine PDF-Quelle.

## Wann die API passt

Nutzen Sie die API für wiederholbare System-zu-System-Abläufe mit Task-IDs, Idempotenz und expliziten Downloads. Für kontrollierte, kleine Mailbox-Abläufe gibt es den [E-Mail-Weg](/de/blog/invoice-conversion-by-email).

## FAQ

### Liefert die API die Rechnung sofort?

Nein. Sie liefert eine Task-ID. Die Integration fragt den Task ab und lädt das fertige Ergebnis.

### Gibt es Webhooks?

Der aktuelle Partner-Ablauf nutzt Statusabfragen mit wachsendem Abstand, keine Partner-Webhooks.

## Offizielle Quellen

- [Invoice-Converter-Developer-API](https://www.invoice-converter.com/en/developer-api)
- [OASIS-UBL-2.1-Spezifikation](https://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.html)
