FAQ sur l'intégration - Dépannage

Déconnecter et réinstaller ton intégration est une solution fiable en cas d'erreurs de connexion persistantes, de problèmes d'authentification et de situations où les commandes ont cessé d'être importées et où les autres étapes de dépannage n'ont pas fonctionné. Avant de procéder, comprends bien ce que tu vas perdre.

Étapes pour réinitialiser ton intégration

1. Dans ton compte Sendcloud, va dans Paramètres > Intégrations.
2. Trouve ton intégration dans la liste et clique sur Déconnecter.
3. Réinstalle l'intégration en suivant le guide de configuration de ta plateforme. Tu trouveras tous les guides d'installation dans la section Intégrations du Centre d'aide.
4. Après la reconnexion, va dans Paramètres > Intégrations > Configurer et recrée les règles d'expédition supprimées.

Avant de vérifier la configuration de ta boutique, assure-toi que ton compte Sendcloud est entièrement configuré. Un compte incomplet peut bloquer silencieusement une nouvelle connexion. Consulte d'abord les étapes de configuration du compte en haut de cet article.

Si ton compte est correctement configuré, travaille sur les points suivants :

Ta boutique n'est pas accessible publiquement
Sendcloud doit pouvoir atteindre ta boutique via Internet pour établir une connexion. Si ta boutique est en mode maintenance, protégée par un mot de passe ou pas encore publiée, la connexion échouera. Assure-toi que ta boutique est en ligne et accessible publiquement avant de la connecter.

Ton certificat SSL est invalide ou expiré
Même si ta boutique se charge correctement dans un navigateur, un certificat SSL invalide bloquera les appels API de Sendcloud. Vérifie que ton certificat est valide et correctement configuré auprès de ton hébergeur.

Un plugin ou une application tierce cause un conflit
Les plugins de sécurité, de mise en cache et les extensions de paiement sont les causes les plus fréquentes de conflits de connexion. Pour identifier le responsable, désactive tes plugins supplémentaires un par un en commençant par les plugins de sécurité, de pare-feu ou de mise en cache, et tente de te reconnecter après chacun. Dès que la connexion réussit, tu as trouvé le conflit.

Les adresses IP de Sendcloud sont bloquées
Si ton serveur ou ton environnement d'hébergement utilise un pare-feu ou une liste d'autorisation d'IP, il est possible que Sendcloud soit bloqué. Ajoute les adresses IP de Sendcloud à ta liste d'autorisation : 

La liste complète est également maintenue et mise à jour sur : https://cdn.sendcloud.com/global-media/public-ips.txt 
Si ta boutique utilise Cloudflare, ses paramètres de sécurité peuvent également bloquer Sendcloud. Consulte notre guide dédié : Résoudre le blocage de Sendcloud par Cloudflare.

Un proxy de mise en cache bloque les appels API
Si tu utilises un proxy de mise en cache, assure-toi qu'il ne bloque pas ou ne met pas en cache les requêtes API de Sendcloud. Demande à ton développeur de vérifier les paramètres de cache et de s'assurer que le domaine Sendcloud n'est pas bloqué.

Consulter le journal des requêtes échouées
Va dans Paramètres > Intégrations > Journal des requêtes échouées dans ton compte Sendcloud. Les erreurs de connexion y sont enregistrées avec une description. Partage le message d'erreur avec ton hébergeur ou ton développeur si tu as besoin d'aide pour l'interpréter.

Si ton intégration fonctionnait et s'est arrêtée sans que tu aies apporté de changements évidents, la cause est presque toujours quelque chose qui a changé du côté de ta boutique ou du côté de Sendcloud. Travaille sur les points suivants avant de contacter le support.

Vérifie d'abord s'il s'agit d'un problème côté Sendcloud
Avant de passer du temps à dépanner ta boutique, consulte la page de statut de Sendcloud. S'il y a un incident actif affectant les intégrations, ton problème peut se résoudre de lui-même une fois qu'il sera corrigé — aucune action de ta part n'est alors nécessaire.

Réfléchis à ce qui a changé récemment
La grande majorité des pannes d'intégration soudaines est déclenchée par un changement, même apparemment sans lien avec Sendcloud. Demande-toi :

• As-tu récemment mis à jour ta plateforme de boutique, ton thème ou des plugins ?
• As-tu mis à jour le plugin ou l'application Sendcloud dans ta boutique ?
• Ton hébergeur a-t-il migré ton serveur ou modifié une configuration ?
• Le domaine ou l'URL de ta boutique a-t-il changé ?
• As-tu régénéré des clés API ou modifié des mots de passe dans le back-office de ta boutique ?
• As-tu installé un nouveau plugin de sécurité ou activé une règle de pare-feu ?

Si l'un de ces points s'applique, ce changement est très probablement la cause. Consulte le journal des requêtes échouées (voir la section ci-dessus) pour l'erreur apparue à peu près au même moment.

