1. Installation du module dans Magento

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

Installez 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 (si vous avez déjà une installation du module, vous devez la désinstaller via le Magento Connect avant de faire la mise à jour) (image 1)

• • 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. (image 2)

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

2. Configuration du module

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 :

1. Informations générales

Retrouvez les informations sur la version de votre module et si une mise à jour est nécessaire ou non.

2 Lengow API

Ce module est compatible avec les deux versions de la plateforme Lengow, nous vous demanderons d'activer la ou les plateforme(s) sur la(les)quel(s) où vous avez accès. Ensuite, renseignez les identifiants correspondant à chaque plateforme. (voir l'image)

Ancienne plateforme

• • ID Client : 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
  • ID Groupe : 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”. Si vous avez plusieurs groupes, séparez ces identifiants par des virgules (exemple : 11095,11099)
  • 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/)

  Nouvelle plateforme

  • Account ID : Renseignez votre identifiant de compte. Retrouvez le en cliquant sur votre avatar (en haut à droite de la plateforme) > "Paramètre du compte" > Il est alors visible en haut à gauche de la page : "ID du compte : XXXX)
  • Access token Renseignez votre identifiant de compte. Retrouvez le en cliquant sur votre avatar (en haut à droite de la plateforme) > "Paramètre du compte" > "Commandes" > onglet "Centraliser les commandes" > "Access Token".
  • Secret : Renseignez votre identifiant de compte. Retrouvez le en cliquant sur votre avatar (en haut à droite de la plateforme) > "Paramètre du compte" > "Commandes" > onglet "Centraliser les commandes" > "Secret".

3 Tracking

Pour remonter vos ventes dans la plateforme Lengow, activez le tracking :

Identifiant du produit à utiliser : Sélectionner l'identifiant produit que vous envoyez aux diffuseurs avec Lengow.

Type de tracker : Sélectionner le tracking pour l'activer.

3. Export du catalogue produits

Le script d'export c'est l'URL qui vous servira de “catalogue produits” pour la solution Lengow. Il faut utiliser cette URL dans Lengow pour importer vos produits. 

Différents formats sont possibles : csv, xml, json et yaml.

Paramétrez cette URL avec les indications disponibles dans les rubriques ci-dessous avant de l'implémenter dans Lengow.

Cet espace vous permet de configurer les options liées à l'export de votre catalogue produits. 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 catalogue produits.
• Exporter les nouveaux produits automatiquement : si cette option est activée, les nouveaux produits sont ajoutés automatiquement à votre catalogue d'export.
• Exporter les produits dont les stocks sont à 0 : 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 catalogue produits pour Lengow, nous vous conseillons le format csv.
• Nombre d'images à exporter : nombre d'images maximum par produit dans votre 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.
• 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.
• 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éfinir la méthode de transport par défaut pour calculer les frais d'envois.
• Délais de livraison : délai de livraison estimé, en jours.

3.3 Performances

• Sauvegarder le catalogue 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 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.4 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.5 Sélection des produits et catalogue produits 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 catalogue.

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 catalogue produits d'export (ou regénérer le fichier contenant votre catalogue) en cliquant sur le bouton Voir le flux d'export.

C'est ce catalogue qui sera récupéré par Lengow, en tant que catalogue produits, pour être importé, puis envoyé aux diffuseurs.

L'URL de génération du catalogue produits 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)

4. Paramétrage de l'import des commandes diffuseurs

4.1 Paramétrez votre import

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.
  • Choix des marketplaces pour l'import : Sélectionnez les places de marchés sur lesquelles vous souhaitez récupérer les commandes.
  • 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
  • Choisir votre mode d'expédition : Pour les commandes expédiées par les places de marché.
  • Utilisation de faux emails : Cette option permet de générer des faux mails lors de l'importation des commandes.
  • Activer la conversion de devise de vos commandes
    Toutes les commandes importées dans Magento seront automatiquement converties dans la devise choisie dans Lengow.

4.2 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)..(image 1)

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 (image 2)

• 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" (image 3)

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 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.