Leitfaden · Aktualisiert im Mai 2026
Markdown-ExportAutomatisierung der PDF-zu-E-Rechnung-Konvertierung in großem Maßstab per API
Automatisieren Sie die PDF-zu-E-Rechnung-Konvertierung über die API, konfigurieren Sie asynchrones Status-Polling und verarbeiten Sie mehrere Rechnungen programmatisch, mit einer Konvertierungsanfrage pro Rechnung.
Wichtige Integrationsschritte
Nutzen Sie diese Punkte als praktische Prüfschritte für diesen Abschnitt.
- Fordern Sie einen Produktions-API-Schlüssel über das Entwickler-Dashboard an.
- Authentifizieren Sie alle Anfragen über den
Authorization-Header mit einemBearer-Token. - Senden Sie eine
POST-Anfrage an/api/v1/invoices:convertmit der PDF-Datei und den Compliance-Profilparametern. - Verarbeiten Sie die asynchrone Task-Antwort und fragen Sie
GET/api/v1/tasks/{task_id}ab, bis die Konvertierung abgeschlossen ist oder fehlschlägt. - Rufen Sie das validierte
XRechnung-,ZUGFeRD- oderUBL-XML-Ergebnis ab.
Asynchrones Status-Polling
Die Integration der E-Rechnungskonformität im großen Maßstab bedeutet, Einreichung und Abruf über die API zu automatisieren. Jede Anfrage konvertiert genau eine Rechnung, und konvertierte Ergebnisse sollten bei Grenzfällen und Quelldokumenten geringer Qualität weiterhin Ihren üblichen Prüf- und Ausnahmeprozess durchlaufen.
Die API arbeitet asynchron: Wenn Sie eine PDF-Datei hochladen, gibt sie sofort den Status 202 Accepted mit einer eindeutigen Task-ID zurück.
Ihr System fragt den Task-Status-Endpunkt unter GET /api/v1/tasks/{task_id} alle 10 bis 15 Sekunden ab, bis der Task als abgeschlossen oder fehlgeschlagen gemeldet wird. Die API bietet keine Webhooks; über das Polling erfährt Ihr System, wann eine Konvertierung fertig ist.
Best Practices für Skalierung
Nutzen Sie diese Punkte als praktische Prüfschritte für diesen Abschnitt.
- Geben Sie immer ein explizites Compliance-Profil wie
XRechnungoderZUGFeRDan, um Verzögerungen durch die automatische Erkennung zu vermeiden. - Implementieren Sie ein exponentielles Backoff beim Polling des Task-Status, um unnötige Ratenbegrenzungen (Rate Limits) zu vermeiden.
- Speichern Sie die zurückgegebenen Task-UUIDs in Ihrer lokalen Datenbank, um eine einfache Rückverfolgbarkeit und Audit-Protokollierung zu gewährleisten.
- Senden Sie pro Rechnung einen stabilen
Idempotency-Key-Header, damit erneute Versuche keine doppelten Konvertierungen erzeugen.