Installer WooCommerce
Configurez WooCommerce pour l'intégration avec Order Invoicer
Prérequis
Avant de commencer l'installation, assurez-vous que :
- Votre WordPress est à jour (version 5.8+ recommandée)
- WooCommerce est installé et activé (version 6.0+ recommandée)
- Vous avez accès au back-office WordPress avec les droits administrateur
- Votre site est accessible via HTTPS
Générer des clés API WooCommerce
Pour utiliser l'API REST de WooCommerce avec Order Invoicer, vous devez générer des clés API sécurisées.
1. Accéder aux paramètres API
- Connectez-vous à votre back-office WordPress
- Naviguez vers WooCommerce > Paramètres
- Cliquez sur l'onglet Avancé
- Rendez-vous dans la section API REST
2. Créer une nouvelle clé API
- Cliquez sur Ajouter une clé pour créer une nouvelle clé API
- Configurez la clé avec les paramètres suivants :
Configuration de base
- Description : Ajoutez une description claire (ex: "Order Invoicer - Intégration Sellsy")
- Utilisateur : Sélectionnez un utilisateur administrateur ou avec des droits suffisants
- Permissions : Sélectionnez Lecture/écriture pour permettre la récupération des données
Permissions requises
La clé API doit avoir accès aux données suivantes :
Commandes (Orders)
- ✅ Lecture des commandes
- ✅ Ecriture des commandes
- ✅ Lecture des commandes privées
Clients (Customers)
- ✅ Lecture des clients
Produits (Products)
- ✅ Lecture des produits
Taxes (Taxes)
- ✅ Lecture des taxes
Sécurité : N'accordez que les permissions minimales nécessaires. Les permissions de lecture suffisent pour Order Invoicer sauf pour l'envoi des méta-datas.
- Cliquez sur Générer la clé API
3. Récupérer les informations de connexion
Après avoir généré la clé, notez immédiatement les informations suivantes :
- URL de votre boutique :
https://votre-boutique.com - Clé consommateur (Consumer Key) : La clé publique générée
- Clé secrète (Consumer Secret) : La clé privée générée
Important :
- Gardez ces informations en sécurité
- La clé secrète ne sera plus visible après avoir fermé cette page
- Vous en aurez besoin pour configurer le connecteur dans Order Invoicer
4. Vérifier la configuration
Test de l'API
Pour vérifier que votre configuration fonctionne :
- Testez l'accès à l'API :
https://votre-boutique.com/wp-json/wc/v3/ - Vous devriez voir une page JSON avec les informations de l'API
- Si vous obtenez une erreur, vérifiez que :
- WooCommerce est bien activé
- Votre site est accessible
- Les permissions sont correctement configurées
Test avec les clés
Vous pouvez tester l'accès avec vos clés en utilisant un outil comme cURL :
curl -X GET "https://votre-boutique.com/wp-json/wc/v3/orders" \
-H "Authorization: Basic [votre-clé-encodée-en-base64]"Dépannage courant
Erreurs de configuration
Erreur "WooCommerce non activé"
- Vérifiez que WooCommerce est installé et activé
- Vérifiez que vous êtes sur la bonne version de WooCommerce
Erreur "Clés API invalides"
- Vérifiez que vous avez copié les clés complètes
- Assurez-vous que la clé est active
- Vérifiez les permissions accordées à l'utilisateur
Erreur "Accès refusé"
- Vérifiez que l'URL de votre boutique est correcte
- Assurez-vous que votre site est accessible en HTTPS
- Vérifiez que l'utilisateur a les droits suffisants
Erreur "API non accessible"
- Vérifiez que les permaliens WordPress sont configurés
- Désactivez temporairement les plugins de sécurité
- Vérifiez la configuration du serveur web
Plugins incompatibles
WooCommerce Price Based on Country (WCPBC)
Si vous utilisez le plugin Price Based on Country for WooCommerce (version Pro), vous devez désactiver l'option "Round to Nearest" dans les paramètres de vos zones tarifaires.
Cette option arrondit les prix convertis par le taux de change pour obtenir des prix plus "élégants" (par exemple arrondir à 0.50 CHF près). Cela crée des écarts entre les montants réels de la commande WooCommerce et les montants calculés par Order Invoicer, ce qui peut entraîner des différences sur les factures générées.
Comment désactiver
- Allez dans WooCommerce → Réglages → Zone Pricing → Zones
- Survolez le nom de la zone concernée et cliquez sur Modifier
- Trouvez le champ "Round to Nearest"
- Videz le champ (laissez-le vide)
- Cliquez sur Enregistrer les modifications
- Répétez pour chaque zone tarifaire
Important : Les valeurs proposées par le plugin (500, 50, 5, 0.50, 0.05) modifient les prix unitaires. Cela entraîne des incohérences entre le montant facturé par WooCommerce et le montant recalculé par Order Invoicer.
Configuration avancée
Mode multiboutique
Si vous utilisez WooCommerce en mode multiboutique :
- Créez une clé API pour chaque boutique
- Configurez chaque connecteur avec les bonnes clés
- Vérifiez les permissions pour chaque boutique
Personnalisation des champs
Order Invoicer peut récupérer des champs personnalisés :
- Assurez-vous que vos champs personnalisés sont visibles via l'API
- Configurez les mappings dans Order Invoicer si nécessaire
- Testez la récupération des données personnalisées
Support
Si vous rencontrez des difficultés :
- Vérifiez la section de dépannage ci-dessus
- Consultez la documentation officielle WooCommerce
- Contactez notre support :
contact@orderinvoicer.com
Note : Une fois cette configuration terminée, vous pourrez passer à l'étape suivante : la configuration du connecteur dans Order Invoicer.