1/ Installation
A. Mise en place du module
B. Rattachement à Shoppingfeed

2/ Paramétrages
A. Produits exportables
B. Option de rafraichissement automatique
C. Stock
D. Prix
E. Attribut
F. Image
G. Catégories
H. Livraison
I. Flux
J. Commandes
K. Onglet Marketing (tâches CRON)
L. Onglet Ventes (commandes places de marché et règles)
M. Onglet Catalogue (fiches produits)

Installation

Mise en place du module

Notre module s’installe ici : https://marketplace.magento.com/shoppingfeed-magento2-manager.html

Il faudra choisir la version du magento 2 (2.3 ou 2.4) :

Une fois le module ajouté au panier et la commande passée, il vous sera possible de l'installer en ligne de commandes via composer en suivant les instructions listées ici : https://github.com/shoppingflux/module-magento2?tab=readme-ov-file#installation

Sachant que si composer vous demande un login/mot de passe pour accéder au dépôt "repo.magento.com", cela correspondra à une paire de clés publique/privée à créer ou récupérer ici : https://commercemarketplace.adobe.com/customer/accessKeys/.

Rattachement à Shoppingfeed

Dans l'onglet "Marketing > Compte", 2 options s'offrent à vous via les 2 boutons oranges en haut à droite :

1) vous avez déjà un compte Shoppingfeed, dans ce cas cliquez sur « importer un compte » :

Si vous connaissez le token API, renseignez-le simplement dans la case prévue à cet effet sinon décochez l'option et renseignez l’identifiant et le mot de passe de votre compte Shoppingfeed.

Une fois le compte rattaché, vous trouverez dans l'onglet « Marketing > Compte » toutes les informations de ce dernier : nom Shoppingfeed, Token, vue magento associée, url de flux associée, date de création, modification et la possibilité de modifier / supprimer la vue.

2) vous n'avez pas de compte Shoppingfeed, dans ce cas, cliquez sur « créer un compte » (attention à bien choisir le nom d’utilisateur car ce sera celui de votre compte Shoppingfeed) :

Paramétrages

Une fois le compte rattaché, vous pouvez désormais vous lancer dans le paramétrage du module en cliquant sur « Choisir > Modifier » :

Le paramétrage s’effectuant par section pour plus de lisibilité. A noter que pour la première section "Flux – Général", vous pouvez laisser le paramétrage d'origine.

Produits exportables

Cette section permet de définir les produits exportés dans le flux source selon quelques critères :
- La sélection faite dans l’onglet catalogue ou selon un attribut
- Le type de produit et leurs visibilités
- Leur état, non vendable, hors stock
- Le format de variation (souhaitez-vous les produits déclinés oui/non avec leurs parents oui/non)

A vous de voir les options qui vous conviennent le mieux et qui vous permettront d’avoir un catalogue le plus proche possible de ce que vous voulez envoyer aux plateformes via Shoppingfeed.

Option de rafraichissement automatique

L'option définit si chaque produit du catalogue doit être chargé individuellement ou pas (plus long, mais dans certains rares cas, cela permet de s'assurer que les bonnes valeurs soient récupérées pour un attribut spécifique). Elle n'a pas d'influence par contre sur quels produits ou quelles données seront mises à jour.

« Forcer le chargement complet des produits pour le rafraîchissement »
Si l’option est cochée, cela va systématiquement charger la section dans son intégralité à chaque passage des tâches crons (peut être potentiellement plus gourmand en serveur). Non cochée, cela va mettre à jour uniquement les données considérées comme modifiées par le module.

« Forcer le rafraichissement automatique »
- Non : les données ne sont mises à jour que lorsqu'un changement est détecté.
- Souhaité : les données seront mises à jour au plus tard après le délai donné, mais sans bloquer la génération du flux.
- Requis : même fonctionnement que le "Souhaité", mais le flux ne sera généré que quand ces données auront été mises à jour.

Cela permet d’optimiser ses flux selon l’importance des sections (on peut vouloir mettre à jour les stocks plus vite que les images ou les attributs par exemple).

Stock

Cette section permet de configurer la gestion de vos stocks par le module :

