Module prestashop de BeezUP

Afin de faciliter l'installation de BeezUP sur les boutiques utilisant Prestashop, il existe un module gratuit développé par une agence partenaire de BeezUP.

Notre module prend en charge la gestion des commandes marketplace uniquement à partir de la version Prestashop 1.5.

⏩ Pour les versions Prestashop antérieures, nos modules prennent en charge la génération de catalogue source et le tracking des click et ventes :

SOMMAIRE :

1. Pré-requis importants sur le module Prestashop

2. Installation du module Prestashop

3. Configuration des trackers

4. Configuration générale

5. Configuration du flux

a. Sélection des champs à exporter

b. Champs spécifiques

c. Ajout de champs libres

d. Configuration des frais de livraison

6. Adresse du flux

7. Gestion de commandes

a. Configuration de la section "Gestion de Commandes"

b. Récupération des commandes

c. Mise à jour du statut d'une commande mannuellement

d. Expédition des commandes automatiquement

8. Besoin d'aide?

a. Liste des problèmes les plus fréquemment rencontrés

1. Pré-requis importants sur le module Prestashop

Suivant votre situation, veillez suivre ces instructions :

Nouvelle installation : vous n'aviez jamais eu le module BeezUP d'installé auparavant
👉 Vous pouvez installer le module "normalement", voir section suivante.

Ancien module installé : version inférieure à 3.0.0
Si vous possédez déjà une version du module BeezUP/Prestashop installée sur votre boutique, il est INDISPENSABLE avant de procéder à l'installation d'une nouvelle version de :

  • Sauvegarder vos réglages du module, à l'aide par exemple d'un ou plusieurs screenshots

  • Désinstaller l'ancienne : cette action supprime la configuration

  • Supprimer totalement l'ancienne version : cette action supprime les fichiers
    Vous pouvez ensuite installer normalement le nouveau module, voir section suivante et remettre en place vos paramètres à l'aide des screenshots réalisés.

⚠ Sans ces actions, la nouvelle installation du module ne fonctionnera pas correctement.

Ancien module installé : version supérieure ou égale à 3.0.0
👉 Réalisez un BACK-UP de votre module complet (fichiers et base de données) afin de pouvoir y revenir si jamais la version mise à jour ne vous convenait pas.
👉 Sauvegarder, par sécurité, vos réglages du module, à l'aide par exemple d'un ou plusieurs screenshots
Vous pouvez ensuite installer mettre à jour votre nouveau module simplement en cliquant sur le bouton "Mettre à jour", la mise à jour se fera automatiquement sans perte de vos paramétrages.

De plus, nous vous recommandons fortement d'évoluer sous au minimum PHP 5.3, sinon la compatibilité n'est pas assurée

2. Installation du module Prestashop

Pour ajouter le module sur votre application PrestaShop, il vous suffit d’aller sur l’onglet ‘Modules’ puis de cliquer sur "Ajouter un nouveau module".


Sélectionner le module récupéré en haut de cet article, en fonction de votre version, et confirmer.

Poursuivre classiquement l'installation.

3. Configuration des trackers

  1. Commencer par activer vos trackers.

    Note importante : les montants des commandes remontés dans BeezUP par le tracker sont HT, hors frais de port

  2. URL des trackers par défaut: https://tracker.beezup.com

  3. Activation des prix d'achat : permet de remonter la marge de chaque vente dans notre système de tracking

  4. Choisissez votre mode de validation des commandes sur l’application BeezUP.

    1. Il y a deux possibilités :

    • A la création de la commande : à l’affichage de la page de confirmation de commande par le client.

    • Lorsque la commande est livrée : lorsque vous passez la commande au statut ‘livré’.

    Note importante : les commandes sont créées au statut "non confirmé" dans BeezUP dès lors qu'un internaute arrive sur votre page de choix de paiement, il est donc important de bien choisir son mode de validation (passage de la commande au statut "confirmé").

    N'oubliez pas ensuite dans vos options avancées de BeezUP de n'afficher que les ventes confirmées.
    Les ID des commandes ainsi créées dans BeezUP correspondent donc aux ID de paniers côté Prestashop.

  5. Indiquer votre store ID. Vous pouvez le trouver dans ‘Compte’ puis ‘Mes boutiques’ ou comme indiqué ici. Si vous disposez des boutiques de pays différents au sein de BeezUP vous pouvez définir leur storeID respectifs dans cette section.

  6. Enregistrer vos informations.

