1. Installation du module

1.1 Installation du module dans Prestashop

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

Après avoir téléchargé le module, rendez-vous dans l'administration de PrestaShop :

• Onglet “Modules”
• Cliquez sur “Ajouter un nouveau module”

• Sélectionnez l'archive téléchargée puis validez
• Cliquez ensuite sur le bouton “Installer”

1.2 Mise à jour du module

La procédure de mise à jour est identique à l'installation du module.

2. Configuration du module dans Prestashop

2.1 Compte

Ce module est compatible avec les deux versions de la plateforme Lengow, nous vous demanderons d'activer la ou les plateforme(s) à laquelle/auxquelles vous avez accès.

Ensuite, renseignez les identifiants correspondant à chaque plateforme.

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 Access Token. 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 mot de passe "Secret". Retrouvez le en cliquant sur votre avatar (en haut à droite de la plateforme) > "Paramètre du compte" > "Commandes" > onglet "Centraliser les commandes" > "Secret".

2.2 Sécurité

• IP Autorisée

Ce champ permet d'autoriser certaines adresses IPs à accéder à votre export, c'est à dire à l'URL de votre catalogue produits.

2.3 Tracking

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

Choix du type de tracker : Sélectionner le tracking pour l'activer.

Identifiant du produit pour le Tag : Sélectionner l'identifiant produit que vous envoyez aux diffuseurs avec Lengow.

3. Paramétrage de l'export de votre catalogue produits

3.1 Sélection des produits

Il est possible de sélectionner les produits parmi votre catalogue que vous souhaitez exporter. Pour cela, allez dans l'onglet “Catalogue” > “Lengow”.

1. Sélection multiple

Si vous souhaitez publier ou dépublier plusieurs produits en une fois, cochez les produits voulus, puis dans Actions groupées, cliquez sur "Publier sur Lengow" / "Dépublier sur Lengow".

2. Sélection produit par produit

Pour publier/dépublier un produit de la sélection, cliquez sur l'icône "Statut Lengow" au niveau de l'article souhaité. La page se rafraîchit automatiquement avec le statut modifié.

3.2 Paramètres d'export

Nous vous proposons plusieurs options afin de paramétrer au mieux l'export de votre catalogue :

• Transporteur par défaut :

Cette option permet d'affecter un transporteur pour le calcul des frais de port. La liste proposée est basée sur les transporteurs configurés dans votre back office Prestashop.

• Exporter seulement la sélection :

Si cette option est activée, vous exportez uniquement la sélection d'articles Lengow. Si l'option est désactivée tout votre catalogue sera exporté.

• Exporter les produits inactifs :

Si cette option est activée, tous vos produits sont exportés, quels que soient leur statut dans votre PrestaShop (actif ou inactif).

• Export automatique de nouveaux produits :

Si cette option est activée, les nouveaux produits sont ajoutés automatiquement à votre catalogue d'export.

• Exporter les produits déclinés :

Si cette option est activée, vous exportez les produits parents ainsi que leurs déclinaisons. Cette option est utile si vous destinez votre catalogue aux marketplaces ou à Google Shopping.

• Titre+Attributs+Caractéristiques :

Si cette option est activée, le titre de vos déclinaisons apparaît sous la forme : Titre + attributs + caractéristiques. Par exemple pour un T-Shirt ayant pour nom “T-shirt délavé à manches courtes”, si cette option est activée, le nom d'une déclinaison ressemblera à : “T-shirt délavé à manches courtes - Couleur - Orange, Taille - S”. A l'inverse si l'option n'est pas activée alors le nom du produit sera simplement “T-shirt délavé à manches courtes”.

Pour information, un attribut sert à définir des déclinaisons. En outre il peut avoir une influence sur le prix du produit et est sélectionnable. Une caractéristique est une simple information technique sur un produit.

• Exporter les produits hors stock :

Si cette option est activée, vous exportez vos produits hors stock. Si vous vendez sur les marketplaces, nous vous conseillons d'activer cette option. En effet, la plupart des places de marché exigent que vous conserviez quelques temps le produit avec une quantité à 0 unité dans votre catalogue, pour dépublier correctement le produit sur celle-ci.

• Type d'image à exporter :

Cette option permet de choisir la taille des images que vous souhaitez exporter avec votre catalogue.

• Nombre d'images à exporter :

Cette option permet de choisir le nombre d'images que vous souhaitez exporter.

• Format d'export par défaut :

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.

• Exporter 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 /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 de faire appel à une tâche Cron afin de maintenir votre fichier à jour.

• Champs à 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é la touche “Ctrl” de votre clavier.

• Exporter les caractéristiques des produits :

Dans le cas où l'option Exporter les produits déclinés n'est pas activée, les caractéristiques des produits (définies dans votre PrestaShop) ne sont pas exportées. En activant cette option, les caractéristiques sont exportées dans des champs distincts.

3.3 Surcharge des paramètres d'export

Il est possible d'ajouter des paramètres (GET) aux URL d'export et d'import afin de surcharger la configuration du module :