- Utiliser le stock réel : soit le stock du produit dans Magento s’il est renseigné.

- Y attribuer une quantité par défaut lorsque ce n’est pas le cas (par exemple "100")

- Forcer un stock 0 pour les produits non vendables (en rapport avec la partie "Produits exportables" qui permet de définir si on exporte ou non les produits non vendables, et si oui, à stock réel ou stock nul).

- Mettre à jour les quantités en temps réel : option très performante permettant de mettre à jour en temps réel le stock via l'API Shoppingfeed. Particulièrement utile pour les petits flux, si votre catalogue commence à être volumineux (plus de 1000 produits), il ne vaut mieux pas cocher cette option au risque de surcharger vos serveurs Magento.

- L’option type de rafraichissement automatique des stocks pour optimiser leur mise à jour.

Prix

Il faut d’abord utiliser les prix selon vos groupes de clients si cela est géré.

La gestion des prix remisés est elle une option présente surtout pour la compatibilité ascendante. L'option choisie par défaut correspond à la gestion des prix de la nouvelle structure du flux (attributs "discount"), l'autre à celle du module Magento 1.

Le type de prix sur les produits configurables (prendre le maximum ou le minimum parmi les variations sur le produit parent).

L’option type de rafraichissement automatique des prix pour optimiser leur mise à jour.

Attribut

Cette section permet de configurer la gestion de vos attributs par le module, vous pouvez :

- choisir vos attributs de marques, description longue/courte, EAN par défaut dans le flux
- choisir les attributs supplémentaires à exporter selon la liste sélectionnée
- paramétrer l’option type de rafraichissement automatique des attributs pour optimiser leur mise à jour.

Attention : Il ne faut pas sélectionner d'attributs de prix supplémentaires, cela peut engendrer des erreurs côté Shoppingfeed ensuite, tout est déjà automatisé de base. A noter que les champs prix envoyés par défaut sont : "price" et "price_before_discount".

Image

Cette section permet de configurer la gestion de vos images par le module, vous pouvez :

- choisir de toutes les exporter par défaut
- choisir le nombre d’images à exporter selon vos préférences
- choisir leurs options de rafraichissement.

Catégories

Cette section permet de configurer la gestion de vos catégories par le module, vous pouvez :

- faire une sélection spécifique de catégories si certaines ne doivent pas apparaître dans le flux et leur méthode (Inclure/Exclure la section choisie)
- choisir le niveau de catégorie et le multiplicateur de poids par niveau selon leur importance dans votre arborescence
- "utiliser les catégories parents" permet de définir si l'on souhaite aussi considérer les catégories parents des catégories associées aux produits au moment de choisir celles à exporter
- paramétrer l’option type de rafraichissement automatique

Livraison

Cette section permet de configurer la gestion de vos livraisons par le module, vous pouvez :

- choisir l’attribut à considérer pour définir le nom du transporteur du produit dans le flux
- choisir l’attribut permettant d’identifier vos frais de ports et vos délais de livraison
- attribuer un transporteur et un délai par défaut quand celui-ci est vide ou non renseigné
- paramétrer l’option type de rafraichissement automatique

Flux

Cette section permet d’identifier les produits exportés ou non dans le flux et la raison. Elle apporte des détails sur les produits et leurs statuts :

On peut voir chacune des sections du module et leur statut de mise à jour en cliquant sur «voir les détails» dans la dernière colonne du tableau :

Commandes

Cette section permet de paramétrer la mise à jour et les remontées de vos commandes Shoppingfeed vers Magento, vous pouvez :

