Installer WooCommerce

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

1. Connectez-vous à votre back-office WordPress
2. Naviguez vers WooCommerce > Paramètres
3. Cliquez sur l'onglet Avancé
4. Rendez-vous dans la section API REST

2. Créer une nouvelle clé API

1. Cliquez sur Ajouter une clé pour créer une nouvelle clé API
2. 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.

3. 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 :

1. Testez l'accès à l'API : https://votre-boutique.com/wp-json/wc/v3/
2. Vous devriez voir une page JSON avec les informations de l'API
3. 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

Configuration avancée

Mode multiboutique

Si vous utilisez WooCommerce en mode multiboutique :

1. Créez une clé API pour chaque boutique
2. Configurez chaque connecteur avec les bonnes clés
3. Vérifiez les permissions pour chaque boutique

Personnalisation des champs

Order Invoicer peut récupérer des champs personnalisés :

1. Assurez-vous que vos champs personnalisés sont visibles via l'API
2. Configurez les mappings dans Order Invoicer si nécessaire
3. Testez la récupération des données personnalisées

Support

Si vous rencontrez des difficultés :

1. Vérifiez la section de dépannage ci-dessus
2. Consultez la documentation officielle WooCommerce
3. 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.