Intégration WooCommerce¶

L’intégration WooCommerce vous permet de connecter votre boutique en ligne WooCommerce à Gem Logic. Une fois connectée, vous pouvez pousser des produits depuis Gem Logic vers votre boutique WooCommerce et extraire les commandes de WooCommerce vers Gem Logic. Cela maintient votre catalogue produit et votre gestion des commandes synchronisés entre les deux plateformes.

Configuration¶

Générer des clés API dans WooCommerce¶

Avant de connecter WooCommerce à Gem Logic, vous devez générer des clés API dans votre boutique WooCommerce.

Connectez-vous à votre panneau d’administration WordPress.
Accédez à WooCommerce ‣ Réglages ‣ Avancé ‣ API REST.
Cliquez sur Ajouter une clé.
Remplissez les détails :
- Description : saisissez un nom pour identifier cette clé (par exemple Intégration Gem Logic).
- Utilisateur : sélectionnez l’utilisateur WordPress qui sera utilisé pour la connexion API.
- Permissions : sélectionnez Lecture/Écriture. Cela est nécessaire pour que Gem Logic puisse à la fois lire les commandes et créer/mettre à jour les produits dans votre boutique.
Cliquez sur Générer la clé API.
Copiez la Clé consommateur et le Secret consommateur. Ils ne seront affichés qu’une seule fois, assurez-vous donc de les enregistrer dans un endroit sécurisé.

Important

Le secret consommateur n’est affiché qu’une seule fois. Si vous le perdez, vous devrez révoquer la clé et en générer une nouvelle.

Connecter WooCommerce à Gem Logic¶

