Guide · Mis à jour en mai 2026
Export MarkdownMessages d’erreur API et automatisation
Common integration error codes explained for non-technical users.
À qui s’adresse cet article
Utilisez cet article lorsqu’un client voit une erreur provenant d’une intégration, d’une automatisation ou d’un traitement par lot et doit savoir quoi faire.
Messages courants
| Message ou code | Ce que cela signifie | Que faire |
|---|---|---|
| AUTHENTICATION_REQUIRED | La requête ne contenait pas de connexion utilisable ni de jeton bearer valide. | Reconnectez-vous ou ajoutez le jeton API manquant. |
| INVALID_API_KEY | La clé API est incorrecte, expirée, révoquée ou issue du mauvais environnement. | Créez ou copiez la bonne clé. |
| RATE_LIMITED | Too many requests were sent in a short period. | Attendez la fenêtre de nouvelle tentative, puis continuez plus lentement. |
| PAYLOAD_TOO_LARGE | Le fichier téléversé dépasse la limite de taille. | Compressez le PDF ou divisez le travail en factures plus petites. |
| INVALID_UPLOAD | Le fichier téléversé n’a pas pu être lu comme une entrée de facture valide. | Vérifiez que le fichier n’est pas vide, corrompu, protégé par mot de passe ou dans le mauvais format. |
| VALIDATION_FAILED | Les données de facture contiennent des problèmes bloquants. | Examinez les champs retournés et corrigez les données de facture avant de réessayer. |
| OUTPUT_PROFILE_REQUIRED | Le format de sortie demandé nécessite un profil de conformité plus clair. | Choisissez le profil prévu, par exemple XRechnung, EN 16931, ZUGFeRD ou Factur-X. |
| OUTPUT_PROFILE_CONFLICT | Le format choisi et le profil se contredisent. | Choisissez une cible de sortie cohérente et réessayez. |
Conseils de nouvelle tentative
Réessayez les erreurs temporaires comme les délais dépassés, les services indisponibles et certains échecs de téléversement.
Ne réessayez pas aveuglément les erreurs de validation, d’authentification, de limite de débit, de taille de fichier ou de profil. Elles nécessitent d’abord une correction.