• format : format d'export (csv, json, xml, yaml)
• mode : exporter tous les produits & déclinaisons (full) ou sans les déclinaisons (simple)
• stream : rendu stream (1) ou écriture dans un fichier (0)
• shop : id de la boutique si multiboutique
• cur : devise au format ISO
• lang : langue au format ISO
• ids : Pour exporter seulement les produits spécifiés (IDs séparés par des virgules)
• active : “enabled” pour les produits actifs, “all” pour tous les produits
• limit : Vous pouvez limiter votre export à un certain nombre de produits
• out_stock : Exporter les produits hors stock (1)

Par exemple : www.votre-boutique-prestashop.com/modules/lengow/webservice/export.php?format=csv&limit=15&out_stock=1

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

Le processus d'import de commandes consiste à créer les commandes des places de marché dans votre back office PrestaShop. Ainsi vous pouvez gérer directement ces commandes depuis votre PrestaShop sans avoir à passer par votre compte Lengow. Avant de lancer un import il est donc important de régler les paramètres suivants.

Des options sont déjà sélectionnées par défaut. Elles correspondent aux options les plus fréquemment choisies par les utilisateurs. Libre à vous de modifier ces options selon vos besoins.

4.1 Gestion des statuts

Le module Lengow permet de faire correspondre les statuts des commandes des marketplaces aux statuts mis à disposition par( PrestaShop via un matching des statuts. Ce matching est fait via les trois options suivantes :

• Statut des commandes en préparation
• Statut des commandes envoyées
• Statut des commandes annulées

Le réglage de ces trois paramètres est impératif. Il permet au module Lengow la mise à jour automatique des commandes sur les marketplaces et sur Lengow.

4.2 Logistique des commandes

• Mode de paiement :

L'option 'Mode de Paiement' permet de personnaliser l'affichage du type de paiement. A l'import des commandes, il n'est pas question de créer un autre paiement, puisqu'elle a déjà été réglée sur la marketplace. Le module Lengow implémente donc un module fictif de paiement. Cette option permet en fait d'afficher le nom du module de paiement 'Lengow' ou le nom de la marketplace d'où provient la commande.

• Transporteur par défaut :

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

4.3 Autres paramètres d'import

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

• Prix forcé :

Si cette option est activée, les commandes sont importées avec les prix tels qu'ils sont affichés sur les marketplaces. Ainsi, si le prix est différent entre votre PrestaShop et la marketplace, ce sera le prix marketplace qui sera pris en compte. Sinon ce sera le prix affiché dans votre PrestaShop.

• Forcer les produits :

Cette option permet de forcer l'import des commandes même si les produits sont en rupture de stock ou inactifs. Dans le cas où un produit d'une commande n'est pas disponible, si cette option n'est pas activée, alors la commande n'est pas créée.

• Importer les frais de traitement :

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.

• Email fictif :

Si cette option est activée, les clients créés au moment de l'import des commandes auront tous une adresse mail fictive basée sur le numéro de la commande. L’intérêt de cette option est d'éviter qu'un client ayant passé une commande sur une marketplace ait déjà un compte sur votre PrestaShop. En effet, si ce même client passe ensuite une commande sur votre site PrestaShop, il aurait alors un message lui annonçant qu'un compte existe déjà.

• Transporteur des marketplaces :

Cette option permet de récupérer le transporteur sélectionné par le client sur la marketplace. Si le transporteur n'est pas disponible dans votre PrestaShop, c'est alors le transporteur choisi plus haut qui est selectionné.

• Email de rapport :

Si cette option est activée, vous recevez un mail de rapport à chaque import. Ce mail vous informe s'il y a eu des erreurs pendant l'import de commandes.

• Envoyer les rapports à :

Cette option vous permet de spécifier la ou les adresses mails sur lesquelles vous voulez que les rapports soient envoyés (nécessite que l'option Email de rapport soit activée). Si vous souhaitez entrer plusieurs adresses, il faut les séparer par des ',' (virgules) sans espace. Si le champ reste vide, ce sera l'adresse mail configurée par défaut dans votre PrestaShop qui recevra les mails.

• Limiter à une commande par import :

Cette option permet de limiter la création d'une commande par import lancé. Cette option a été pensée dans le but de résoudre l'incompatibilité avec les versions de PrestaShop comprises entre 1.5.2 et 1.5.4. En activant cette option cela permet de ne pas créer de commandes en double.

• Statut et script d'import :

Le statut vous permet de savoir si un import est en cours ou non.

Le script d'import correspond à l'URL affichée. Si vous vous rendez sur cette URL alors le processus d'import de commandes sera lancé. Cette url suit le schéma suivant : www.votre-boutique-prestashop.com/modules/lengow/webservice/import.php

4.4 Surcharge des paramètres d'import

Il est possible d'ajouter des paramètres (GET) aux URL d'export et d'import afin de surcharger la configuration du module :

• limit : vous pouvez limiter le nombre de commandes à importer
• days : pour modifier la période sur laquelle vous souhaitez importer les commandes
• shop : l'id de la boutique (dans le cas d'une multiboutique)
• lengow_debug : pour importer les commandes en mode debug

Par exemple : www.votre-boutique-prestashop.com/modules/lengow/webservice/import.php?limit=15&days=5

Dans les dernières versions du module Lengow pour PrestaShop (à partir de la 2.0.7), il est possible d'importer une commande en particulier. Pour cela il faut indiquer l'id du flux et l'id de la commande en paramètres GET (idFlux et idOrder) de l'URL d'import. Par exemple : www.votre-boutique-prestashop.com/modules/lengow/webservice/import.php?idFlux=1234&idOrder=123456ABC

4.5 Les logs des commandes

Les logs sont importants pour savoir si les imports de commandes s'exécutent sans problème. Le module intègre une interface permettant de savoir si une commande s'est bien importée ou si une erreur a eu lieu au moment de son import. Pour cela aller dans Catalogue > Logs import Lengow. Il vous sera alors possible de faire une recherche par commande (selon l'id de la marketplace) pour voir le message correspondant à cette commande.

Si une commande a été en erreur et que cette erreur a été corrigée, alors il faut supprimer le message pour que la commande puisse s'importer. En effet l'import ne repasse pas sur les commandes ayant un log enregistré en base. Cela permet de gagner du temps sur les imports.

5. Autres paramètres

Développeur

Les derniers éléments sont plus à destination des développeurs :

• 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.
• Timeout de l'export : cette option est utile dans le cas où vous exportez dans un fichier. Elle permet de découper la génération du catalogue produits d'export en plusieurs cycles dont la durée est fixée par la valeur que vous indiquez dans ce champ. Cela permet d'éviter les erreurs serveur de type timeout.
• Logs : toutes les actions du module sont loguées dans les fichiers listés ici. La durée de vie des fichiers de log est de 5 jours.

6. Tâches CRON

Un CRON est un outil vous permettant d'exécuter certaines tâches automatiquement. Depuis la version 1.6, PrestaShop intègre un gestionnaire de tâches cron (nommé Éditeur de tâches cron) parmi ses modules. Dans cette documentation nous allons donc passer par ce module pour mettre en place les tâches cron.

1. Mise en place d'une tâche CRON via l'Editeur de tâches cron de PrestaShop

Pour ajouter une tâche CRON, aller dans le module Editeur de tâches cron.

Dans Tâches Cron, cliquer sur le symbole '+' ('Ajouter une nouvelle tâche').

Vous arrivez sur une page permettant la création d'une tâche CRON. Il ne reste alors plus qu'à renseigner tous les champs :

• Task description : le nom de la tâche. Par exemple : 'Cron Export Lengow'.
• Target Link : renseignez ici l'URL de votre script. Si vous souhaitez automatiser l'export (dans le cadre d'un export dans un fichier), insérez l'URL de votre script d'export tel qu'elle est indiquée dans votre module. L'url d'export sera du type :http://votre-boutique-prestashop.com/modules/lengow/webservice/export.php.

Si vous souhaitez automatiser l'import de commandes alors renseignez l'URL d'import. Par exemple, pour l'import l'url sera :http://votre-boutique-prestashop.com/modules/lengow/webservice/import.php.

• Task frequency : dans cette partie, il s'agit de régler la fréquence à laquelle les tâches s'exécuteront.

Le module proposé par PrestaShop est relativement limité sur cet aspect puisqu'il ne permet pas de régler un interval régulier autre qu'une heure entre chaque tâche. En effet dans le cas d'un CRON d'import il est conseillé de laisser au moins 15 minutes entre chaque tâche. Dans le cas du CRON d'export, Lengow n'indexe les produits que toutes les 4 heures. Pour ces deux tâches nous réglerons donc la fréquence à toutes les heures de tous les jours de tous les mois.

Une fois tous les champs renseignés, il ne reste plus qu'à enregistrer.

2. Mise en place d'une tâche CRON sur votre serveur

La mise en place d'une tâche CRON sur votre serveur doit être effectuée par un technicien ou un développeur. L'avantage de passer par une tâche CRON directement sur votre serveur est double :

• il permet de mieux personnaliser la fréquence à laquelle exécuter les tâches
• il permet de créer plusieurs fichiers d'export selon les paramètres voulus : en effet par défaut, lorsque vous enregistrer votre export dans un fichier, celui-ci est automatiquement écrasé. Cela peut donc être gênant si vous souhaitez avoir plusieurs catalogues produits avec des paramètres différents pour chacun (voir plus bas). Passer par une tâche CRON serveur vous permet alors de pouvoir contourner ce problème grâce à la commande wget. En ajoutant à cette commande le paramètre -O vous avez la possibilité d'enregistrer votre catalogue produits dans le fichier voulu. Par exemple :

* 0 0 */4 * * wget http://monsite.web/modules/lengow/webservice/export.php