# API- und Automatisierungsfehlermeldungen

Common integration error codes explained for non-technical users.

## 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 stammt aus der falschen Umgebung. | Erstellen oder kopieren Sie den richtigen Schlüssel. |
| RATE_LIMITED | Too many requests were sent in a short period. | 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.