4. Configuration générale

Un certain nombre d'options sont à votre disposition dans cette section :

  • Adresse du site : en principe générée automatiquement, vous pouvez la modifier si besoin.

  • Export de toutes les boutiques : si votre Prestashop est multi-stores, vous pouvez choisir d'exporter les produits de toutes vos boutiques réunies au sein d'un seul flux d'export.

  • Pays : nécessaire pour calculer la TVA

  • Le cache : il permet une fois activé et pendant sa période de validité de ne pas régénérer le flux s'il existe déjà et ainsi soulager votre serveur.

  • Le CRON va permettre de générer automatiquement votre flux à une heure précise. Par exemple avant une importation sur BeezUP.
    🔵 Exemple de configuration : si votre importation BeezUP a lieu à minuit, activer le CRON à 21h et configurer la validité de votre cache pour une période de 12h.

    A noter, qu'il vous appartient de recopier la ligne affichée par notre module au sein de votre serveur pour mettre réellement en place la tâche.
    Tous les serveurs étant différents sur ce point, le support BeezUP n'est pas en mesure de vous assister sur le sujet, rapprochez vous de votre webmaster et/ou hébergeur pour toute éventuelle question.

  • Nouvelle logique d'ID produits : cette option n'est à activer que si vous êtes un nouvel utilisateur de BeezUP et que vous n'avez jamais importé de flux au sein de BeezUP auparavant => cela permet de bénéficier d'une nouvelle logique de calcul des ID produits fils.

  • Logique de catégories produits : cette option permet de choisir le mode de calcul des catégories de vos produits, soit celle indiquée par défaut, soit celle de niveau le plus profond possible.

5. Configuration du flux

Désactiver les produits inactifs ou hors stock : vous pouvez choisir ces options si vous souhaitez envoyer/ou pas vos produits inactifs et vos produits hors stocks dans le flux.

Forcer la taxe : activer cette option permet de forcer l'attribution de la taxe appliquée à un produit dans le cas où l'acheteur se trouverait dans un pays où celle-ci n'est pas en vigueur.

Considérer les déclinaisons comme des produits : si vous avez des déclinaisons et que vous souhaitez publier vos produits sur les places de marché, cette option est indispensable.

Transporteur et zone par défaut : vous devez spécifier ici le transporteur et la zone à utiliser afin de calculer les frais de port du flux.

Type d'image : permet de choisir la taille de l’image utilisée pour illustrer vos produits => dans l'idéal, choisir la plus grande taille en vigueur dans votre Prestashop (souvent "thickbox")

Langue par défaut : sera celle utilisée dans le flux si vous ne choisissez pas de langue spécifique (voir à la fin de cet article)

Filtrer catalogue par catégories : si activé, permet de sélectionner les catégories à exporter à l'aide de l'arborescence affichée plus bas.

a. Sélection des champs à exporter

Une fois ces informations saisies, il vous faut choisir les champs produits à exporter, pour cela il vous suffit de cocher les champs nécessaires.

⏩ Pour chaque champ 3 possibilités :

  1. Le champ est automatiquement pré-rempli par PrestaShop, vous n’avez rien à faire (c’est le cas des champs EAN, Prix, Référence etc…).

  2. Vous pouvez saisir une valeur fixe dans le champ ‘Valeur par défaut’ qui sera transmise pour l’ensemble de vos produits pour l’attribut concerné (comme le champ ‘delais_livraison’ ci-dessous).

  3. Vous pouvez mapper le champ à l’un des attributs de votre configuration PrestaShop (comme les champs ‘vetement_sexe’, ‘vetement_couleur’, ‘vetement_taille’).

b. Champs spécifiques

  • names_with_attributes : génère, pour les produits fils, un champ dont le contenu sera le titre du produit + la (ou les) déclinaison(s).
    🔵Exemple : Robe courte - noire - XS (où "noire" et "XS" sont des attributs)

  • names_with_attributes_full : génère, pour les produits fils, un champ dont le contenu sera le titre du produit + la (ou les) déclinaison(s) associées à leur libellé.
    🔵Exemple : Robe courte - couleur : noire - taille : XS (où "noire" et "XS" sont des attributs)

  • all_features : ajoute toutes les caractéristiques des produits dans des champs séparés.

  • all_features_one_block : permet d'ajouter toutes les caractéristiques des produits au sein d'un seul champ. Les caractéristiques sont alors séparées par des retours à la ligne.
    🔵 Exemple : Poids : 50kg </br> Hauteur : 100cm </br> Largeur : 60cm

  • all_attributes : ajoute tous les attributs des produits dans des champs séparés

  • variation_theme : permet d'exporter le type de déclinaison (pour les produits déclinés)

