Module Prestashop V2

Le guide ci-dessous vous permet de paramétrer le module Prestashop 2.1.

Si vous disposez d'une version 2 antérieure, nous vous conseillons de la mettre à jour pour disposer de toutes les fonctionnalités présentées ci-dessous.

1. Installation du module Prestashop V2

1.1 Compatibilité du module

Le module est compatible :

  • à partir de la version 1.4.4.1 de Prestashop
  • uniquement avec les versions 2.x du module Mondial Relay

Attention : Certaines fonctionnalités de ce module présentent une incompatibilité avec les versions comprises entre la 1.5.2 et la 1.5.4.* de Prestashop. Si vous possédez une de ces versions :

1.2 Télécharger le module

Sur notre site : https://www.lengow.com/fr/integrations/prestashop/

1.3 Installation du module dans votre 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”

2. Configuration du module

Pour accéder à la configuration du module, cliquer sur “Configurer”.

2.1 Compte

Une fois que votre compte Lengow est ouvert, renseignez ces trois identifiants :

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

  • 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, comme dans notre exemple ci-dessus, 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/)

  • Renseigner votre adresse IP dans la solution Lengow

Il est nécessaire de renseigner dans Lengow l'adresse IP des serveurs utilisant les webservices. C'est un élément de sécurité qui permet de limiter l'accès de nos services aux utilisateurs autorisés. Pour cela, il suffit de vous rendre dans la solution Lengow > lien “API/WebServices” > onglet “Token” > “Token API”. 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.

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

2.3 Tracking

Le module Prestashop permet d'ajouter un tracker Lengow directement sur votre site.

Vous avez le choix entre 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.
  • Identifiant du produit pour le Tag : Ce champ permet de choisir votre identifiant produit à utiliser dans l'affichage du tag.

3. Export catalogue

Le script d'export permet à Lengow de récupérer votre catalogue sous différents formats (csv, xml, json et yaml). Celui-ci est ensuite chargé dans votre compte Lengow. C'est cet export qui servira de “flux source”. Il vous servira de base pour paramétrer les flux de vos différents diffuseurs via Lengow. Cet export sera indexé dans Lengow à la fréquence de votre choix.

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

3.1.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 surPublier sur Lengow / Dépublier sur Lengow.

3.1.2 Sélection produit par produit

Pour publier/dépublier un produit de la sélection, cliquez sur l'icône Statut Lengow qui correspond à l'article souhaité. La page se rafraîchit automatiquement, le statut sera alors modifié.

3.2 Paramètres d'export

Nous vous proposons plusieurs options afin de paramétrer au mieux l'export de votre catalogue. Voici un détail de chacune d'entre elles :

  • 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 flux 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 flux, 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 flux source 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 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 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.

  • Caractéristiques à exporter :

Cette option permet de choisir les caractéristiques 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.

  • Votre script d'export :

Ici s'affiche l'URL permettant de lancer votre script d'export. Elle suit le schéma suivant : www.votre-boutique-prestashop.com/modules/lengow/webservice/export.php

C'est cette URL qui vous servira de “flux source” pour la solution Lengow.

4. Import de commandes

Le processus d'import de commandes consiste à créer les commandes 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.

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

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 puisque cela permet au module Lengow de mettre à jour automatiquement les 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.

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

  • Utiliser les 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é.

  • Importer les commandes expédiées par les marketplaces :

Si cette option activée, les commandes expédiées par les marketplaces seront importées dans le backoffice. Les produits de la commande ne seront pas décrémentés du stock de la boutique. Par défaut, les commandes expédiées par les marketplaces ne sont pas importées. 

  • Statut des commandes expédiées par les marketplaces :

Cette option permet de sélectionner le statut par défaut des commandes expédiées par les marketplaces.

  • 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

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.

6. Autres paramètres pour les développeurs

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

7. Tâches CRON

Un CRON est un outil vous permettant d'exécuter certaines tâches automatiquement. 

7.1 Mise en place d'une tâche CRON sur votre serveur (Recommandé)

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 enregistrez votre export dans un fichier, celui-ci est automatiquement écrasé. Cela peut donc être gênant si vous souhaitez avoir plusieurs flux 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. Par exemple :
* 0 0 */4 * * wget http://monsite.web/modules/lengow/webservice/export.php

7.2 Mise en place d'une tâche CRON via l'Editeur de tâches cron de Prestashop

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.

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

Puis au niveau du module Lengow, rendez vous dans "configuration du module" > "configuration de l'import" > "MISE EN PLACE DU CRON" > activer l'option "Utiliser l'Editeur de tâche CRON "

8. Surcharge des paramètres

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

8.1 Paramètres d'export

Parmi les paramètres d'export :

  • 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

8.2 Paramètres d'import

Parmi les paramètres d'import :

  • 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

9. Mise à jour du module

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

10. Visualisez vos statistiques Lengow

Une fonctionnalité a été ajoutée pour vous permettre de visualiser vos principaux indicateurs de statistique au sein de votre Prestashop (uniquement accessible pour les versions Prestashop supérieures à 1.5).

Sur la homepage de Prestashop, vous trouverez désormais un encart dédié.

Vous pourrez ainsi visualisez, vos clics, ventes, ROI, etc.

Vous pourrez également avoir un inventaire de vos flux avec le nombre des produits qu'ils contiennent.

11. Migration de l'ancien vers le nouveau module Lengow

11.1 Migration du flux source dans Lengow

Attention : ces options sont à utiliser avec précaution.

Soyez-sûr que votre le flux source qui sera utilisé contienne les mêmes informations que le flux source actuellement pris en compte (même structure de flux (entêtes), export des produits simples ou produits déclinables, etc.)

Si vous avez un doute n'hésitez pas à contacter le support Lengow.

Si vous cliquez sur “Migrer ce flux”, l'url de votre flux source prise en compte par Lengow sera modifiée.

Si vous cliquez sur “Migrer tous les flux”, tous vos flux source seront modifiés dans Lengow.

11.2 Import des commandes

Vous pouvez faire cohabiter les 2 versions du module Lengow le temps de la migration. Attention cependant car vous risquez d'importer vos commandes en double dans votre Prestashop.

Pour éviter cela, vous pouvez décocher la case à cocher “Utiliser le webservice prestashop pour importer les commandes” depuis votre page de gestion des imports Prestashop.

Cette case se décoche par défaut lorsque nous détectons que le module Lengow V2 a été installé sur votre prestashop.

12. F.A.Q

  • Je n'ai aucune commande qui remonte dans l'administration de Prestashop

Vérifiez que vous avez bien renseigné l'adresse IP de votre site à cette url : https://solution.lengow.com/api/

  • Je rencontre des erreurs lors de l'installation du module

Vérifiez que la bibliothèque nommée "cURL" est bien installée sur votre serveur (Attention, l'utilisation de cette bibliothèque est réservée aux personnes d'un niveau avancé en informatique).