Dans Gem Logic, accédez à Configuration ‣ Canaux de vente.
Ouvrez le canal de vente que vous souhaitez connecter à WooCommerce, ou créez-en un nouveau.
Activez la case WooCommerce.
Remplissez les champs suivants :
- URL : l’URL complète de votre boutique WooCommerce (par exemple https://www.votreboutique.com). N’incluez pas de barre oblique finale.
- Clé WooCommerce : collez la Clé consommateur que vous avez générée précédemment.
- WooCommerce Secret : collez le Consumer secret que vous avez généré précédemment.
Si vous utilisez le plugin Perfect WooCommerce Brands dans votre boutique WooCommerce, activez la case WooCommerce brands plugin. Cela permet à Gem Logic de synchroniser les marques de produits avec WooCommerce.
Sauvegardez le canal de vente.

Astuce

Assurez-vous que votre boutique WooCommerce utilise HTTPS. Les identifiants API sont chiffrés et stockés de manière sécurisée dans Gem Logic.

Assigner des produits au canal de vente¶

Pour que les produits soient envoyés vers WooCommerce, ils doivent être assignés au canal de vente WooCommerce.

Allez dans Produits.
Ouvrez un produit et accédez à sa section canaux de vente.
Ajoutez le canal de vente WooCommerce au produit.
Assurez-vous que le produit possède une règle tarifaire configurée pour ce canal de vente, afin qu’il ait un prix lors de son envoi vers WooCommerce.

Envoi des produits¶

Vous pouvez envoyer des produits de Gem Logic vers votre boutique WooCommerce. Cela crée ou met à jour les produits dans WooCommerce en fonction des données présentes dans Gem Logic.

Envoyer un seul produit¶

Pour envoyer un seul produit, ouvrez le produit dans Gem Logic et utilisez l’action d’envoi depuis la section canaux de vente du produit. Le produit sera créé dans WooCommerce s’il n’existe pas encore, ou mis à jour s’il possède déjà un identifiant WooCommerce.

Envoyer tous les produits¶

Pour envoyer en une seule fois tous les produits assignés à un canal de vente WooCommerce :

Allez dans Configuration ‣ Canaux de vente.
Ouvrez le canal de vente WooCommerce.
Cliquez sur Envoyer tous les produits vers WooCommerce.

Cette opération s’exécute en tâche de fond. Vous pouvez suivre la progression sur la page historique d’envoi.

Ce qui est envoyé¶

Lorsqu’un produit est envoyé vers WooCommerce, les données suivantes sont synchronisées :

USG (utilisé pour faire correspondre les produits entre les deux systèmes)
Nom et description (en fonction de la langue du canal de vente)
Prix normal et prix promotionnel (à partir de la règle tarifaire pour ce canal de vente)
Images (retéléchargées uniquement en cas de modifications)
Catégories et collections (créées dans WooCommerce si elles n’existent pas)
Attributs (créés comme attributs WooCommerce globaux)
Tags
Quantité en stock
Marques (si le plugin WooCommerce brands est activé)
Type de produit : simple ou variable (avec des variantes)

Produits variables et variantes¶

Si un produit dans Gem Logic est marqué comme produit parent, il est poussé comme produit variable dans WooCommerce. Tous ses produits enfants (variantes) sont poussés comme variations de produit. Chaque variante comprend son propre prix, USG, image et valeurs d’attributs (par exemple taille, couleur).

Désactivation de produit¶

Vous pouvez désactiver un produit dans WooCommerce depuis Gem Logic. Cela définit le statut du produit sur brouillon dans WooCommerce, le rendant invisible sur la vitrine sans le supprimer.

Historique des poussées¶

Chaque opération de poussée est enregistrée. Vous pouvez consulter l’historique des poussées depuis la page de détails du canal de vente. Chaque enregistrement d’historique affiche :

Heure de début et de fin
Statut (démarré, terminé, échoué ou succès partiel)
Nombre total de produits, réussis et échoués
Taux de réussite et durée
Résultats détaillés par produit (cliquez sur Voir les détails pour voir quels produits ont réussi ou échoué)

Extraction des produits¶

Vous pouvez extraire des produits de votre boutique WooCommerce vers Gem Logic. Cela est particulièrement utile pour l’importation initiale lorsque vous connectez votre boutique pour la première fois.

Allez dans Configuration ‣ Canaux de vente.
Ouvrez le canal de vente WooCommerce.
Cliquez sur Extraire les produits depuis WooCommerce.

Cela s’exécute comme une tâche de fond et importe les données suivantes pour chaque produit :

USG, nom et description
Prix régulier et prix de vente
Catégories et marques
Images (téléchargées et stockées dans Gem Logic)
Tags
Quantités en stock
Attributs et métaux
Variantes de produit (pour les produits variables)

Note

Les produits qui existent déjà dans Gem Logic (identifiés par ID WooCommerce ou USG) sont ignorés lors de l’importation. Seuls les nouveaux produits sont créés.

Extraction des commandes¶

Vous pouvez extraire les commandes terminées depuis WooCommerce vers Gem Logic.

Extraire les commandes manuellement¶

Allez dans Configuration ‣ Canaux de vente.
Ouvrez le canal de vente WooCommerce.
Cliquez sur Extraire les commandes depuis WooCommerce.

Cela s’exécute comme une tâche de fond. Vous serez redirigé vers la page historique d’extraction où vous pouvez suivre la progression en temps réel.

Extraction automatique des commandes¶

Les commandes peuvent également être extraites automatiquement selon un calendrier en utilisant le système de tâches en arrière-plan. Cela garantit que les nouvelles commandes finalisées sont régulièrement importées sans intervention manuelle.

Ce qui est importé¶

Lorsque les commandes sont extraites de WooCommerce, les données suivantes sont importées :

Clé de commande (utilisée comme identifiant unique de la commande)
Informations de contact client (nom, adresse, email, téléphone) — un contact est créé ou mis à jour dans le CRM
Date de commande et devise
Lignes de commande : chaque ligne comprend le produit (apparié par ID WooCommerce ou USG), la quantité, les prix (HT et TTC) et le taux de TVA
Déduction de stock : le stock est automatiquement déduit pour chaque ligne de commande

Note

Seules les commandes avec le statut finalisé sont importées. Les commandes ayant d’autres statuts (par exemple en cours de traitement, en attente, en suspens) sont ignorées.

Note

Les commandes déjà importées (appariées par clé de commande) sont ignorées pour éviter les doublons.

Historique d’extraction¶

Chaque opération d’extraction est enregistrée. Vous pouvez consulter l’historique d’extraction depuis la page de détail du canal de vente. Chaque enregistrement affiche :

Heure de début et de fin
Statut (démarré, terminé, échoué ou succès partiel)
Nombre total de commandes traitées, nouvelles commandes créées, ignorées et échouées
Durée et messages d’erreur éventuels