c. Ajout de champs libres

Dans le cas où vous souhaiteriez ajouter davantage de champs à votre export, vous avez la possibilité de cliquer sur ‘Ajouter un nouveau champ libre’:
➡ Un nouveau champ apparaît, vous pouvez maintenant le configurer comme vous le souhaitez.

Une fois les modifications terminées, n’oubliez pas de les enregistrer via le bouton qui se trouve en bas du bloc.

Note : Attention à retirer la valeur par défaut si vous avez défini un attribut pour le champ libre créé.

d. Configuration des frais de livraison

Vous pouvez sélectionner un ou plusieurs tarifs de livraison en fonction des modes de livraison disponibles dans votre Prestashop

6. Adresse du flux

L’adresse de votre flux se trouve dans le haut de votre page, c’est cette adresse qu’il faudra utiliser pour importer votre catalogue sur votre application BeezUP.

Vous pouvez générer plusieurs flux en fonction de langue et de la devise:

  1. Définissez la langue dans laquelle les informations de votre flux doivent être exportées

  2. Choisissez la devise des prix de vos produits

Le flux est créé et prêt à être importé sur la boutique correspondante de votre interface BeezUP

7. Gestion de commandes

Le module Prestashop / BeezUP vous permet, si vous utilisez BeezUP pour publier vos produits vers les places de marché, d'automatiquement :

  • Récupérer vos commandes issues des marketplaces

  • Mettre à jour le statut de vos commandes (les accepter, les expédier, les annuler)

Voici comment utiliser cette fonctionnalité de gestion de commandes 👇

a. Configuration de la section "Gestion de Commandes"

  1. Commencer par saisir vos identifiants BeezUP : User ID et Token Primaire.
    Ces 2 identifiants sont disponibles en bas de la zone "Informations".
    S'ils ne sont pas disponibles, cliquez sur le bouton "Créer Compte API" sur la droite et ils apparaîtront .
    Enregistrer les infos, et normalement si les identifiants sont corrects, le voyant "API Statut Connexion" doit passer à "OK" comme sur le screenshot ci dessous (1 Bis)

  2. Une fois la connexion validée, des champs supplémentaires apparaîtront, vous pouvez alors procéder au mapping des statuts de commandes BeezUP avec ceux que vous avez l'habitude d'utiliser. Ainsi dès qu'une commande provenant d'une place de marché sera transmise par BeezUP elle arrivera dans votre section commandes Prestashop avec la correspondance indiquée.
    ⚠ Si vous souhaitez modifier les correspondances par défaut, n'oubliez pas de cliquer sur "enregistrer" en bas de page.

  3. Cette section permet, dans le cas de multi-boutiques Prestashop de faire correspondance vos sous-boutiques avec celles de BeezUP.
    ⚠ Là encore n'oubliez pas d'enregistrer en bas de page si besoin de modification.

  4. Ici vous allez pouvoir définir l'ordre dans lequel la recherche de matching de produits s'opère. Sur cet exemple, le moteur BeezUP va d'abord chercher à faire correspondre les produits de la commande sur le champ "reference" (du flux BeezUP), puis s'il ne trouve pas le champ "reference_produit", puis enfin "reference_fabriquant".
    Afin de savoir quel(s) champ(s) utiliser dans votre cas, il vous faut repérer le nom du champ mappé comme identifiant unique au sein du "Mega-Mapping" de BeezUP.

    👉 En cas de doute, merci de nous contacter via le tchat.

  5. Vous allez ici pouvoir déterminer les transporteurs et modes de paiement par défaut utilisés pour chaque commande issues des marketplaces.
    A noter qu'à partir de la version 3.2.0 de notre module, vous pouvez affiner votre mapping de transporteur au niveau de chaque place de marché par rapport aux valeurs transmises par chacune d'elle. En cas de doute, regardez sur BeezUP les valeurs transmises pour le champ "Shipping Method" pour chacune de vos marketplaces, et faites les correspondre au transporteur prestashop de votre choix.

    Voir ci dessous illustration :

  6. Cette option, par défaut désactivée, vous permet - si activée - de forcer l'importation de commandes contenant au moins 1 produit hors stock.
    ⚠ Attention à ne l'activer que si vous n'utilisez pas la gestion de stock de Prestashop, ou que si vous êtes conscient des impacts d'une telle option.
    Si désactivée, les commandes possédant des produits hors stock seront ignorées, il vous appartiendra de les annuler depuis les places de marché directement.

    Cette option, vous permet pour certains types de commandes de ne pas affecter le niveau de stock.
    Le cas le plus fréquent, est de ne pas impacter votre stock dans le cas de commandes Amazon FBA.
    Ainsi si le stock du produit est 0, la commande pourra être créée en laissant le stock inchangé.
    Idem avec un stock positif, la commande sera créée sans affectation du niveau de stock.

