Intégration WooCommerce

Connecter WooCommerce

Avant de commencer

• Votre boutique doit être servie en HTTPS.
• Vous devez vous connecter à WordPress en tant qu'administrateur ou gestionnaire de boutique.

Connecter votre boutique

1. Allez dans Intégrations et cliquez sur WooCommerce
2. Saisissez l'adresse de votre boutique, par exemple votreboutique.fr. Si WooCommerce est installé dans un dossier, incluez-le (votreboutique.fr/boutique)
3. Cliquez sur Connecter avec WooCommerce. Vous êtes redirigé vers votre administration WordPress (connectez-vous si demandé)
4. WooCommerce vous demande d'autoriser Shopimize. Cliquez sur Autoriser
5. Vous revenez sur Shopimize et l'import démarre automatiquement

L'autorisation crée une clé API nommée « Shopimize », révocable à tout moment dans WooCommerce → Réglages → Avancé → API REST. L'écran d'autorisation indique un accès Lecture/Écriture : Shopimize se contente de lire vos commandes, remboursements, produits et réglages. L'écriture sert à une seule chose : ajouter des webhooks nommés « Shopimize » (WooCommerce → Réglages → Avancé → Webhooks) pour que les nouvelles commandes, remboursements et modifications de produits arrivent dans Shopimize en quelques minutes.

Ce qui est importé

• Vos commandes les plus récentes immédiatement, puis tout l'historique en arrière-plan
• Les remboursements (y compris partiels, par produit), annulations et changements de statut
• Les produits et variations, avec leurs coûts s'ils existent dans WooCommerce : le champ Coût des marchandises intégré (WooCommerce 10.3+) ou l'extension Cost of Goods. Chaque commande utilise le coût enregistré par WooCommerce au moment de l'achat ; les coûts lus dans WooCommerce portent un badge WooCommerce dans Coûts → Coûts produits, où vous pouvez aussi saisir ou corriger vos coûts
• Les frais de paiement enregistrés par WooPayments, l'extension Stripe pour WooCommerce et PayPal Payments. Si un paiement Stripe n'a pas de frais sur la commande et que votre compte Stripe est connecté à Shopimize, les frais réels sont lus dans Stripe. Sinon vos règles de frais s'appliquent, ou une estimation au tarif standard de votre devise
• L'attribution des commandes (campagne UTM, site référent, page d'entrée) issue de l'attribution intégrée à WooCommerce. Les clics publicitaires sans balises UTM sont reconnus grâce à leur identifiant de clic (Google, Microsoft Ads, TikTok, Facebook/Instagram)

Commandes dans d'autres devises

Si votre boutique vend dans plusieurs devises (multi-devises WooPayments, Aelia Currency Switcher, FOX/WOOCS ou une autre extension), chaque commande est convertie dans la devise de votre boutique pour que les totaux et la rentabilité s'additionnent. Shopimize utilise le taux de change enregistré par l'extension sur la commande, ou le taux de référence de la Banque centrale européenne à la date de la commande. La devise payée par le client et le taux utilisé sont conservés avec la commande.

Délai de mise à jour

Les changements arrivent dans Shopimize par les webhooks en quelques minutes. WooCommerce envoie les webhooks depuis sa file d'actions planifiées, qui sur les sites peu fréquentés ne s'exécute qu'à la visite d'un internaute : un envoi peut donc parfois prendre plus de temps. Shopimize vérifie aussi les changements toutes les heures par sécurité, et toutes les 15 minutes si les webhooks n'ont pas pu être ajoutés.

Les commandes échouées, en attente de paiement, brouillons ou mises à la corbeille ne sont jamais comptées comme des ventes.

Connecter avec des clés API

Certains hébergeurs bloquent la requête que WooCommerce envoie à Shopimize après votre autorisation. Dans ce cas :

1. Dans WordPress, allez dans WooCommerce → Réglages → Avancé → API REST et cliquez sur Ajouter une clé
2. Description : Shopimize — Utilisateur : un administrateur — Droits : Lecture/Écriture
3. Cliquez sur Générer une clé API et copiez la clé client et le secret client
4. Dans Shopimize, ouvrez Intégrations → WooCommerce, cliquez sur Connecter avec des clés API et collez-les

Problèmes courants

« Impossible de joindre votre boutique » — vérifiez que l'adresse s'ouvre en HTTPS sans avertissement du navigateur.

« Une protection de sécurité, un pare-feu ou un cache a bloqué notre requête » — des extensions comme Wordfence, iThemes Security ou une règle Cloudflare peuvent bloquer l'API REST. Autorisez les requêtes vers /wp-json/wc/, puis réessayez.

« La clé est valide mais ne peut pas lire les commandes » — la clé doit avoir les droits Lecture ou Lecture/Écriture et appartenir à un administrateur ou gestionnaire de boutique.

« WooCommerce n'est pas actif sur ce site » — WooCommerce doit être activé et son API REST ne doit pas être désactivée par une autre extension.

Les changements mettent jusqu'à 15 minutes à apparaître — les webhooks n'ont pas pu être ajoutés : la clé API n'a que le droit Lecture, ou une extension de sécurité bloque les webhooks. Reconnectez la boutique avec l'accès Lecture/Écriture. Si un webhook Shopimize apparaît comme Désactivé dans WooCommerce → Réglages → Avancé → Webhooks, Shopimize le réactive en quelques heures.

Si rien ne résout le problème, contactez hello@shopimize.com avec l'URL de votre boutique.