Objectif : Ce guide vous explique comment résoudre les problèmes pouvant survenir lors de l’intégration avec WooCommerce V2.
Articles liés
→ Résolution des problèmes d'intégration avec des systèmes e-commerce auto-hébergés
Erreur : API non active lors de la connexion de la boutique WooCommerce
Si vous essayez de connecter votre boutique WooCommerce à Sendcloud et qu’un message apparaît indiquant que l’API n’est pas active après avoir cliqué sur le bouton Connecter, cela est probablement dû à des modifications dans les paramètres par défaut de WooCommerce.
Dans les versions récentes de WooCommerce, l’API Legacy n’est plus activée par défaut. Alors que la version précédente du plugin Sendcloud nécessitait cette API, la dernière version ne le fait plus.
Vous pouvez télécharger la dernière version de notre plugin ici.
Pour résoudre ce problème, suivez les étapes ci-dessous :
- Accédez à la page Réglages > Boutiques connectées dans votre compte Sendcloud.
- Vérifiez si de nouvelles intégrations WooCommerce ont été créées. Si c’est le cas, vous pouvez les déconnecter sans problème.
- Retournez dans votre boutique WooCommerce, puis désactivez et désinstallez complètement toute version existante du plugin Sendcloud.
- Réinstallez le plugin en utilisant le lien fourni ci-dessus.
- Activez le plugin et connectez-le à Sendcloud. L’intégration devrait maintenant se faire correctement.
L'import des commandes ne se fait pas
Vérifiez dans votre back office WooCommerce si les autorisations pour les clés API sont définies en lecture / écriture. Cela est nécessaire pour importer correctement les données.
Dans votre back-office, rendez-vous dans WooCommerce > Réglages > puis cliquez sur l'onglet Avancé.
Recherchez le sous menu API REST, puis vérifiez les droits de la clé API Sendcloud, et que l'utilisateur est l'administrateur de votre back office.
Veuillez vérifier les paramètres du mode HPOS dans WooCommerce > Réglages > Avancés > Fonctionnalités. Si le mode HPOS est activé, assurez-vous que le mode de compatibilité est également activé, sinon Sendcloud ne pourra pas récupérer les commandes.
Les commandes sont importées en retard
Lorsque vous récupérez les commandes, veuillez implémenter l'en-tête HTTP Cache-Control avec le paramètre no-cache Request Directives, comme décrit dans cette documentation. Cela permettra à Sendcloud d'ignorer le cache et de récupérer les commandes les plus récentes. Pour plus d'information merci de consulter cet article.
Bouton “Connecter” grisé dans la page d'intégration Sendcloud
Si le bouton “Connecter” dans l'écran d'intégration Sendcloud est grisé et que vous ne pouvez pas procéder à la connexion :
Vérifiez les paramètres de permalien dans WordPress. Si la structure est définie sur Plain, la connexion ne fonctionnera pas.
Pour résoudre ce problème :
- Accédez à Réglages > Permalinks/Permaliens dans votre panneau d'administration WordPress.
- Sélectionnez n'importe quelle structure autre que “Plain”.
- Enregistrez les modifications.
- Retournez dans WooCommerce > Sendcloud et essayez à nouveau de vous connecter.
Cela devrait résoudre le problème et activer le bouton “Connecter”.
Compatibilité avec le plugin WPML (Commandes multilingues manquantes)
Si vous utilisez le plugin WPML pour prendre en charge plusieurs langues dans votre boutique WooCommerce et que vous remarquez que certaines commandes (notamment celles passées dans des langues autres que la langue par défaut) n’apparaissent pas dans Sendcloud ou sont manquantes lors de la synchronisation, cela peut être dû aux paramètres de traduction de WPML pour le type de publication Order.
Pour assurer la compatibilité, suivez ces étapes :
- Dans votre tableau de bord WordPress, allez dans WPML > Réglages
- Faites défiler jusqu’à la section intitulée Traduction des types de publication
- Trouvez Orders (shop_order) dans la liste
- Définissez-le sur Non traduisible (“Not translatable”)
- Cliquez sur Enregistrer
Une fois ce paramètre mis à jour, essayez de récupérer à nouveau les commandes via votre intégration ou point de terminaison API.
Toutes les commandes devraient désormais se synchroniser correctement, quelle que soit la langue utilisée lors du passage en caisse.
Vous rencontrez encore des difficultés ? Créez un ticket et notre équipe d’assistance vous répondra dans les plus brefs délais !