Passer au contenu principal

Intégration - Résoudre une erreur d'API ou de fichier

Dans cet article, on vous explique ce que signifie le statut « En erreur » sur vos comptes API ou fichiers et comment résoudre le problème.

📝 Description

Découvrez la signification du statut « En erreur » pour votre compte API ou votre fichier sur Waltio, ainsi que les démarches à suivre pour résoudre le problème.

Ce statut indique que Waltio ne parvient plus à récupérer ou à lire correctement les données de la plateforme concernée. Vos données déjà importées ne sont pas supprimées, mais les nouvelles transactions ne seront plus synchronisées tant que la situation n'est pas régularisée.


⚠️ Warnings

  • Ne partagez jamais votre clé secrète ou votre clé API complète en dehors de nos canaux officiels : l'équipe Waltio peut vous la demander uniquement via le chat du site ou par e-mail à [email protected], au travers d'un moyen sécurisé.

  • Supprimer votre compte API ou fichier en erreur effacera toutes vos transactions ainsi que toutes les modifications que vous auriez pu apporter. Si vous avez apporté un nombre conséquent de modifications sur vos transactions, ne le supprimez pas : contactez plutôt l'équipe support afin de trouver une autre solution.

📂 Résolution d'un compte API en erreur

Une connexion API peut passer en erreur en cas de clé expirée, supprimée ou modifiée, de serveur distant indisponible ou de problème de synchronisation. Pour résoudre un dysfonctionnement lié à une API :

  1. Rendez-vous sur la page Comptes dans Waltio et consultez le message d’erreur affiché sur le compte concerné.

  2. Si le message indique que la clé a expiré ou que ses permissions ont changé, reconnectez-vous à la plateforme concernée.

  3. Supprimez ou désactivez l’ancienne clé API sur la plateforme si nécessaire, puis créez une nouvelle clé API. ⚠️ Attention : cela supprimera toutes les transactions et les modifications que vous avez apportées dessus (l'ajout de labels par exemple).

  4. Cliquez sur Ajouter un compte et renseignez la nouvelle connexion API dans Waltio.

  5. Si Waltio vous demande de Forcer la synchronisation, confirmez l’action.

  6. Vérifiez que le statut du compte repasse à l'état normal et que les dernières transactions apparaissent.

Si l’erreur persiste, contactez le support en précisant les informations suivantes :

  • Le nom de la plateforme.

  • Le message d’erreur exact.

  • Une capture d'écran des permissions de votre clé API, s'il y en a.

  • La confirmation de la modification ou récréation de la clé API.

J'ai fermé un compte et désormais l'API montre une erreur. Que faire ?

  • ⚠️ Ne supprimez pas l'API, au risque de perdre l'intégralité de votre historique de transactions sans possibilité de récupération.

  • Depuis la page Comptes, cliquez plutôt sur le point d'exclamation à côté du message d'erreur puis cliquez sur le bouton Archiver.

  • Cela fera disparaître l'erreur tout en conservant votre historique.


📂 Résolution d’un fichier en erreur

Un fichier est rejeté lorsque sa structure ne correspond pas au format attendu (export incorrect, modification du fichier, changement de format par la plateforme ou nouveau type d'opération). Pour résoudre un dysfonctionnement lié à un fichier :

  1. Vérifiez que vous avez bien exporté l’historique complet des transactions.

  2. Consultez le tutoriel de la plateforme sur notre Centre d'Aide pour sélectionner le type d'export adéquat.

  3. Téléchargez à nouveau le fichier original directement depuis la plateforme.

  4. Rendez-vous dans Mes comptes et importez le fichier original sans l'ouvrir, ni modifier ses colonnes ni son contenu.

  5. Si l’import échoue de nouveau, tentez de générer un nouvel export couvrant la même période.

  6. Si le problème persiste, transmettez votre fichier original au support via le chat.

💡 API ou fichier : quelle méthode privilégier ?

Le choix de la méthode dépend de votre situation :

  • Connexion API : permet de synchroniser automatiquement vos nouvelles transactions.

  • Fichier CSV / Excel : recommandé si la connexion API n'est pas disponible, si elle ne couvre pas l'intégralité de l'historique ou en cas de contrainte technique.

Pour identifier la méthode optimale, consultez le tutoriel dédié à votre plateforme dans le Centre d'Aide.

💡 Quand contacter le support ?

Contactez l'équipe support dans les cas suivants :

  • Votre compte API reste en erreur après la création d'une nouvelle clé.

  • Vous avez accompli un grand nombre de modifications sur vos transactions et ne souhaitez pas les perdre.

  • Votre fichier conforme est rejeté à plusieurs reprises.

  • Des opérations manquent après une réimportation ou une re-synchronisation.

  • Vous hésitez sur le fichier à exporter ou les permissions à accorder.

Afin de simplifier la prise en charge, communiquez systématiquement le nom de la plateforme, le message d'erreur exact et le mode d'import utilisé (API ou Fichier).

Ne partagez jamais votre clé secrète ou votre clé API complète en dehors de nos canaux officiels : l'équipe Waltio peut vous la demander uniquement via le chat du site ou par e-mail à [email protected], au travers d'un moyen sécurisé.

Avez-vous trouvé la réponse à votre question ?