Vérifie que ton plugin Sendcloud est à jour
Une version obsolète du plugin Sendcloud dans ta boutique est une cause fréquente de pannes soudaines, surtout après une mise à jour de plateforme. Va dans la section plugins ou applications de ta boutique et confirme que tu utilises la dernière version de l'intégration Sendcloud.

Vérifie que tes identifiants API sont toujours valides
Si des clés API ou des tokens ont été régénérés dans ta boutique, même automatiquement, la connexion à Sendcloud est immédiatement interrompue. Va dans Paramètres > Intégrations > Configurer dans ton compte Sendcloud et vérifie les identifiants. S'ils semblent obsolètes, reconnecte l'intégration avec les nouvelles clés.

Consulter le journal des requêtes échouées
Va dans Paramètres > Intégrations > Journal des requêtes échouées et cherche le moment où les erreurs ont commencé à apparaître. Le code d'erreur et la description t'indiqueront ce qui a changé. Associe-le à la section correspondante dans cet article.

Effectue les vérifications suivantes dans l'ordre avant de contacter le support.

Les nouvelles commandes peuvent prendre jusqu'à 4 minutes pour apparaître
Sendcloud récupère les nouvelles commandes environ toutes les 4 minutes. Si tu viens de passer une commande test et qu'elle n'apparaît pas encore, attends quelques minutes et actualise la page avant de conclure qu'il y a un problème.

Vérifie le filtre de dates dans Sendcloud
Par défaut, la vue des commandes entrantes affiche les commandes des 7 derniers jours. Si tu cherches des commandes plus anciennes, ouvre le filtre de dates et définis une plage plus large. C'est la raison la plus fréquente pour laquelle des commandes semblent « manquantes ».

Les commandes de plus de 30 jours ne sont pas importées
Lorsque tu connectes ta boutique pour la première fois, Sendcloud n'importe que les commandes des 30 derniers jours. Les commandes passées avant cette période n'apparaîtront pas automatiquement. Si tu as besoin d'importer des commandes plus anciennes, contacte le support depuis ton compte Sendcloud.

Vérifie que ton intégration est toujours connectée
Va dans Paramètres > Intégrations et confirme que ta boutique est bien listée sous les intégrations connectées. Si ce n'est pas le cas, la connexion a été perdue et devra être rétablie. Consulte la section ci-dessous sur la réinitialisation de ton intégration.

Consulter le journal des requêtes échouées
Va dans Paramètres > Intégrations > Journal des requêtes échouées. Si des erreurs y sont listées, note le message d'erreur — c'est le moyen le plus rapide de diagnostiquer ce qui ne va pas. Transmets l'erreur à ton hébergeur ou à ton développeur si nécessaire.

Un plugin envoie peut-être des données de commande incomplètes
Certains plugins modifient ou suppriment les données de commande avant qu'elles n'atteignent Sendcloud, ce qui provoque des échecs silencieux. Désactive les plugins supplémentaires un par un pour identifier si l'un d'eux interfère. Les produits marqués comme virtuels dans ta boutique peuvent également provoquer l'omission de commandes.

Ta boutique n'est peut-être plus accessible publiquement
Si ta boutique est passée en mode maintenance ou si la connexion est devenue inaccessible, les commandes cessent d'être importées. Vérifie que ta boutique est en ligne et accessible depuis Internet.

Lorsque tu crées une étiquette dans Sendcloud, l'intégration renvoie automatiquement le numéro de suivi et le statut de commande mis à jour à ta boutique. Si ce n'est pas le cas, vérifie les points suivants.

Vérifie que ton intégration est toujours connectée
Le retour d'informations ne peut être envoyé que si la connexion entre Sendcloud et ta boutique est active. Va dans Paramètres > Intégrations et confirme que ta boutique apparaît bien sous les intégrations connectées. Si la connexion a été perdue, les mises à jour de suivi pour les commandes expédiées entre-temps ne seront pas envoyées rétroactivement — tu devras mettre à jour ces commandes manuellement dans ta boutique.

Consulter le journal des requêtes échouées
Va dans Paramètres > Intégrations > Journal des requêtes échouées. Si Sendcloud a tenté d'envoyer un retour et a échoué, l'erreur est enregistrée ici avec une description. C'est le moyen le plus rapide de confirmer si un envoi a bien été tenté.

Vérifie quand l'étiquette a été créée
Le retour d'informations est envoyé au moment où l'étiquette est créée dans Sendcloud. Si l'étiquette a été créée alors que l'intégration était déconnectée, aucun retour n'aura été envoyé pour cette commande. Mets à jour le statut de la commande manuellement dans ta boutique dans ces cas.

Le retour est peut-être retardé, pas absent
Si tu traites un grand nombre de commandes à la fois, ta plateforme de boutique peut limiter les mises à jour entrantes de Sendcloud, provoquant un court délai avant que les statuts et numéros de suivi n'apparaissent. Attends quelques minutes avant de conclure que le retour a complètement échoué.