- choisir la fourchette de jour sur laquelle le module appellera vos commandes Shoppingfeed
- utiliser la référence article comme ID produit des commandes qui remontent plutôt que l’ID Magento.
- vérifier la disponibilité et options produits pour la remontée (la commande ne remonte pas si le produit n’est pas en stock par exemple)
- vérifier le site web (s’il y a plusieurs boutiques, le sku produit sera lu et la commande ne remontera que sur le site où le sku existe)
- choisir d’importer les clients marketplaces sur Magento. Si décochée, ces commandes seront importées comme invité
- attribuer un mail par défaut si la commande n’en a pas. L’attribuer également différemment par place de marché si besoin est
- prendre en priorité le numéro si figurant, attribuer un téléphone par défaut également si vide
- attribuer une adresse si celle-ci est vide
- attribuer un type de paiement si celui-ci est vide également et choisir son titre selon la place de marché
- forcer le commerce transfontalier (permet d’éviter les écarts de montant en fonction de l’adresse et la tva) pour les commandes à l’internationale
- créer une facture
- importer les commandes expédiées par les plateformes (fullfilment en l’occurrence) et choisir de créer une expédition automatiquement pour celles-ci
- importer les commandes déjà expédiées sur les plateformes (donc par vous ou le service client par exemple à la main)
- annuler les commandes annulées sur les places de marchés (et choisir le délai en jour de synchronisation)
- choisir d’activer la synchronisation selon un statut de commande (refus, annulation, ou remboursement).

Onglet Marketing (tâches CRON)

Notre module est constitué de 7 tâches crons paramétrées par défaut :

- La première actualise la liste de produits à exporter et se lance toutes les heures par défaut

- La deuxième lance le rafraîchissement des données. La tâche marque les données à rafraîchir selon les délais configurés dans chaque section

- La troisième vient notamment mettre à jour ces données dans le module (visibles via l’onglet « Liste de produits »)

- La 4ème vient exporter ces données dans l’url de flux, elle-même renseignée sur votre compte Shoppingfeed et mise à jour. Elle lance la mise à jour des données marquées par les deux tâches précédentes

- La 5ème vient appeler les commandes vers votre Magento et les importe dans votre onglet « Commandes > Places de marché »

- La 6ème vient lire toutes ses commandes, les filtre selon leur critère et les importe (oui/non) dans votre onglet de ventes générales Magento

- La tâche 7, quant à elle, envoie les mises à jour d’état (expéditions et annulations notamment).

N.B : Il est possible de choisir la fréquence de ces tâches en les modifiant, de les activer/désactiver mais également de choisir les comptes Magento sur lesquels elles s’appliquent.

Onglet Ventes (commandes places de marché et règles)

Dans cet onglet, vous verrez toutes les commandes « marquées » par le module sur Shoppingfeed et leur statut d’import. Le module a, par défaut, 3 tentatives d’import pour chaque commande se lançant toutes les 15 minutes (par la tâche CRON citée précédemment).

Il est possible d'avoir une redirection vers la commande Magento dans la colonne action si celle-ci a été importée. Sont visibles également le statut sur Shoppingfeed et le statut d’importation (comme importable ou non selon les options de l’onglet commandes que vous aurez paramétré dans le module).

Dans le cas où une commande ne s’importe pas sans que la raison soit apparente, il sera possible d’identifier son log d’import dans l’onglet : "Vente > logs des commandes" pour plus de détails :

Enfin, sachez qu'il est possible de réinitialiser les tentatives d'import une fois le problème corrigé depuis la colonne "Actions".

Dans la rubrique "Règles de mode de livraison", il est possible de faire des règles de modes de livraison afin d’attribuer automatiquement un transporteur par défaut lors de la remontée de vos commandes marketplaces Shoppingfeed.

Il suffira de la créer, de choisir sa condition (selon un prix, un attribut, un pays, un produit, ect...) et d’y attribuer le modèle de livraison correspondant Magento.

À noter que notre partenaire technique Magento proprose des modules complémentaires pour ajouter des modèles pour certains transporteurs spécifiques (pour l'instant : Colissimo, GLS). Ceux-ci permettent de faire en sorte que les commandes soient reconnues par les modules de livraison correspondants, et disposent de toutes les informations requises (numéro de relais, pour l'export, la génération d'étiquettes, etc...).

Onglet Catalogue (fiches produits)

Au sein de vos fiches produits Magento et de votre formulaire d’attributs (tout en bas de page), vous avez un sous onglet Shoppingfeed grâce auquel vous pouvez :

- choisir les vues magasins pour lesquels le produit sera sélectionné (en rapport avec la section produits exportables du module)
- choisir la catégorie forcée du produit à l’export vers Shoppingfeed plutôt que celle Magento.
- mettre à jour vos attributs en masse (pour le formulaire d’attributs).