# Automatisierung der PDF-zu-E-Rechnung-Konvertierung in großem Maßstab per API

Automatisieren Sie die PDF-zu-E-Rechnung-Konvertierung mit hohem Durchsatz, konfigurieren Sie asynchrones Polling, verwalten Sie Webhook-Ereignisse und verarbeiten Sie mehrere Dateien programmatisch.

## Wichtige Integrationsschritte

- Fordern Sie einen Produktions-API-Schlüssel über das Entwickler-Dashboard an.
- Authentifizieren Sie alle Anfragen über den `Authorization`-Header mit einem `Bearer`-Token.
- Senden Sie eine `POST`-Anfrage an `/api/v1/convert` mit der PDF-Datei und den Compliance-Profilparametern.
- Verarbeiten Sie die asynchrone Task-Antwort und fragen Sie den Status ab (Polling) oder warten Sie auf Webhooks.
- Rufen Sie das validierte `XRechnung`-, `ZUGFeRD`- oder `UBL`-XML-Ergebnis ab.

## Asynchrones Polling und Webhooks

Die Integration der E-Rechnungskonformität im großen Maßstab erfordert die Migration von manuellen Dateiuploads zu vollautomatischen, asynchronen API-Workflows. Invoice Converter bietet ein leistungsstarkes Backend, das für die Stapelverarbeitung mit hohem Durchsatz optimiert ist.

Für Umgebungen mit hohem Durchsatz empfehlen wir eine asynchrone Integration. Wenn Sie eine PDF-Datei hochladen, gibt die API sofort den Status 202 Accepted mit einer eindeutigen Task-ID zurück.

Ihr System kann entweder alle paar Sekunden den Task-Status-Endpunkt unter `GET` `/api/v1/tasks/{id}` abfragen oder eine Webhook-URL registrieren, um eine automatische `POST`-Benachrichtigung zu erhalten, sobald die Konvertierung abgeschlossen ist.

## Best Practices für Skalierung

- Geben Sie immer ein explizites Compliance-Profil wie `XRechnung` oder `ZUGFeRD` an, 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.
- Aktivieren Sie die Webhook-Signaturverifizierung, um sicherzustellen, dass eingehende Ereignisse von Invoice Converter stammen.