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

> **Konvertieren, abfragen, herunterladen**
>
> Die External API arbeitet asynchron: Ihr System legt eine Aufgabe an, fragt ihren Status ab und lädt das validierte Ergebnis herunter. 1. API-Schlüssel anlegen: Mit einem aktiven Enterprise-Abo legen Sie den Schlüssel im Profil an. Bewahren Sie ihn auf Ihrem Server auf. 2. Quelle senden: Laden Sie eine PDF, DOCX oder TXT mit Zielformat und Idempotenzschlüssel hoch. Ein Weg für strukturierte Eingaben steht ebenfalls bereit. 3. Task-ID speichern: Die API antwortet sofort mit einer Task-ID. Die Rechnung wird im Hintergrund konvertiert. 4. Mit Backoff abfragen: Fragen Sie den Status mit wachsenden Abständen ab, bis er abgeschlossen oder fehlgeschlagen ist. Eine Aufgabe ist erst abgeschlossen, wenn die Datei die Validierung für das angefragte Profil bestanden hat. 5. Datei und Bericht herunterladen: Rufen Sie das Ergebnis und seinen Validierungsbericht ab. 6. Fehler an einen Menschen leiten: Leiten Sie Validierungsfehler in die Korrektur, statt sie unverändert erneut zu senden. Ausgabe: XRechnung, ZUGFeRD, EN 16931, UBL, CII.

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