Guide · Mis à jour en mai 2026

Export Markdown

Messages d’erreur API et automatisation

Codes d’erreur d’intégration courants expliqués pour les utilisateurs non techniques.

À 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 non valide pour ce compte ou cet endpoint.	Créez ou copiez la bonne clé.
RATE_LIMITED	Trop de requêtes ont été envoyées en peu de temps.	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.