Erreurs et codes de statut

Validation interne

Les erreurs de validation interne se produisent lorsque les données envoyées dans une requête ne sont pas conformes au format ou au schéma attendu défini par l’API. Par exemple, si un champ attend un type de valeur spécifique, comme une énumération particulière (p. ex., “1” pour Herr, “2” pour Frau, “3” pour Divers) ou une structure requise, toute divergence par rapport à cela déclenchera une erreur de validation.

Validation externe

En cas d’échec de la validation externe via ERiC/ELSTER, le message d’erreur peut être récupéré via l’endpoint Download ERiC/ELSTER transmission XML. Notez que le XML peut contenir plusieurs erreurs.

Important : Le XML est la réponse brute envoyée par ERiC/ELSTER. L’API SIGN DE x Submission de fiskaly n’interprète pas la réponse.

Statut 2xx

Les codes de statut dans la plage 200–299 indiquent un succès.

Statut 4xx

Les codes de statut dans la plage 400–499 indiquent des erreurs causées par l’application requérante (p. ex., un corps de requête malformé a été envoyé). Réessayer ces requêtes avec le même corps de requête est inutile et donnera le même code de statut. Certaines erreurs 4xx peuvent être gérées par programmation. La réponse d’erreur est au format JSON et est structurée comme suit :

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

La réponse contiendra un code d’erreur ou d’autres informations révélant la raison de l’erreur. Modifiez la requête en conséquence avant de réessayer. Vous trouverez ci-dessous les erreurs les plus fréquentes et comment les résoudre.

• 401 Unauthorized
  • E_UNAUTHORIZED_ACCESS
    • Authentifier l’API
• 403 Forbidden
  • E_ACCESS_FORBIDDEN
• 404 La ressource n’existe pas
  • 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

Statut 5xx

Les codes de statut dans la plage 500–599 indiquent des erreurs côté serveur. Ces erreurs peuvent être considérées comme temporaires.