Connectez votre boutique
WooCommerce à GSE-Web
Votre catalogue et votre stock disponible partent vers la boutique. Les commandes payées arrivent dans GSE-Web en bons de sortie confirmés, stock réservé.
En bref
Le connecteur WooCommerce relie une boutique WooCommerce à un magasin de GSE-Web. GSE-Web publie le stock, la boutique envoie ses commandes. Il se configure par un administrateur de l'organisation, dans le menu ADMIN › « Intégrations ».
- Ce qui part vers la boutique : les fiches des produits simples (nom, référence, prix, code-barres), si vous le demandez, et le stock disponible du magasin publié.
- Ce qui arrive dans GSE-Web : chaque commande retenue devient un bon de sortie confirmé, stock réservé ; l'acheteur devient un client « particulier ».
- Quand : une commande arrive aussitôt par webhook ; un passage complet a lieu toutes les 5 minutes et rattrape ce qui aurait manqué.
- Ce qui n'est jamais fait : rien n'est supprimé en boutique, et GSE-Web n'écrit jamais dans les commandes de la boutique.
- Coupure : pause, déconnexion ou fermeture du module à tout moment, sans rien perdre ; à la reprise, les commandes passées entre-temps sont rattrapées.
Prérequis
Vérifiez ces points avant d'ouvrir l'écran du connecteur : le test de connexion les contrôle et refuse en clair ce qui ne convient pas.
WooCommerce 7.0 ou plus récent
La boutique doit être servie en HTTPS. Le code-barres (GTIN) des produits est publié à partir de WooCommerce 9.2.
Une clé d'API REST en lecture/écriture
Dans WooCommerce : Réglages › Avancé › API REST › Ajouter une clé, droits « Lecture/Écriture ». Notez la clé et le secret : WooCommerce ne réaffiche pas le secret.
Les modules ouverts pour votre organisation
« Intégrations », puis « WooCommerce ». Leur ouverture se demande à KLS-Concept. Sans « Intégrations », l'entrée du menu n'apparaît pas ; sans « WooCommerce », sa carte indique « Non disponible pour votre organisation ».
Un compte ADMIN avec double authentification
La saisie des identifiants de la boutique est refusée tant que la double authentification n'est pas activée sur votre compte, dans « Mes informations ».
Un magasin réel
Son stock disponible est publié en boutique et les commandes y deviennent des bons de sortie. Un magasin d'exercice est refusé.
La même devise
La devise de la boutique doit être celle de votre organisation.
Le même régime de prix
Le choix « Prix publiés » (HT ou TTC) doit correspondre au réglage « Saisir les prix toutes taxes comprises » de la boutique.
Configuration pas à pas
Six étapes, dans l'ordre de l'écran.
Ouvrir l'écran du connecteur
Menu ADMIN › « Intégrations ». La carte WooCommerce se trouve dans la catégorie « E-commerce ». Cliquez sur « Configurer » (le bouton devient « Gérer » une fois la boutique enregistrée).
Carte « Boutique »
Renseignez « Adresse de la boutique » (adresse complète, qui commence par https://), « Clé client (consumer key) » et « Secret client (consumer secret) », puis choisissez le « Magasin publié ».
La clé et le secret sont en écriture seule : une fois enregistrés, ils ne sont plus jamais réaffichés. L'écran montre seulement quelques caractères de la clé pour la reconnaître. Pour la conserver, laissez les deux champs vides ; pour la remplacer, saisissez une nouvelle clé et son secret.
Carte « Réglages »
Chaque réglage a une valeur par défaut :
- « Prix publiés » : « Hors taxes (HT) » par défaut, ou « Toutes taxes comprises (TTC) ».
- « Créer et mettre à jour les fiches produits en boutique » : décoché par défaut. Décoché, GSE-Web ne crée aucune fiche : il relie seulement les produits déjà présents en boutique avec la même référence (SKU).
- « Publier le stock disponible » : coché par défaut.
- « Recevoir les commandes » : coché par défaut.
- « Statuts de commande importés » : « En cours » par défaut. Vous pouvez ajouter « En attente de paiement », « En attente » et « Terminée ».
- « Âge maximal d'une commande rattrapée (jours) » : 30 par défaut, de 1 à 90.
Enregistrer
Cliquez sur « Enregistrer ». « Tester la connexion » et « Activer » agissent sur la configuration enregistrée : tant qu'une modification n'est pas enregistrée, l'écran le rappelle et ces deux boutons attendent.
Tester la connexion
« Tester la connexion » interroge la boutique et vérifie quatre points : la version de WooCommerce, les droits d'écriture de la clé, la devise et le régime de prix. Un refus est affiché en clair, avec ce qui ne va pas (voir le dépannage plus bas).
Activer
« Activer » refait le test, puis crée quatre webhooks « GSE-Web » dans WooCommerce. L'état passe à « Active — synchronisation toutes les 5 minutes ». Les commandes reçues avant l'activation ne sont pas importées.
Ce qui se synchronise, et qui fait foi
Chaque champ a un seul maître. GSE-Web n'écrit jamais une commande de la boutique : aucune boucle n'est possible.
📦 GSE-Web fait foi
- ✓Nom du produit
- ✓Référence (SKU en boutique)
- ✓Prix de vente, HT ou TTC selon le réglage
- ✓Code-barres (GTIN, WooCommerce 9.2 ou plus récent)
- ✓Publication ou brouillon
- ✓Stock
🛒 La boutique fait foi
- ✓Description
- ✓Images
- ✓Catégories
- ✓Classe de TVA
- ✓Commandes
Les règles
- Produits simples seulement. Les produits à variantes et les kits ne sont pas publiés.
- Un produit retiré de la vente dans GSE-Web passe en brouillon dans la boutique. Il n'y est jamais supprimé.
- Une fiche modifiée en boutique sur un champ dont GSE-Web fait foi est réécrite au prochain changement du produit dans GSE-Web.
- Stock publié = stock disponible du magasin publié (physique moins réservé), arrondi à l'unité inférieure, jamais négatif. Il est relu à chaque passage et renvoyé s'il a changé.
- Une commande = un bon de sortie confirmé du magasin publié, stock réservé, adresse de livraison reprise. Jamais de bon partiel : si une ligne pose problème (produit inconnu, variante, e-mail absent, autre devise), aucun bon n'est créé et un point à traiter l'explique.
- Un acheteur = un client « particulier », retrouvé par son e-mail d'une commande à l'autre (code commençant par WEB-). Un tiers déjà présent dans GSE-Web n'est pas rapproché : un client « particulier » est créé.
- Commande annulée en boutique (annulée, remboursée, échouée, mise à la corbeille ou supprimée) : le bon est annulé et ses réservations libérées, sauf s'il est déjà pris en charge par quelqu'un. Dans ce cas, un point à traiter laisse la décision à l'équipe.
- Commande modifiée en boutique après import : la modification n'est pas reportée sur le bon ; un point à traiter vous invite à le vérifier.
Au quotidien
L'écran du connecteur se lit de haut en bas : l'état, la boutique, les réglages, les boutons, puis les points à traiter et le journal.
La carte « État »
Elle dit où en est la connexion, la version de WooCommerce et la devise de la boutique, la date de la dernière synchronisation, la dernière erreur et le nombre de points à traiter. Sur la carte de la page « Intégrations », l'état tient en une puce.
- À activer « Configurée, pas encore activée ».
- Connecté « Active — synchronisation toutes les 5 minutes ».
- En pause « En pause — rien n'est envoyé ni importé ».
- Arrêté — à vérifier « Arrêtée par le serveur — vérifiez la clé et testez ».
« Synchroniser maintenant »
Lance un passage sans attendre les 5 minutes : fiches, stock et rattrapage des commandes. Le message dit si le passage est terminé, s'il a relevé des points à traiter, ou pourquoi il n'a pas été lancé.
Le « Journal »
Chaque passage y figure avec son type et son résultat. Types : « Fiches produits », « Stock », « Rattrapage des commandes », « Commande reçue », « Contrôle des webhooks », « Test de connexion ». Résultats : « Réussi », « Partiel », « Échec », « En cours », « Interrompu ».
Les « Points à traiter »
Une ligne qui ne passe pas ne bloque jamais la synchronisation : elle devient un point à traiter et le reste continue. Les points des fiches et du stock disparaissent d'eux-mêmes quand leur cause est corrigée. Les points des commandes portent deux boutons.
- « Rejouer » relit la commande dans la boutique et retente l'import, quel que soit son âge.
- « Ignorer » range le point : un point ignoré ne revient pas dans la liste.
Fiches produits
- Cause
- Seuls les produits simples sont publiés en boutique.
- Que faire
- Rien à faire dans GSE-Web. Gérez ce produit directement dans la boutique.
- Cause
- Le produit n'a pas de prix de vente dans GSE-Web.
- Que faire
- Renseignez son prix de vente. Le point disparaît au passage suivant.
- Cause
- Les prix sont publiés TTC et le produit n'a pas de taux de TVA.
- Que faire
- Renseignez le taux de TVA du produit.
- Cause
- Le produit de la boutique qui porte cette référence est déjà relié à un autre produit de GSE-Web, ou n'est pas un produit simple. Une référence qui contient une virgule ne peut pas non plus être recherchée en boutique.
- Que faire
- Faites en sorte qu'une référence désigne un seul produit, des deux côtés.
- Cause
- WooCommerce a refusé la fiche ; son code de refus est affiché.
- Que faire
- Vérifiez le produit dans la boutique à partir de ce code.
- Cause
- Le produit relié n'existe plus dans la boutique.
- Que faire
- Recréez-le dans la boutique avec la même référence. S'il ne doit plus y figurer, écrivez-nous.
Stock
- Cause
- Le stock disponible porte des décimales ; la boutique ne vend que des unités entières.
- Que faire
- Information seulement : la boutique affiche l'unité inférieure.
- Cause
- WooCommerce a refusé la quantité ; son code de refus est affiché.
- Que faire
- Vérifiez la fiche du produit dans la boutique à partir de ce code.
Commandes
- Cause
- Une ligne de la commande porte une référence absente de GSE-Web.
- Que faire
- Créez le produit avec la même référence, puis « Rejouer ».
- Cause
- La commande contient une variante de produit, que le connecteur ne gère pas encore.
- Que faire
- Traitez cette commande à la main.
- Cause
- Sans e-mail, l'acheteur ne peut pas être retrouvé ni créé comme client.
- Que faire
- Ajoutez l'e-mail de facturation à la commande dans la boutique, puis « Rejouer ».
- Cause
- Le client qui correspond à cet acheteur a été archivé.
- Que faire
- Aucun bon n'est créé. Traitez cette commande à la main.
- Cause
- La commande est dans une autre devise que votre organisation.
- Que faire
- Traitez cette commande à la main.
- Cause
- Au rattrapage, la commande dépasse l'« Âge maximal d'une commande rattrapée ».
- Que faire
- « Rejouer » l'importe quand même.
- Cause
- Le bon est déjà en préparation : GSE-Web ne l'annule pas tout seul.
- Que faire
- Décidez avec l'équipe. Si le bon doit être annulé, libérez-le, puis « Rejouer ».
- Cause
- La commande a changé dans la boutique après la création du bon ; la modification n'est pas reportée.
- Que faire
- Comparez la commande et le bon, et corrigez le bon si besoin.
- Cause
- L'import a échoué ; le motif est affiché entre parenthèses.
- Que faire
- Corrigez la cause indiquée, puis « Rejouer ».
Webhooks
- Cause
- WooCommerce désactive un webhook après plusieurs échecs de livraison, ou un webhook « GSE-Web » a été supprimé dans la boutique.
- Que faire
- Rien à faire : le contrôle des webhooks, toutes les 6 heures, les réarme et rattrape les commandes.
Pause, reprise et changements
Le connecteur se coupe et se rouvre à tout moment. Trois changements ont une règle, que l'écran rappelle et que le serveur fait respecter.
« Mettre en pause »
Plus rien n'est envoyé ni importé, et rien n'est perdu. Le stock affiché en boutique reste celui du dernier envoi.
« Reprendre »
La boutique est de nouveau vérifiée (version, clé, devise, régime de prix), puis le rattrapage est lancé : les commandes passées pendant la pause sont importées si elles ont moins de N jours (« Âge maximal d'une commande rattrapée », 30 par défaut, de 1 à 90). Plus anciennes, elles deviennent des points à traiter.
Changer de clé ou de régime HT/TTC
Sous une connexion active, l'adresse, la clé, le secret et « Prix publiés » sont verrouillés. Suivez cet ordre : « Mettre en pause », modifier, « Enregistrer », « Tester la connexion », « Reprendre ».
Changer de boutique
« Déconnecter » d'abord : les webhooks de l'ancienne boutique sont retirés. Saisissez ensuite la nouvelle boutique.
Reconnecter la même boutique
Les produits, les commandes et les clients déjà reliés sont retrouvés : aucun second bon n'est créé pour une commande déjà importée.
Changer un réglage de fiche
Après un changement de « Prix publiés » ou de « Créer et mettre à jour les fiches produits en boutique », le passage suivant relit tout le catalogue.
« Déconnecter »
Les webhooks sont retirés de la boutique et les identifiants effacés. Rien n'est supprimé en boutique ni dans GSE-Web : les bons et les clients déjà importés restent. Si la boutique ne répond pas, l'écran vous demande de supprimer vous-même les webhooks « GSE-Web » dans WooCommerce.
Fermeture du module
Si KLS-Concept ferme le module pour votre organisation, tout s'arrête sans rien supprimer. À la réouverture, le passage suivant rattrape les commandes et republie le stock.
Sécurité et données
Ce que le connecteur garde, et comment.
Identifiants chiffrés
La clé et le secret de la boutique sont chiffrés sur le serveur (AES-256-GCM). Ils ne sont jamais réaffichés, ni inscrits dans les journaux.
Double authentification
Elle est exigée pour saisir ou remplacer les identifiants d'une boutique.
HTTPS seulement
L'adresse de la boutique doit être en HTTPS et joignable sur Internet ; une adresse de réseau privé est refusée.
Webhooks signés
Chaque webhook reçu est signé par la boutique, et sa signature est vérifiée avant tout traitement. Son contenu n'est pas conservé.
Données de l'acheteur
Ses coordonnées sont reprises dans sa fiche client et l'adresse de livraison sur le bon. Le lien avec la boutique ne garde qu'une empreinte de son e-mail.
Rien dans l'export
Les identifiants chiffrés ne figurent pas dans l'export de portabilité de l'organisation.
Dépannage
Le message affiché par l'écran, sa cause et ce qu'il faut faire. Le code entre crochets aide le support à retrouver le cas.
« Arrêtée par le serveur — vérifiez la clé et testez »
Après cinq refus d'authentification d'affilée, le serveur arrête la connexion pour ne pas insister. Vérifiez la clé dans WooCommerce, saisissez-en une nouvelle si besoin, « Enregistrer », « Tester la connexion », puis « Activer ».
- Que faire
- Saisissez l'adresse complète de la boutique, qui commence par https://, sans rien après le nom du site.
[WOOCOMMERCE_SHOP_URL_INVALID]
- Que faire
- Utilisez l'adresse publique de la boutique.
[WOOCOMMERCE_SHOP_URL_PRIVATE_HOST]
- Que faire
- Vérifiez la clé et le secret dans WooCommerce (Réglages › Avancé › API REST), ou créez-en une nouvelle.
[WOOCOMMERCE_SHOP_AUTH_FAILED]
- Que faire
- Créez une clé avec les droits « Lecture/Écriture » et saisissez-la.
[WOOCOMMERCE_SHOP_READ_ONLY_KEY]
- Que faire
- Mettez WooCommerce à jour (7.0 au minimum), puis testez de nouveau.
[WOOCOMMERCE_SHOP_VERSION_UNSUPPORTED]
- Que faire
- Le connecteur ne relie qu'une boutique dans la devise de votre organisation.
[WOOCOMMERCE_SHOP_CURRENCY_MISMATCH]
- Que faire
- Alignez « Prix publiés » sur le réglage « Saisir les prix toutes taxes comprises » de la boutique, enregistrez, testez.
[WOOCOMMERCE_SHOP_PRICE_MODE_MISMATCH]
- Que faire
- Vérifiez que la boutique répond, puis réessayez.
[WOOCOMMERCE_SHOP_UNREACHABLE]
- Que faire
- Réessayez un peu plus tard.
[WOOCOMMERCE_SHOP_TIMEOUT]
- Que faire
- Patientez : le passage suivant reprend de lui-même.
[WOOCOMMERCE_SHOP_RATE_LIMITED]
- Que faire
- Vérifiez que l'adresse mène bien à la boutique WooCommerce et que l'API REST y est active.
[WOOCOMMERCE_SHOP_RESPONSE_INVALID]
- Que faire
- « Mettre en pause », modifier, « Enregistrer », « Tester la connexion », « Reprendre ».
[WOOCOMMERCE_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Que faire
- « Déconnecter », puis saisissez la nouvelle boutique.
[WOOCOMMERCE_SHOP_CHANGE_REQUIRES_DISCONNECT]
- Que faire
- Suivez cet ordre ; le régime est vérifié contre la boutique au test et à la reprise.
[WOOCOMMERCE_PRICE_MODE_CHANGE_REQUIRES_PAUSE]
- Que faire
- Saisissez les deux, ou laissez les deux vides pour garder la clé enregistrée.
[WOOCOMMERCE_CREDENTIALS_REQUIRED]
- Que faire
- Activez-la dans « Mes informations » (l'écran propose « Ouvrir « Mes informations » »), puis enregistrez de nouveau.
[WOOCOMMERCE_CONNECTION_TWO_FACTOR_REQUIRED]
- Que faire
- Choisissez un magasin réel comme « Magasin publié ».
[WOOCOMMERCE_WAREHOUSE_EXERCISE_REFUSED]
- Que faire
- Saisissez de nouveau la clé et le secret, testez, puis activez.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
- Que faire
- Attendez la fin du passage en cours.
[INTEGRATIONS_CONNECTION_BUSY]
Questions fréquentes
Les produits à variantes sont-ils pris en charge ?
Pas encore. Seuls les produits simples sont publiés. Une commande qui contient une variante n'est pas importée : elle apparaît dans les points à traiter.
Peut-on relier plusieurs boutiques ou plusieurs magasins ?
Non. Une organisation relie une boutique, et une boutique est reliée à un seul magasin, le « Magasin publié ».
Les expéditions sont-elles renvoyées à la boutique ?
Non. GSE-Web n'écrit jamais dans les commandes de la boutique. La remontée des expéditions est prévue dans une prochaine version.
Les images des produits sont-elles envoyées ?
Non. Les images, comme la description et les catégories, restent gérées dans la boutique.
Que se passe-t-il si je mets en pause ou si le module est fermé ?
Rien n'est envoyé ni importé, et rien n'est supprimé. Le stock en boutique reste celui du dernier envoi. À la reprise, les commandes passées entre-temps sont rattrapées si elles ont moins de 30 jours (réglable de 1 à 90).
Au bout de combien de temps une commande apparaît-elle dans GSE-Web ?
Aussitôt, par webhook. Si un webhook se perd, le passage suivant, toutes les 5 minutes, rattrape la commande.
Peut-on vendre en boutique un produit qui n'est plus en stock ?
Le stock est relu à chaque passage, toutes les 5 minutes, et renvoyé s'il a changé. Entre deux passages, la boutique affiche le dernier stock envoyé : une sortie faite dans GSE-Web pendant ce court intervalle n'y est visible qu'au passage suivant.
Un acheteur déjà présent dans mes tiers est-il reconnu ?
Non. Le connecteur crée un client « particulier » par acheteur et le retrouve par son e-mail aux commandes suivantes, mais il ne le rapproche pas d'un tiers déjà saisi dans GSE-Web.
Les commandes passées avant l'activation sont-elles importées ?
Non. Seules les commandes reçues après l'activation sont importées.
Et Shopify, Sage ou Odoo ?
Ils figurent dans la page « Intégrations », comme connecteurs à venir. Aucune date n'est annoncée.
Comment obtenir le connecteur ?
Les modules « Intégrations » et « WooCommerce » sont ouverts organisation par organisation par KLS-Concept. Écrivez-nous depuis la page de contact.
Relier votre boutique WooCommerce
Demandez l'ouverture du connecteur pour votre organisation, ou posez-nous vos questions sur votre cas.