Module Magento V2

1. Installation du module Magento V2

1.1 Compatibilité

Le module Lengow pour Magento est compatible à partir de la version 1.5 de Magento.

1.2 Télécharger le module

Pour télécharger le module :

https://www.lengow.com/fr/integrations/magento/

1.3 Installation du module dans votre Magento

Avant d'installer / mettre à jour le module, suivez nos conseils !

Pour installer l'extension Lengow pour Magento : 

  • via Magento Connect : onglet Système > Magento Connect > Magento Connect Manager. Insérez l’archive dans le champ prévu à cet effet et cliquez sur Upload.

  • via FTP : décompressez l’archive sur votre ordinateur, connectez vous à votre serveur FTP, naviguez jusqu’à la racine de Magento et fusionnez les dossiers tirés de l’archive avec ceux présents dans le dossier racine Magento.

Une fois l'installation terminée, déconnectez-vous et re-connectez-vous à votre backoffice Magento afin de recharger les droits utilisateur. Il sera peut-être aussi nécessaire de vider les caches (onglet Système > Gestion du cache). Un nouvel onglet Lengow doit alors apparaitre dans votre back office ainsi qu'un nouveau menu Lengow dans Système > Configuration.

Avec cet onglet vous pouvez accéder à la gestion de votre catalogue produit (Gestion des produits), à vos commandes Lengow (Gestion des commandes), à vos flux (Manage Feeds) et aux logs du module (Logs).

2. Configuration du module

Pour accèder à la configuration de votre module Lengow, aller dans l'onglet Système > Configuration.
Dans la liste des modules sur la gauche, Lengow doit apparaitre et vous laisse le choix d'accèder à Compte Utilisateur, Configuration de l'export et Gestion des commandes.

Pensez à sauvegarder votre configuration à chaque modification en cliquant sur Sauvegarder la configuration.

2.1 Compte Utilisateur

La partie Compte Utilisateur est divisée en trois cadres :

2.1.1 Informations générales

Dans le premier cadre vous retrouvez des informations sur la version de votre module et si une mise à jour est nécessaire ou non ainsi que l'adresse IP de votre serveur.

2.1.2 Lengow API

Si votre compte Lengow n'est pas encore ouvert, cette étape n'est pas bloquante pour exporter votre catalogue pour Lengow. Cette étape est absolument nécessaire pour que vous puissiez récupérer les commandes et les importer dans votre magento.

Vue Globale : Le second cadre concerne toutes vos informations client, excepté votre identifiant groupe (celui-ci nécessite de sélectionner une de vos boutiques).

Vue Boutique : Le second cadre concerne votre/vos identifiant(s) groupe.

  • IdClient

Renseignez votre identifiant client, il vous a été communiqué par votre chargé de compte Lengow. Vous pouvez également le trouver dans la solution Lengow > onglet “voir les détails de votre compte” > id XXXX

  • IdGroup

Renseigner l'identifiant de votre groupe ou de vos groupes Lengow.

Pour trouver vos identifiants de groupe Lengow, rendez-vous dans la solution Lengow > onglet “voir les détails de votre compte” > cliquez sur “Gestion des groupes”.

  • Token API

Renseignez votre Token API.