Ces deux erreurs sont les problèmes liés à l'authentification les plus fréquents dans toutes les intégrations. Elles se ressemblent mais ont des causes différentes.

401 — Sendcloud ne peut pas s'authentifier auprès de ta boutique
Cela signifie que Sendcloud est refusé parce que les identifiants qu'il utilise sont invalides ou expirés. Les causes les plus fréquentes sont :

• Les clés API utilisées pour connecter ton intégration ont expiré ou ont été régénérées dans ta boutique sans être mises à jour dans Sendcloud.
• Ton compte Sendcloud ne dispose pas d'un moyen de paiement configuré. Va dans Paramètres > Finances et assure-toi qu'un moyen de paiement est actif — une configuration de facturation incomplète peut bloquer l'authentification.

Pour corriger une erreur 401, régénère tes clés API dans ta boutique et entre-les à nouveau dans Sendcloud sous Paramètres > Intégrations > Configurer. Si cela ne fonctionne pas, déconnecte et réinstalle l'intégration de zéro pour générer une nouvelle connexion.

403 — Sendcloud est activement bloqué
Cela signifie que ton serveur ou une couche de sécurité en amont refuse entièrement les requêtes de Sendcloud. Les causes les plus fréquentes sont :

• Les adresses IP de Sendcloud sont bloquées par le pare-feu ou l'environnement d'hébergement de ton serveur. Ajoute-les à ta liste d'autorisation — la liste complète se trouve sur https://cdn.sendcloud.com/global-media/public-ips.txt.
• Cloudflare bloque les requêtes de Sendcloud via le Bot Fight Mode ou des règles WAF. Consulte notre guide dédié : Résoudre le blocage de Sendcloud par Cloudflare.
• Pour Shopify : le token OAuth utilisé lors de l'installation a expiré ou les autorisations de l'application ont changé. Réinstaller l'application Sendcloud dans Shopify génère un nouveau token et résout ce problème.

Consulte d'abord le journal des requêtes échouées
Va dans Paramètres > Intégrations > Journal des requêtes échouées. Une erreur 401 apparaît comme orders.apis.base.exceptions.AuthenticationError. Une erreur 403 apparaît comme orders.apis.base.exceptions.AccessDenied ou comme une erreur d'accès refusé générique. Le journal t'indique avec quel type tu as affaire avant de prendre des mesures.

Le journal des requêtes échouées est ton premier réflexe pour tout problème d'intégration. Il enregistre chaque fois que Sendcloud a tenté de communiquer avec ta boutique et a échoué — que ce soit pour récupérer des commandes, envoyer un retour de suivi ou vérifier la connexion. Si quelque chose ne va pas avec ton intégration, la raison se trouve presque toujours ici.

Comment y accéder
Va dans Paramètres > Intégrations dans ton compte Sendcloud. Trouve ton intégration dans la liste et clique sur Voir > journal des problèmes de connexion (ou Journal des requêtes échouées, selon ton type d'intégration).

Ce que tu verras
Chaque entrée indique la date et l'heure de la requête échouée, le code d'erreur et une description de ce qui s'est passé. Les erreurs les plus récentes apparaissent en haut. Points clés à rechercher :

• Le code d'erreur (401, 403, 404, 500, etc.) indique la catégorie du problème. Utilise la section ci-dessus sur les erreurs 401 et 403, ou le guide de dépannage de ta plateforme en bas de cet article, pour associer le code à une solution.
• La description de l'erreur indique souvent la cause exacte, par exemple : orders.apis.base.exceptions.AuthenticationError ou orders.apis.base.exceptions.NotFoundError. Copie ce texte lorsque tu contactes le support, car cela accélère considérablement le diagnostic.
• L'horodatage t'indique quand le problème a commencé. Si les erreurs apparaissent à un moment précis, réfléchis à ce qui a changé à cette période — une mise à jour de plugin, une migration de serveur, un changement de mot de passe ou une mise à jour WooCommerce sont des déclencheurs fréquents.

Si le journal est vide
Un journal vide ne signifie pas toujours que tout fonctionne. Cela peut vouloir dire que Sendcloud n'atteint pas du tout ta boutique — la requête ne passe même pas pour générer une erreur. Si tes commandes ont cessé d'être importées et que le journal est vide, reviens à la liste de vérification de connexion ci-dessus et vérifie que ta boutique est accessible publiquement et que les adresses IP de Sendcloud ne sont pas bloquées.

Que faire avec l'erreur
La plupart des erreurs dans le journal sont actionnables — associe le code d'erreur à la section correspondante dans cet article ou dans le guide de dépannage de ta plateforme. Si tu as suivi les étapes pertinentes et que l'erreur persiste, ouvre une demande de support depuis ton compte Sendcloud et joins une capture d'écran de l'entrée du journal ainsi que le texte exact de l'erreur. C'est la chose la plus utile que tu puisses fournir au support.