Différences

Ci-dessous, les différences entre deux révisions de la page.

--- wiki:extensv15:woocommerce [2023/07/18 20:49] – [Spécificité commandes] jsiegwald
+++ wiki:extensv15:woocommerce [2025/10/21 21:43] (Version actuelle) – [Spécificité commandes] jsiegwald
@@ Ligne 1: / Ligne 1: @@
+====== WOOCOMMERCE Commerce en ligne ======
+{{ :wiki:v15:extensions:woocommerce.jpg?nolink&200|}}
+**//Une extension proposée par : [[https://www.lcpstudio.fr|LCP-Studio]].//**
+Ce module d'interface Woocommerce a été développé afin de synchroniser Gestan et une boutique Woocommerce, notamment :
+  * Les clients enregistrés (Woocommerce vers Gestan)
+  * Les produits (Bi-directionnel)
+  * Les stocks (Gestan vers Woocommerce)
+  * Les commandes (Woocommerce vers Gestan) ou les devis, les factures, et bons de livraison.
+===== Comment ça marche ? =====
+Facilement !
+Woocommerce permet via son API, de communiquer avec lui. On peut tout voir et tout modifier: une vraie belle idée de l'équipe de Woocommerce.
+<btn type="primary" size="sm" icon="glyphicon glyphicon-shopping-cart">[[https://www.lcpstudio.fr/commande-2|Acheter en ligne sur la boutique LCP Studio]]</btn>
+//Extension LCP Studio proposée au prix de 435€ HT.//
+===== Paramétrage =====
+==== Pré-requis ====
+  * Le module demande des informations à votre boutique Woocommerce et il se peut que votre hébergeur limite le nombre de ces demandes. Si votre base Woocommerce est importante //(plusieurs milliers de commandes par exemple)//, la première importation risque de prendre un certain temps, voir de se bloquer.
+  * Il est indispensable d'avoir une connexion via SSL (https) pour la communication avec l'API. Contactez votre hébergeur en cas de doutes.
+  * La réécriture d'URL doit être activée sur Wordpress et les permaliens structurés.
+  * La communication vers les ports 21 et 80 doit être ouverte vers le site e-commerce considéré (si votre installation est protégée par un pare-feu ou utilise un proxy)
+<alert type="info" icon="glyphicon glyphicon-cloud">Pour les utilisateurs de Gestan Cloud : prenez contact avec le Support Cloud si vous souhaitez utiliser cette extension. En effet, l'ouverture des port 21 et 80 vers le domaine que vous souhaitez utiliser est réservée au support technique.</alert>
+==== Côté Woocommerce ====
+Pour commencer, il vous faut créer une clé de communication dans votre boutique Woocommerce.
+Pour obtenir/créer une clé de votre boutique en ligne, connectez-vous au BackOffice de votre boutique.
+Passez ensuite votre souris sur l'onglet "Woocommerce" puis "Réglages". Une fois sur cette page, cliquez sur "API". Cochez la case pour activer l'API
+{{:wiki:v15:extensions:activerapi.png?nolink| Activer l'API}}
+Allez ensuite dans l'onglet "Clé/apps", puis cliquez sur "Ajouter une clé"
+{{:wiki:v15:extensions:ajoutercle.png?nolink| Ajout d'une clé}}
+Indiquez une description qui vous parle (du type "communication avec Gestan"), un utilisateur (vous !), et des droits en lecture et écriture.
+{{:wiki:v15:extensions:crecle.png?nolink| Détails de clé}}
+En générant une clé, vous obtiendrez le précieux sésame, à garder, et en sécurité de préférence !
+{{:wiki:v15:extensions:cle.png?nolink|}}
+==== Côté Gestan ====
+Pour accéder à la fenêtre de paramétrage, sur Gestan, allez dans Outils > Paramètres de l'application > Paramétrage des extensions > Connecteur Woocommerce.
+Dans le cas où nous vous avons fourni directement le fichier, vous pouvez le placer dans le répertoire "c:\Utilisateurs\[votre nom d'utilisateur]\AppData (dossier caché)\Roaming\GESTAN_15".
+=== Onglet "Connexion" ===
+{{:wiki:extensv15:paramcle.png?nolink|}}
+  * **Adresse du site**: Adresse (URL) de votre boutique Woocommerce
+  * **Clé cliente**: La clé cliente API précédemment créée
+  * **Clé secrète**: La clé secrète API précédemment créée
+TIP Ne vous cassez pas la tête ! Pour éviter les erreurs de frappe, copier-coller ces éléments !
+=== Onglet "FTP" ===
+{{:wiki:extensv15:param_ftp.png?nolink|}}
+Afin de téléverser les images de Gestan vers Woocommerce, il est nécessaire d'avoir un accès FTP à la racine du site Wordpress. En cas de doute, n'hésitez pas à contacter votre hébergeur.
+=== Onglet "Mappage familles", "Mappage modes de paiement" et "Mappage produits" ===
+{{:wiki:extensv15:mappage_familles.png?nolink|}}
+:?: Un mappage est une association des données appartenant à Woocommerce avec les données appartenant à Gestan, de manière à ce que que l’on puisse passer harmonieusement des premières aux secondes.
+Avant tout, cliquez sur le bouton **Import catégories Wordpress**. Pas d'inquiétude, cela ne va pas les importer dans votre base Gestan, mais dans un fichier temporaire utile à la synchronisation.
+Une fois cette manipulation effectuée, vous pourrez mappez les familles et les produits.
+Pour chaque catégorie Woocommerce, indiquez vers quelle famille (ou sous-famille si elles sont gérées) doivent être synchronisée les produits.
+Il en est de même pour le mappage des modes de paiement, dans le cas où vous créez des écritures à l'import des commandes.
+{{:wiki:extensv15:mappage_mdp.png?nolink|}}
+Le mappage des produits permet de supprimer une liaison existante ou de la "forcer". Ces liaisons sont créées automatiquement à l'import d'un produit.
+{{:wiki:extensv15:mappage_produits.png?nolink|}}
+=== Onglet "Facturation" ===
+{{:wiki:extensv15:parametre_facturation.png?nolink|}}
+**Factures**
+En plus de la création de commande, ce module peut créer automatiquement des factures si vous cochez la case correspondante.\\
+**Envoi**
+Pour gérer les frais de transports liés à vos commandes Woocommerce, vous devez sélectionner un produit déjà existant de votre base Gestan, qui gère les frais de port.
+**Écritures**
+Si vos commandes Woocommerce sont réglées, que vous importez des factures et que vous souhaitez gérer également leurs encaissements, vous pouvez cocher la case "Créer une écriture". Il vous faudra alors également spécifier un compte bancaire et une imputation comptable. Note: le compte bancaire doit être un compte professionnel pour que les imputations soient correctes.
+===== Utilisation =====
+==== Généralités ====
+Il existe 4 fenêtres d'import:
+  * Produits
+  * Stock
+  * Contacts
+  * Commandes
+Elles fonctionnent toutes de la même manière. Vous pouvez lire la liste des éléments grâce au bouton **Lecture** (//On a beaucoup réfléchi pour la dénomination de ce bouton, puis on s'est dit que c'était assez explicite finalement !//)\\
+Une fois lu, les éléments s'affichent: vous pouvez sélectionner ceux que vous souhaitez importer, puis cliquer sur **Exécuter**.\\
+Un compte-rendu sera affiché à la fin du traitement.
+{{:wiki:v15:extensions:selectionall.png?nolink|}} Permet de sélectionner/désélectionner tous les éléments d'un seul clic.
+==== Spécificité produits ====
+{{:wiki:extensv15:produits.png?nolink|}}
+La 1<sup>ère</sup> colonne vous permettra de sélectionner les produits à importer ou non.
+La 2<sup>ème</sup> colonne comporte le code produit Gestan.
+La 3<sup>ème</sup> colonne comporte le nom du produit.
+La 4<sup>ème</sup> colonne montre la catégorie Woocommerce ou la famille Gestan.
+La 5<sup>ème</sup> colonne affiche le prix, pour une meilleure lisibilité.
+Enfin, la 5<sup>ème</sup> colonne vous montre le statut du produit: **Ajouter à Gestan**, **MAJ Gestan**, **MAJ Woocommerce**, **Ajouter à Woocommerce**.
+Les ligne surligné en jaune sont les produits lus de Gestan. Ceux en blanc sont ceux provenant de Woocommerce.
+Cochez la case **Afficher les produits à mettre à jour** pour afficher l'ensemble des produits à mettre à jour et à créer. La décocher ne montrera que les produits à créer.
+Cochez la case **Synchroniser les images** permet d'importer également les images dans la fiche produit de Gestan. Toutefois, cela peut ralentir le traitement.
+Le combo **Affichage famille** permet de limiter les synchronisation de Gestan vers Woocommerce qu'à la famille sélectionnée.
+Le combo **Sens** permet de renseigner le sens de synchronisation. Il peut ainsi être:
+  * Bidirectionnel (Gestan vers Woocommerce et Woocommerce vers Gestan)
+  * Woocommerce vers Gestan
+  * Gestan vers Woocommerce
+Enfin, le bouton **Blacklister** permet de mettre de côté un produit. S'il ne sera jamais utilisé dans Woocommerce, il est possible de ne plus l'afficher dans cette liste. Pour le déblacklister, il faut se rendre dans le menu approprié "Métier > Woocommerce > Produits blacklistés". Un bouton **Déblacklister** vous permet de les retirer de cette liste.
+{{:wiki:extensv15:blackliste.png?nolink|}}
+==== Spécificité stock ====
+{{:wiki:extensv15:stocks.png?nolink|}}
+<WRAP center round important>
+Woocommerce ne gère pas les décimales pour la gestion de stock: le module enverra le stock courant du produit à l'entier inférieur, sans les virgules !
+</WRAP>
+==== Spécificité contacts ====
+{{:wiki:extensv15:contacts.png?nolink|}}
+La 1<sup>ère</sup> colonne vous permettra de sélectionner les contacts à importer ou non.
+La 2<sup>ème</sup> colonne comporte le nom du contact.
+La 3<sup>ème</sup> colonne comporte l'email du contact.
+Enfin, la 4<sup>ème</sup> colonne vous montre le statut du contact: **Ajout** ou **A jour**.
+==== Spécificité commandes ====
+{{:wiki:extensv15:cmd.png?nolink|}}
+Pour l'import des commandes, vous pouvez lire les commandes en sélectionnant une plage de dates en haut à droite de la fenêtre.
+<WRAP center round tip>
+Pour éviter de surcharger la table, vous pouvez ne pas afficher les commandes déjà importées grâce à la case à cocher **Inclure les commandes déjà importées**
+</WRAP>
+Il est également possible, via la combo, de filtrer les commandes par statut (En cours, En attente, etc...)
+-----------------
+^ Version ^ Date ^ Observations ^
+| 3.15.05.19 | 21/10/25 | Bugfix (le taux de TVA des frais de port était celui du produit alors qu'en vente à l'international, il faut le taux de TVA du pays)|
+| 3.15.05.18 | 28/02/25 | Bugfix (la mise à jour d'un produit avec un libellé contenant des caractères spéciaux ne fonctionnait pas)|
+| 3.15.05.17 | 04/06/24 | Ajout d'une fonction de temporisation entre deux appels au serveur |
+| 3.15.05.16 | 10/10/23 | ☝ Il est désormais possible d'utiliser plusieurs boutiques ! |
+| 3.15.05.15 | 30/09/23 | Woocommerce ne gère pas les décimales pour les stocks produit. Bug corrigé en ne transmettant à Woocommerce que la valeur entière du stock courant d'un produit |
+| 3.15.05.14 | 18/07/23 | Passage à Windev 28, ajout de la sélection de l'imputation dans le paramétrage, ajout de la gestion de licence et implémentation du test de distance de Levenshtein pour la gestion des homonymes |
+| 3.15.05.13 | 14/05/23 | Résolution d'un bug lié à la multi-lecture des listes de commandes |
+| 3.15.05.12 | 11/11/22 | Mise au format Gestan Ax |
+| 3.15.05.11 | 05/10/22 | Ajout d'un échappement pour fonctionner en parallèle du module ABO |
+| 3.15.05.10 | 04/07/22 | Ajout d'une possibilité de filtrer les statuts de commandes |
+| 3.15.05.09 | 08/06/22 | Passage à Windev 27 et ajout d'une fonction de blacklistage des produits non-utilisés |
+| 3.15.05.08 | 04/08/21 | Passage à Windev 26 |
+| 3.15.05.07 | 28/05/21 | Petits bugfix |
+-----------------
+{{:wiki:tags:voir_aussi.gif?nolink |}}**Autres articles "Extensions"**
+<nspages wiki:extensv15 -nbCol=2 -textPages="" -h1 -r -simpleLineBreak >