Pour trouver votre Token API, rendez-vous dans la solution Lengow > lien “API/WebServices” (en bas de page) > onglet “Token” > “Token API” (1) (https://solution.lengow.com/api/)

2.1.3 TagCapsule

Le module pour Magento permet d'ajouter un tracker Lengow directement sur votre site.
Il faut donc configurer l'identifiant produit voulu pour le tracker. Vous avez le choix entre :

  • le SKU (la référence)
  • l'ID produit

Le module magento vous propose deux types de tracker :

  • SimpleTag : C'est le tracker classique de Lengow, il permet de remonter les ventes dans l'interface de votre compte Lengow.
  • TagCapsule : TagCapsule centralise au sein d'un seul et unique tag, l'ensemble des trackers partenaires Lengow en choisissant ceux que vous souhaitez. Il permet de remonter les ventes dans l'interface de votre compte Lengow.

2.2 Renseigner son adresse IP dans Lengow

Afin de pouvoir utiliser les webservices proposés par Lengow, il est nécessaire de renseigner votre adresse IP. Pour cela vous pouvez suivre le lien du premier cadre Cliquez ici pour la mettre à jour. Celui-ci vous redirigera vers la page concernée (https://solution.lengow.com/api/).
Une fois sur cette page, dans le champ Autoriser les IP suivantes, vous pouvez ajouter la ou les adresses IP qui sont susceptibles de faire appel aux webservices Lengow. Chaque IP doit être séparée par un ';' (point-virgule) sans espace. Une fois vos adresses renseignées, cliquer sur Enregistrer.

3. Configuration de l'export

Cet espace vous permet de configurer les options liées à l'export de votre catalogue produit. Cette partie est divisée en 4 cadres vous proposant chacun des options.

3.1 Global

  • Boutique activée : c'est une étape importante, qui active la/les boutique(s) à exporter. Il est possible d'activer l'ensemble des boutiques en configuration par défaut.
  • Exporter seulement les produits sélectionnés : si cette option est activée, seuls les produits sélectionnés seront exportés dans votre flux. Attention :  si aucun produit de votre sélection n'est disponible pour être exporté (dans le cas où des restrictions seraient en place), alors tout votre catalogue est exporté.
  • Exporter les nouveaux produits automatiquement : si cette option est activée, les nouveaux produits sont ajoutés automatiquement à votre flux d'export.
  • Exporter les produits sans stock : cette option vous permet d'exporter vos produits hors stock. Si vous vendez sur les marketplaces, nous vous conseillons d'activer cette option.
  • Type de produit à exporter : vous pouvez sélectionner les types de produits à exporter (configurable, simple, packagé, groupé ou virtuel).
  • Statut des produits à exporter : avec cette option vous pouvez limiter l'export à vos produits activés (Actif), désactivés (Désactivé) ou les deux (Activer, désactivé).

3.2 Data

  • Format : cette option permet de choisir sous quel format vous souhaitez exporter votre catalogue. Vous avez le choix entre xml, json, csv et yaml. Pour utiliser cet export comme flux source pour Lengow, nous vous conseillons le format csv.
  • Nombre d'images à exporter : nombre d'images maximum par produit dans votre flux catalogue.
  • Fusionner les images avec les parents si ils existent : 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.
  • Niveau maximum de profondeur de catégorie : indique la profondeur maximum du fil d'arianne de catégorie d'un produit.
  • Stock sans les produits en cours de commande : avec cette option il est possible de déduire les stocks des produits qui sont sur le point d'être commandés sur votre site (dans un panier par exemple).
  • Convertir les données : lorsque cette option est activée, les caractères spéciaux sont remplacés par des charactères HTML. Cela permet d'éviter certaines erreurs d'encodage.
  • Garder l'HTML pour les champs sélectionnés : les champs sélectionnés garderont le HTML présent. Sinon ils en seront nettoyés.
  • Pays de livraison par défaut : pays de livraison par défaut pour l'export.
  • Frais de livraison : permet de définir les frais de livraison par défaut si aucune correspondance n'est trouvée.
  • Méthode de transport : défini la méthode de transport par défaut pour calculer les frais d'envoi.
  • Délais de livraison : délai de livraison estimé, en jours.

3.3 Product attributes

  • Sélectionner les attributs produits à 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 enfoncée la touche “Ctrl” de votre clavier.

3.4 Performances

  • Ip autorisée pour l'export : ce champ permet d'autoriser certaines adresses IPs à accéder à votre export, c'est à dire à l'URL de votre flux source.
  • Sauvegarder le flux dans un fichier : Cette option est utile dans le cas où votre catalogue contient un grand nombre de produits (+ 3000) ou que votre flux catalogue prend beaucoup de temps à se générer. Grâce à cette option votre flux catalogue est enregistré dans un fichier situé dans le dossier /export de votre module Lengow. Lengow ira alors récupérer ce fichier directement pour indexer votre catalogue. Attention : si vous passez par un fichier, il est important d'activer la tâche planifiée afin de maintenir votre fichier à jour.
  • Activer la tâche planifiée : 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.
 

3.5 Sélection des produits et flux d'export

Dans l'onglet "Lengow" > "Gestion des Produits", vous avez la possibilité de voir la liste de votre catalogue et de sélectionner les produits que vous souhaitez voir dans votre flux.

Pour cela, cochez les produits voulus. Sélectionnez ensuite l'action (Changer la publication sur Lengow) et cliquez sur Soumettre.

Vous pouvez aussi voir votre flux d'export (ou regénérer le fichier contenant votre flux catalogue) de toutes les boutiques en cliquant sur le bouton Voir le flux d'export. Il est également possible de voir le flux d'export d'une de vos boutiques, en sélectionnant la boutique dans "Sélectionner la vue de la boutique".

C'est ce flux qui sera récupéré par Lengow, en tant que flux source, pour être indexé, puis envoyé aux diffuseurs.

L'URL de génération du flux d'export suit toujours le modèle suivant :

www.votre-boutique.com/index.php/lengow/feed  (remplacez "votre-boutique.com" par le nom de domaine de votre site magento)

3.6 Gérer vos flux

Dans l'onglet "Lengow" > "Manage Feeds", vous avez accès à tous vos flux catalogue. Vous pouvez ainsi les gérer depuis votre BO Magento sans passer par votre espace Lengow.

Attention : cet espace est conseillé pour les utilisateurs avancés ayant une bonne maîtrise de la solution Lengow dans son ensemble.

3.7 Utilisation avancé de l'url d'export d'un flux

Si vous êtes sur un multi-site, que vous souhaitez générer un flux spécial pour une marketplace en particulier, ou encore que votre catalogue est très spécifique ou très complet, il est possible d'avoir plusieurs filtres pour avoir un flux particulier.

Dans ce cas là vous devez utiliser les paramètres magento pour gérer les différents flux.

L'url doit être du type : http://www.votre-site-marchand.com/lengow/feed/index/parametre1/valeur2/parametre2/valeur2A,valeur2B/parametre3/valeur3/[etc]

Les paramètres possible sont :

  1. format : type de format des données d'export (csv,yaml,json,xml),
  2. store : id du store du marchand,
  3. product_type : configurable,simple,grouped,bundle ou virtual, séparé par des virgules
  4. product_status : 0 ou 1 ou 0,1 pour produits activés ou désactivés,
  5. product_out_of_stock : 0 ou 1,
  6. selected_products : 0 ou 1 pour la liste de séection de produit. La sélection peut être différente en fonction du “store”,
  7. stream : 0 ou 1, si 1 cela affiche le flux même si le marchand a sélectionné exporter dans un fichier,
  8. locale : langue du site au format ISO,
  9. limit : nombre max de produit à exporter,
  10. offset : nombre de produit à ignorer au départ
  11. ids_product : SKU des produits à exporter, séparé par des virgules.

Exemple : http://www.votre-site-marchand.com/lengow/feed/index/store/4/product_type/configurable,simple/product_status/0/

4. Gestion des commandes

Cet espace vous permet de configurer les options liées à l'import de vos commandes. Cette partie est divisée en 2 cadres vous proposant chacun des options.

Remarque : Si ce n'est pas déjà fait, il est obligatoire de renseigner vos identifiants Lengow (partie "2.1.2 Lengow API") pour récupérer vos commandes.

4.1 Gestion des commandes

Dans cette partie vous pouvez configurer toutes les options liées à l'import des commandes sur votre Magento.

  • Boutique activée : c'est une étape importante, qui active la/les boutique(s) à importer. Il est possible d'activer l'ensemble des boutiques en configuration par défaut.
  • Importer les commandes depuis x jours : Cette option permet de définir la période sur laquelle vous souhaitez importer vos commandes. Ainsi, si vous voulez importer vos commandes sur les 5 derniers jours, il suffit de renseigner la valeur “5”. Les commandes déjà importées sont enregistrées dans votre base de données. Cela évite que les commandes ne soient importées plusieurs fois.
  • Utiliser la date des commandes pour l'import : avec cette option vous pouvez faire en sorte que la date de la commande soit la même que celle de la marketplace. Sinon ce sera la date à laquelle elle a été importée.
  • Importer les frais de traitement des marketplaces : Si cette option est activée, les frais liés aux marketplaces (commissions) sont inclus dans la commande. Cela vous permet une meilleure gestion comptable.
  • Groupe client : permet d'assigner les clients créés au moment de l'import à un groupe de clients.
  • Importer les produits avec les titres provenant de Lengow : Si vous souhaitez que le nom du produit soit celui provenant de la marketplace au lieu du nom produit matché sur votre Magento. Attention, vous devez vérifier le SKU du produit importé afin d'éviter des problèmes de stock.
  • Scinder les noms : cette option permet de scinder les noms en deux. Cette option est utile lorsque le nom et le prénom du client ayant passé la commande sont contenus dans la même ligne d'information.
    • Par exemple si la ligne prenom de la commande est vide et que la ligne nom contient "Jean Dupont", dans le cas où l'option n'est pas activée la fiche client sera :
      • prenom : __  nom : Jean Dupont. Les "__" sont ajoutés par le module pour compléter les champs vides.
    • Si l'option est activée alors la fiche client aura :
      • prenom : Jean nom : Dupont
  • Sélectionner le transport : Cette option permet d'affecter un transporteur par défaut sur la commande. La liste proposée est basée sur les transporteurs configurés dans votre back office magento.
  • Utilisation de faux emails : Cette option permet de générer des faux mails lors de l'importation des commandes.
    • Il y a 3 cas où le module Lengow créé un email fictif : 
      • quand il n'y a pas d'email renseigné
      • quand le module est en mode debug
      • quand cette option est activée dans la configuration du module (Système> Configuration> Lengow> Manage orders> Use fictitious emails)

4.2 Performances

  • Import automatique : si cette option est activée, alors l'import se lance automatiquement toutes les 30 minutes. Cette option fait appel au système CRON de magento.
  • Mode debug : ce mode permet de faire des tests avec le module Lengow. Lorsqu'il est activé, il permet d'importer des commandes sous un id Lengow de commande fictive. Ainsi aucune action sur les commandes importées en mode debug ne sera répercutée côté Lengow. Attention : si ce mode est activé, alors les commandes peuvent s'importer plusieurs fois. Il est donc important de ne l'activer que dans un espace test.

4.3 Gestion des commandes

L'onglet "Lengow" > "Gestion des commandes" vous permet d'avoir accès aux commandes Lengow seulement. A partir de cet écran, vous avez un meilleur visuel sur les informations de la commande (tel que l'id de la commande ou la marketplace dont la commande est issue).


Vous avez aussi la possibilité d'effectuer des actions sur les commandes que vous avez sélectionnées à partir de la liste déroulantes Action.
A partir de cet écran vous pouvez aussi lancer un import manuel en cliquant sur le bouton Import manuel.

Lorsque que vous accèdez aux détails d'une commande, plusieurs informations peuvent vous être utiles :

  • dans le block "Information paiement", vous trouvez le nom de la place de marché sur laquelle la commande a été passée

  • dans la partie expédition, si la commande est à livrer en point relais, l'identifiant de celui-ci sera disponible dans l'adresse d'expédition. En outre la méthode de transport choisie par le marchand sur la place de marché est disponible entre [ ] dans le block "Expédition et manutention" 

5. Tâches CRON et Magento

Magento intègre un système de gestion de tâches planifiées : c'est grâce à ce système que le module Lengow permet de proposer des options d'export et d'import planifiés.

Afin que ce système fonctionne il faut créer une tâche CRON sur votre serveur : il est conseillé d'exécuter le script cron.sh ou cron.php (à la racine de votre Magento) toutes les 5 minutes. Le but de cette tâche est de créer, planifier et exécuter les tâches définies par les différents modules et applications de magento.

6. Logs

L'onglet "Lengow" > "Logs" permet d'avoir accès aux logs de l'extension Lengow. Lorsque vous rencontrez un problème au niveau de l'import des commandes ou de la génération de votre flux catalogue, nous vous conseillons d'abord de  consulter ces logs pour comprendre d'où vient le problème.


Vous avez la possibilité de supprimer définitivement tous les logs en cliquant sur le bouton Vider les logs.