orders_setup_pshop1.jpg
orders_setup_pshop2_editk.png

b. Récupération des commandes

Afin de récupérer les commandes, et les mettre à jour, 3 options s'offrent à vous :

  1. Plusieurs Manuellement : pour cela il vous suffit lorsque vous souhaitez récupérer vos commandes de cliquer sur le lien ( 8a ) en ayant au préalable si besoin modifié la date de début de récupération des commandes ( 7) . Il est à noter qu'à chaque fin de récupération de commande, la date 7 est mise à jour par la date de l'instant, afin de pouvoir repartir de cette date à la récupération suivante.

    Une fois le lien cliqué, ne le fermez pas, et attendez ensuite que le statut de synchro soit bien terminée.

  2. Plusieurs Automatiquement : en installant une tâche CRON sur votre serveur ou en vous servant du module " cronjobs" de Prestashop (1.5 & 1.6), il vous sera nécessaire d'utiliser soit l'url (8a) soit (8b) suivant le moteur CRON choisi.
    Si vous n'êtes pas familier des tâches CRON, veuillez vous rapprocher de votre webmaster, le Support BeezUP n'effectuant pas d'assistance sur leur pose.

  3. Une commande précise : si vous souhaitez récupérer une commande spécifique, si par exemple elle n'avait pas été récupérée automatiquement pour un manque de stock ou pour toute autre raison, il vous suffit de cliquer sur "Cliquez ici si vous voulez synchroniser une commande précise" et ensuite :

⏩ Reporter à l'identique les 3 valeurs que vous trouverez sur votre commande affichée dans BeezUP.
Puis cliquer sur "Synchroniser", si tout est ok un lien apparaîtra vers la commande fraîchement récupérée.

Voir schéma ci-dessous les valeurs à reporter :

inte1.png

OU


⏩ Encore plus simple, depuis la version 3.3.0 du module, reporter l'URL complète de la commande qui est de la forme : https://go.beezup.com/OrderManagement/Informations?BeezUPOrderUUId=XXXX&MarketplaceTechnicalCode=YYY&AccountId=ZZ dans le champ "URL"

c. Mise à jour du statut d'une commande manuellement

Une fois vos commandes récupérées au sein de vos commandes classiques Prestashop, vous pouvez apercevoir pour chacune d'elle une zone "BeezUP Info" qui vous donne un ensemble de détails sur la commande :

➡ ID de la commande côté BeezUP et côté place de marché
➡ Etat de la commande côté BeezUP et côté place de marché
➡ Différentes dates
➡ Montant payé
➡ Place de marché ayant généré la vente
➡ Si disponible la commission prélevée par la place de marché

Si besoin d'avantage de détails, vous pouvez cliquer sur le lien ( 12 ) qui vous renvoie vers la commande au sein de BeezUP.
En (10) figurent les actions possibles sur cette commande à l'instant présent, ici en l’occurrence : l'expédier ou l'annuler.
Si vous cliquez sur l'une des actions, les éventuelles informations nécessaires à l'action apparaîtront :

