Leitfaden · 2026-05-16
Markdown-ExportAPI- und Automatisierungsfehlermeldungen
Häufige Integrationsfehlercodes verständlich für nichttechnische Nutzer erklärt.
Für wen dieser Artikel ist
Nutzen Sie diesen Artikel, wenn ein Kunde einen Fehler aus einer Integration, Automatisierung oder Stapelverarbeitung sieht und wissen muss, was zu tun ist.
Häufige Meldungen
| Meldung oder Code | Was es bedeutet | Was zu tun ist |
|---|---|---|
| AUTHENTICATION_REQUIRED | Die Anfrage enthielt keine nutzbare Anmeldung und kein gültiges Bearer-Token. | Melden Sie sich erneut an oder ergänzen Sie das fehlende API-Token. |
| INVALID_API_KEY | Der API-Schlüssel ist falsch, abgelaufen, widerrufen oder für dieses Konto oder diesen Endpunkt nicht gültig. | Erstellen oder kopieren Sie den richtigen Schlüssel. |
| RATE_LIMITED | In kurzer Zeit wurden zu viele Anfragen gesendet. | Warten Sie das Retry-Fenster ab und fahren Sie anschließend langsamer fort. |
| PAYLOAD_TOO_LARGE | Die hochgeladene Datei überschreitet die Größenbegrenzung. | Komprimieren Sie das PDF oder teilen Sie die Arbeit in kleinere Rechnungen auf. |
| INVALID_UPLOAD | Die hochgeladene Datei konnte nicht als gültige Rechnungseingabe gelesen werden. | Prüfen Sie, ob die Datei nicht leer, beschädigt, passwortgeschützt oder im falschen Format ist. |
| VALIDATION_FAILED | Die Rechnungsdaten enthalten blockierende Probleme. | Prüfen Sie die zurückgegebenen Felder und korrigieren Sie die Rechnungsdaten vor dem nächsten Versuch. |
| OUTPUT_PROFILE_REQUIRED | Das angeforderte Ausgabeformat benötigt ein klareres Compliance-Profil. | Wählen Sie das vorgesehene Profil, zum Beispiel XRechnung, EN 16931, ZUGFeRD oder Factur-X. |
| OUTPUT_PROFILE_CONFLICT | Das gewählte Format und das Profil widersprechen sich. | Wählen Sie ein passendes Ausgabeziel und versuchen Sie es erneut. |
Hinweise zum erneuten Versuch
Versuchen Sie temporäre Fehler wie Zeitüberschreitungen, nicht verfügbare Dienste und manche Uploadfehler erneut.
Validierungs-, Authentifizierungs-, Rate-Limit-, Dateigrößen- oder Profilfehler sollten nicht blind erneut versucht werden. Sie benötigen zuerst eine Korrektur.
Verwandte Artikel
Rechnungskonvertierung per API integrieren: Zugang erhalten, Datei idempotent senden, Task abfragen, Ergebnis laden und Fehler behandeln.
Rechnungen per E-Mail konvertieren: So geht esPDF-Rechnungen per E-Mail konvertieren: Enterprise-Kanal aktivieren, Absender verifizieren, Format wählen, senden und Antwort prüfen.
ERP-Integrations-Checkliste für E-Rechnungen und moderne RolloutsPraxisnahe ERP-Checkliste für E-Rechnungsprojekte: Datenmapping, Formatwahl, Validierung, Ausnahmebehandlung und Go-live-Kontrollen.