✅ Le plugin est compatible à partir de la version 2.3.7 jusqu'à 2.4.5 de Magento 2 et peut être utilisé UNIQUEMENT avec la plateforme Lengow version 3.
Ce guide s'adresse aux marchands qui utilisent la plateforme actuelle de Lengow uniquement (version 3).
> Obtenez le plugin Lengow pour Magento 2 ici !
1. Installation du module
1/ Installez le Module Lengow dans Magento2
Pour installer le module, suivez ces étapes :
ÉTAPE 1 :
- Ouvrir le fichier téléchargé (avec l'extension en .zip) afin d'extraire les données dans un répertoire de votre ordinateur (à l'aide d'un outil tel que WinRar, WinZIP ou similaire).
ÉTAPE 2 :
- Placer les dossiers et fichiers extraits dans le répertoire racine de votre installation Magento.
- Le répertoire racine de Magento est le dossier qui contient les répertoires "app", "bin", "lib" et plus encore. (Tous les dossiers doivent correspondre avec la structure de répertoire existante pour fusionner).
- Se connecter via SSH et exécuter les commandes suivantes (Assurez-vous de les exécuter avec l'utilisateur qui possède les droits de modification sur les fichiers Magento) :
php bin/magento maintenance:enable
- Allez dans "Système"> "Gestion du cache"
- Cliquez sur le "Flush Magento Cache" ainsi que le bouton "Flush Cache Storage". Ceci est nécessaire pour activer l'extension.
2/ Connectez le Module Lengow à votre compte Lengow
Cliquez sur "Connecter mon cms avec Lengow" et renseignez vos identifiants API Lengow (jeton d'accès et secret).
Vous trouverez ces informations dans les paramètres de votre compte, section "A.P.I".
Les étapes de connexion sont les mêmes pour tous nos modules/applications CMS. Retrouvez tous les détails ici !
Une fois la connexion réalisée, retrouvez sur la page d'accueil :
-
- L'accès aux produits à exporter dans la plateforme Lengow.
- L'accès aux informations concernant les commandes provenant de la plateforme Lengow.
- Les principaux du module.
- Un accès à notre Help Center et à notre Support Client.
La procédure de mise à jour est identique à l'installation du module.
1.2 Mise à jour du module
Vous n'avez pas besoin de désinstaller l'ancienne version du module et cela n'est pas recommandé.
ÉTAPE 1 : Décompressez le fichier zip
-
cela vous créera un dossier nommé lengow.magento2.{versionxx}
- Faites glisser le fichier lengow.magento2. Dossier {Version} à la racine de votre site
- Accepter de remplacer tous les anciens fichiers
- cp -rf lengow.magento2.{Version}/* {your-magento-root}/
- Lancez ensuite les commandes suivantes dans votre console Magento:
- Vérifiez que la version du module Lengow a correctement changé en allant sur n'importe quelle page du module et en regardant le pied de page.
- Si vous voyez cette pop-up s'afficher, cela signifie que votre version est devenue obsolète.
- Si vous ne parvenez pas à accéder à cette fenêtre contextuelle, demandez la dernière version du module à notre équipe Support.
Notez que cette procédure n'est pas destinée aux marchands qui souhaitent migrer de la plateforme Lengow v2 ou de la version hybride de Lengow vers la plateforme Lengow v3 où des étapes supplémentaires sont demandées. Contactez notre équipe Support si vous êtes dans cette situation.
2. Configuration du module dans Lengow
À la première utilisation du module Magento, quelques paramétrages sont à réaliser.
2.1 Paramètres principaux
Retrouvez ici :
Dans ce bloc, les champs suivants sont automatiquement complétés avec les informations d'identification de votre compte Lengow.
- Lengow Account ID
- Access Token
- Secret Token
ATTENTION : Ces champs se complètent automatiquement, ne pas modifier ces informations.
- Activer l'autorisation par IP / IP autorisées
- Tracker Product ID
2.2 Paramètres d'export de produits
Vous pouvez :
Exporter seulement les produits sélectionnés: si cette option est activée, seuls les produits sélectionnés seront exportés dans votre catalogue produits.
- Sélectionner les types de produits à exporter (configurable, simple, packagé, groupé et/ou virtuel).
- Sélectionner le statut des produits à exporter : avec cette option vous pouvez limiter l'export à vos produits activés (Enabled), désactivés (Disabled) ou les deux (Enabled, Disabled).
- Sélectionner les attributs à exporter : cette option permet de choisir les champs de vos produits que vous souhaitez exporter. Pour cela, sélectionnez vos champs parmi la liste qui est affichée. Si vous souhaitez sélectionner plusieurs champs, maintenez la touche "Ctrl" ou "Command" pour en sélectionner plusieurs.
- Sélectionner le pays d'expédition à appliquer pour les frais d'expédition
- Choisir votre mode d'expédition à appliquer par défaut pour calculer les frais d'expédition
- Saisir vos frais d'expédition à appliquer par défaut
- Fusionner les images avec les produits parents : si vous activez cette option, les images des produits parents sont fusionnées avec celles du produit enfant. Les images sont limitées à 5 par produit.
- Sélectionnez les attributs à exporter depuis les produits parents pour les produits enfants : Les valeurs des attributs des produits parent seront directement renseignées sur les produits enfants
- Sauvegarder les flux dans un fichier : cette option est utile dans le cas où votre catalogue contient un grand nombre de produits (+ 3000) ou que votre catalogue prend beaucoup de temps à se générer. Grâce à cette option votre catalogue est enregistré dans un fichier situé dans le dossier /media/lengow de votre Magento. Attention : si vous passez par un fichier, il est important d'activer la tâche planifiée pour maintenir votre fichier à jour.
- Autoriser le process Cron de Magento. Permet de lancer le processus d'export toutes les 4 heures. Cette option est utile dans le cas où l'option "Sauvegarder le flux dans un fichier" est activée. Cela permet de garder votre fichier à jour. Cette option fait appel au système CRON de Magento.
2.3 Paramètres d'import de commandes
Vous pouvez :
- Synchroniser toutes les commande mises à jour depuis : la période (en jour) maximale sur laquelle le module vient synchroniser les commandes.
Dans le cas d'une synchronisation cron, l'intervalle de temps est géré de manière automatique par le module et se base sur la date de la dernière synchronisation réussie.
Par exemple, si la dernière synchronisation était il y a une heure, le module récupérera uniquement les dernières heures.
A l'inverse, si la dernière synchronisation date de 3 jours, le module synchronisera sur les 3 derniers jours sans jamais dépasser le nombre maximum de jours que vous avez renseignés (Il est conseillé de laisser ce paramètre sur 3 jours). - Sélectionner votre groupe client : Permet d'assigner les clients créés au moment de l'import à un groupe de clients.
- Choisir votre mode d'expédition : Pour les commandes expédiées par les places de marché.
- Activer les notifications en cas de problème lors de l'import des commandes
- Importer les commandes expédiée par les places de marché et décrémenter les stocks concernés
- Importer les commandes B2B sans taxe : Cette option permet de supprimer les taxes des commandes de type B2B. Par défaut, cette option est désactivée.
-
Activer la conversion de devise de vos commandes :
Toutes les commandes importées dans Magento 2 seront automatiquement converties dans la devise choisie dans Lengow. -
Activer le Debug Mode : Utilisez le Debug Mode pour tester et simuler des commandes fictives. Pour rappel, vous devez activer ce paramètre UNIQUEMENT et OBLIGATOIREMENT sur votre serveur de préproduction.
- Autoriser le process Cron de Magento. Permet de lancer le processus de synchronisation toutes les 30 minutes. Cela permet de garder vos commandes marketplace et actions d'envoi et d'annulation à jour. Cette option fait appel au système CRON de Magento. Attention cependant d'activer cette option uniquement si la synchronisation automatique Lengow ne tourne pas, sinon les deux processus tourneront en même temps et pourront provoquer des doublons de commandes.
Gérer vos produits
Dans cette section, sélectionnez les produits à exporter dans la plateforme Lengow. Pour chacune de vos boutiques Magento, choisissez si vous souhaitez envoyer l'ensemble ou une sélection des produits.
Pour télécharger le catalogue produits contenant votre sélection de produits, cliquez sur l'icône "Télécharger"
Gérer vos commandes
Dans cette section, retrouvez :
- Le nombre de commandes en erreur et en attente d'expéditionsi vous en avez
- La dernière date de synchronisationavec la plateforme Lengow. Vous pouvez effectuer une synchronisation manuelle en cliquant sur le bouton "Synchroniser les commandes"
- La possibilité de modifier l'adresse e-mail réceptionnant les rapports d'erreurs.
- Vos commandes importées, filtrables sur plusieurs données (statut Lengow, place de marché, ID commande, ...)
- La possibilité de réimporter ou renvoyer les commandes. Cliquez sur le menu déroulant "Actions" et sélectionnez l'option désirée.
- Les commandes ne sont importées qu'une fois qu'elles sont passées au statut "En attente d'expédition" et "expédiée".
- L'import de commande dans le module entrainant une décrémentation du stock sur le produit commandé, aucun import n'est réalisé au statut "annulée" et "remboursée".
- Une fois la commande importée dans le module, celle ci ne sera plus synchronisée avec le module.
Le traitement des commandes provenant des places de marchés doit être géré en dehors du module Lengow, rendez-vous au niveau de l'onglet "Commande" de votre Magento2.
Pour chacune de vos commandes provenant de Lengow, vous trouverez un nouvel onglet Lengow avec toutes les informations de la commande et les actions suivantes :
- Ré-importer la commande : recréé une nouvelle commande, passer la commande actuelle en erreur technique Lengow, mais ça ne va pas redécrémenter les stock
- Ré-envoyer l'action : Permet de renvoyer l'action du changement de statut de commande à Lengow. (Pratique pour corriger une erreur d'import de commande, si vous venez de renseigner le tracking colis qui avait été oublié par exemple).
- Re-synchroniser la commande : Permet de refaire le matching entre l'identifiant de la commande Magento et l'identifiant de la commande dans Lengow.
Au niveau du module, vous retrouvez l'ensemble des commandes provenant des places de marchés, pour savoir :
- Si la commande a bien été importé dans votre Magento.
- Le statut actuel de vos commandes (en cours et terminées)
Si une commande ne s'est pas importée correctement dans votre Magento, la notion "Pas importée" apparaît.
Survolez cette notion pour connaître l'erreur qui empêche l'import de la commande.
Résolvez le problème et cliquez sur la notion "Pas importée" pour relancer l'import de cette commande.
Si vous avez des difficultés à résoudre le problème, contactez notre Support Client.
