Guide · 2026-05-16
Export MarkdownMessages 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.
Articles associés
Intégrez la conversion par API : obtenez l’accès, envoyez avec une clé d’idempotence, suivez la tâche et téléchargez le résultat.
Convertir des factures par e-mail : mode d’emploiConvertissez des PDF par e-mail : activez le canal Enterprise, vérifiez les expéditeurs, choisissez le format et contrôlez la réponse.
Checklist d’intégration ERP pour l’e-facturation et les déploiements modernesChecklist pratique d’intégration ERP pour les projets e-facturation : mapping, choix du format, validation, gestion des exceptions et contrôles de mise en