Fehler und Statuscodes

Interne Validierung

Interne Validierungsfehler treten auf, wenn die in einer Anfrage gesendeten Daten nicht dem erwarteten Format oder Schema der API entsprechen. Wenn beispielsweise ein Feld einen bestimmten Wertetyp erwartet, etwa eine bestimmte Aufzählung (z. B. „1” für Herr, „2” für Frau, „3” für Divers) oder eine erforderliche Struktur, löst jede Abweichung davon einen Validierungsfehler aus.

Externe Validierung

Falls die externe Validierung über ERiC/ELSTER fehlschlägt, kann die Fehlermeldung über den Endpunkt Download ERiC/ELSTER transmission XML abgerufen werden. Beachten Sie, dass die XML-Datei mehrere Fehler enthalten kann.

Wichtig: Die XML-Datei ist die Rohantwort von ERiC/ELSTER. Die fiskaly SIGN DE x Submission API interpretiert die Antwort nicht.

Status 2xx

Statuscodes im Bereich 200–299 zeigen Erfolg an.

Status 4xx

Statuscodes im Bereich 400–499 zeigen Fehler an, die durch die anfragende Anwendung verursacht wurden (z. B. wurde ein fehlerhafter Anfragekörper gesendet). Das Wiederholen solcher Anfragen mit demselben Anfragekörper ist sinnlos und führt zum gleichen Statuscode. Einige 4xx-Fehler können programmatisch behandelt werden. Die Fehlerantwort liegt im JSON-Format vor und ist wie folgt aufgebaut:

{
  "status_code": 400,
  "error": "Bad Request",
  "code": "E_SOME_ERROR",
  "message": "Something bad happened"
}

Die Antwort enthält einen Fehlercode oder andere Informationen, die den Grund für den Fehler erläutern. Passen Sie die Anfrage entsprechend an, bevor Sie sie erneut senden. Nachfolgend finden Sie die häufigsten Fehler und deren Behebung.

• 401 Unauthorized
  • E_UNAUTHORIZED_ACCESS
    • API authentifizieren
• 403 Forbidden
  • E_ACCESS_FORBIDDEN
• 404 Ressource existiert nicht
  • E_ESTABLISHMENT_NOT_FOUND
  • E_TAXPAYER_NOT_FOUND
  • E_TAXPAYER_ADDRESS_NOT_FOUND
  • E_TAXPAYER_PERSON_NOT_FOUND
  • E_SUBMISSION_NOT_FOUND
  • E_CLIENT_NOT_FOUND
  • E_CLIENT_ADDITIONAL_DATA_NOT_FOUND
• 409 Conflict
• 423 Locked
  • E_LOCKED_RESOURCE

Status 5xx

Statuscodes im Bereich 500–599 zeigen Fehler auf der Serverseite an. Diese Fehler können als vorübergehend betrachtet werden.