Rechnungen per API konvertieren: einfache Anleitung
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.
Häufige Integrationsfehlercodes verständlich für nichttechnische Nutzer erklärt.
Praxisleitfäden zur Validierung von DATEV-, Lexware-, SAP Business One-, Odoo- und Microsoft-Dynamics-Rechnungsexporten.
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
- 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.
Bereit, Ihre Rechnungen umzuwandeln?
Wandeln Sie PDF-Rechnungen in XRechnung, ZUGFeRD und weitere Formate um. Abos ab 10 €/Monat bei jährlicher Abrechnung (zzgl. Steuern), mit 3-tägiger Testphase beim ersten Abo. Oder ohne Abo: 5 € pro Konvertierung (zzgl. Steuern).