Une fois exécutée, la commande reste en "synchronisation" quelques instants (jusqu'à quelques minutes), et passe ensuite à son nouveau statut lors de la synchronisation suivante.
Si besoin, vous pouvez forcer la mise à jour de la commande en cliquant sur ( 11 ) "Resynchroniser".

d. Expédition des commandes automatiquement

Depuis la version 3.3.6 du module, les commandes peuvent automatiquement être marquées comme "expédiées" auprès des marketplaces, à condition que :

  • L'option "Auto-shipment" soit activée au sein du module

  • Les informations obligatoires pour chaque place de marché soient déjà renseignées (au minimum le numéro de tracking) pour la ou les commande(s) considérée(s)

  • Le matching de transporteur ait été réalisé au sein du module / pour les places de marché ayant des listes fermées de transporteur.

Dans ces conditions, dès que vous (ou un module tiers) passez une commande provenant d'une place de marché gérée par BeezUP au statut "expédiée" (ou le statut mappé sur "Shipped" au sein de notre module), alors son statut "expédié" sera automatiquement transmis à la marketplace ! 🥳

Voici une illustration de la zone concernée :

8. Besoin d'aide?

a. Liste des problèmes les plus fréquemment rencontrés

Cas

Type

Problème rencontré

Résolution

1

Flux exporté

Les catégories exportées ne correspondent pas à la réalité : "Home" ou "Accueil" est exporté.

La catégorie par défaut de vos produits n'est pas renseignée (laissée à "Accueil"), il vous faut donc la renseigner pour chacun de vos produits afin que le module BeezUP puisse les exporter correctement.

2

Flux exporté

Le catalogue met trop de temps à se télécharger, parfois aboutit à des erreurs

Il vous suffit d'activer le "cache" dans les options du module, ainsi qu'activer le CRON à une heure creuse (la nuit par exemple)

3

Installation

Le module est correctement installé, mais il n'est pas possible d'accéder à la page de configuration (page blanche ou erreur).

C'est en général dû à un problème de mémoire autorisée, il vous faut modifier la variable "memory_limit", dans le script php.ini, par 512.

4

Installation

Affichage de cette erreur lors de la tentative d'installation :
"Parse error: syntax error, unexpected T_STATIC, expecting T_STRING or T_VARIABLE or '$"

Notre module (version >3.x.x) nécessite une version de PHP au moins égale à 5.3.
Si votre version est inférieure, il vous faut la mettre à jour.
Rapprochez vous de votre hébergeur ou votre webmaster pour cela.

5

Installation

Affichage de cette erreur lors de la tentative de configuration : [PrestaShop] Fatal error in module BeezupOMController:
Class 'BeezupHarvestClient' not found

Il faut prendre les fichiers "BeezupHarvestClient.php" , "BeezupHarvestOrder.php" et "BeezupOrder.php" qui se trouvent dans le dossier www/modules/beezup/inc/om/models (ou depuis le zip de notre module) et les mettre dans le dossier www/classes.

Ensuite il faut régénérer le fichier cache/class_index.php en l'effaçant ( il s'auto regénère automatiquement ) .

6

URL produits

Les URLs produits générées par le module renvoient vers des pages indiquant : "[Debug] This page has moved
Please use the following URL instead : https://votresite.com/pageproduitOK"

Votre mode debug Prestashop est actif, il faut le désactiver :
au sein du fichier "config/defines.inc.php", mettez la variable "constant _PS_MODE_DEV_" à false.

7

Prix barrés

Les prix barrés ne sont pas exportés au sein du flux BeezUP et ne sont plus affichés sur votre site.

Afin d'améliorer les performances de génération du flux, le module BeezUP "override" la classe "SpecificPrice".
Si jamais cela engendre des problèmes sur votre site, vous pouvez supprimer cet override situé dans " override/classes/SpecificPrice.php" à condition qu'il soit identique à "modules/beezup/override/sources/_SpecificPrice.php" ou sinon supprimer que ce qui est ajouté par BeezUP.

8

Commandes

Lorsque je tente de marquer une commande comme "expédiée", rien n'est pris en compte du côté de la place de marché.

Afin de modifier le statut d'une commande sur une place de marché, il est indispensable de passer par les boutons affichés dans la section "BeezUP Info" de chaque commande Prestashop.
Plus d'infos au sein de cette page ici

9

Commandes

Après avoir modifié le statut d'une commande sur un statut interne intermédiaire, le statut rebascule dans son état d'origine.

Depuis la version 3.5.0 de notre module une option, au sein de la zone "Beezup Order Management API Debug", vous permet de ne pas modifier le statut s'il n'a pas été changé par la place de marché.
Activer la pour résoudre ce problème.

10

Commandes

Lorsque je clique sur le lien de synchronisation j'ai le message suivant : "invalid key"

Ceci signifie que l'url de base du site est incorrecte. Exemple : vous avez mis https://monsite.com au lieu de https://www.monsite.com

Vous êtes toujours bloqué ? 😨

Si vous rencontrez des problèmes d'installation / usage non renseignés ci-dessus nous vous invitons à nous contacter via le tchat en nous indiquant votre problème précis et idéalement vos accès administrateurs (à la section modules au minimum).

Avez-vous trouvé votre réponse?