Zum Hauptinhalt springen
Rechnungen per API konvertieren: einfache Anleitung
Blog

Rechnungen per API konvertieren: einfache Anleitung

1 Min. LesezeitGeprüft: 29. August 2026
Markdown-Export

Offizielle Quellen

Nutzen Sie diese Quellen, um Fristen, Formate und offizielle Regeländerungen zu prüfen.

Passendes technisches Wiki

Erkunden Sie detaillierte Entwickler-Dokumentationen und regulatorische Leitfäden passend zu diesem Artikel.

API- und Automatisierungsfehlermeldungen

Häufige Integrationsfehlercodes verständlich für nichttechnische Nutzer erklärt.

ERP-Export-Validierungsleitfäden

Praxisleitfäden zur Validierung von DATEV-, Lexware-, SAP Business One-, Odoo- und Microsoft-Dynamics-Rechnungsexporten.

E-Rechnungs-Codelisten

Häufige Codelisten für E-Rechnungen: USt-Kategorien, Zahlungsmittel, Einheiten und Rechnungstypen.

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

Interaktiver Ablauf

Starten Sie die Wiedergabe oder klicken Sie einen Schritt an, um eine Rechnung durch diesen Kanal zu verfolgen.

Ausgabe:XRechnungZUGFeRDEN 16931UBLCII

Verarbeitungsstufe

Schritt 1 von 6SieEinmalige Einrichtung

API-Schlüssel anlegen

Mit einem aktiven Enterprise-Abo legen Sie den Schlüssel im Profil an. Bewahren Sie ihn auf Ihrem Server auf.

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. Schritte wie in diesem Leitfaden und der Spezifikation der External API V1 beschrieben. Stand: Oktober 2026.
  1. Erstellen Sie mit einem aktiven Enterprise-Tarif einen API-Schlüssel in Ihrem Profil.
  2. Senden Sie die Quelle mit Zielformat und Idempotency-Key an POST /api/v1/invoices:convert.
  3. Speichern Sie die zurückgegebene Task-ID.
  4. Fragen Sie GET /api/v1/tasks/{task_id} mit wachsendem Abstand ab, bis ein Endstatus vorliegt.
  5. 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.

Häufige Fragen

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.

Developer API ansehen

Lesen Sie Authentifizierung, Endpunkte, Beispiele, Limits und Fehler.

E-Rechnungs-API

Verwandte Artikel