SELLERMANIA POUR PRESTASHOP
Sellermania pour PrestaShop

MANUEL D'UTILISATION

Installation et utilisation

Révision 0.2

1. Installation du module

1.1 Installation et mise à jour sur PrestaShop 1.4

1.1.1 Installation sur PrestaShop 1.4

Tout d'abord, connectez-vous sur votre panneau d'administration PrestaShop.

Une fois connecté, allez dans la section “Modules”.

Vous devriez avoir reçu un fichier nommé “sellermania.zip”. Vous allez devoir le télécharger dans cette section. Pour y parvenir, cliquez sur le bouton “Ajouter un module depuis mon ordinateur”.

Une nouvelle section devrait être apparu, cliquez sur le bouton “parcourir”.

Puis sélectionnez le fichier “sellermania.zip” et cliquez sur “ouvrir”.

Enfin, cliquez sur le bouton “Télécharger ce module”.

Un message de confirmation de téléchargement devrait apparaître.

Cliquez sur “Fonctionnalités du Front Office” et cherchez le module “Sellermania” ou utilisez le filtre de recherche en tapant à l'intérieur “Sellermania”, puis cliquez sur le bouton “Installer”.

Une fois que vous aurez cliqué sur le bouton d'installation, un message de confirmation “Module installé avec succès” devrait apparaître. Vous pouvez à présent cliquer sur le bouton “Configurer”.

1.1.2 Mise à jour sur PrestaShop 1.4

Pour mettre à jour votre module, vous devez just charger le fichier zip de la nouvelle version du module.

Pour cela, vous devez tout d'abord télécharger la dernière version du module sur notre site internet froggy-commerce.com

Alors, tout comme pour l'installation, connectez-vous sur votre panneau d'administration PrestaShop.

Une fois connecté, allez dans la section “Modules”.

Vous devriez avoir à présent la mise à jour du module “sellermania.zip”. Vous allez devoir le charger dans cette section. Pour y parvenir, cliquez sur le bouton “Ajouter un module depuis mon ordinateur”.

Une nouvelle section devrait être apparu, cliquez sur le bouton “parcourir”.

Puis sélectionnez le fichier “sellermania.zip” et cliquez sur “ouvrir”.

Enfin, cliquez sur le bouton “Télécharger ce module”.

Un message de confirmation de téléchargement devrait apparaître.

Votre module a été mis à jour !

1.2 Installation et mise à jour sur PrestaShop 1.5

1.2.1 Installation sur PrestaShop 1.5

Tout d'abord, connectez-vous sur votre panneau d'administration PrestaShop.

Une fois connecté, allez dans la section “Modules”.

Vous devriez avoir reçu un fichier nommé “sellermania.zip”. Vous allez devoir le télécharger dans cette section. Pour y parvenir, cliquez sur le bouton “Ajouter un module depuis mon ordinateur”.

Une nouvelle section devrait être apparu, cliquez sur le bouton “parcourir”.

Puis sélectionnez le fichier “sellermania.zip” et cliquez sur “ouvrir”.

Enfin, cliquez sur le bouton “Télécharger ce module”.

Votre navigateur devrait défiler automatiquement jusqu'au nouveau module ajouté, et vous devriez le voir en haut de votre écran. Maintenant vous pouvez cliquer sur le bouton “Installer”.

Une fois que vous aurez clique sur le bouton d'installation, un message de confirmation “Module installé avec succès” devrait apparaître. Vous pouvez à présent cliquer sur le bouton “Configurer” (sur certaines versions de PrestaShop, vous serez redirigé automatiquement vers la page de configuration après installation du module).

1.2.2 Mise à jour sur PrestaShop 1.5

Pour mettre à jour votre module, vous devez just charger le fichier zip de la nouvelle version du module.

Pour cela, vous devez tout d'abord télécharger la dernière version du module sur notre site internet froggy-commerce.com

Alors, tout comme pour l'installation, connectez-vous sur votre panneau d'administration PrestaShop.

Une fois connecté, allez dans la section “Modules”.

Vous devriez avoir à présent la mise à jour du module “sellermania.zip”. Vous allez devoir le charger dans cette section. Pour y parvenir, cliquez sur le bouton “Ajouter un module depuis mon ordinateur”.

Une nouvelle section devrait être apparu, cliquez sur le bouton “parcourir”.

Puis sélectionnez le fichier “sellermania.zip” et cliquez sur “ouvrir”.

Enfin, cliquez sur le bouton “Télécharger ce module”.

Votre navigateur devrait défiler automatiquement jusqu'au nouveau module ajouté, et vous devriez le voir en haut de votre écran. Vous NE DEVEZ PAS désinstaller / réinstaller votre module.

Votre module a été mis à jour !

1.3 Installation et mise à jour sur PrestaShop 1.6

1.3.1 Installation sur PrestaShop 1.6

Tout d'abord, connectez-vous sur votre panneau d'administration PrestaShop.

Une fois connecté, allez dans la section “Modules”.

Vous devriez avoir reçu un fichier nommé “sellermania.zip”. Vous allez devoir le télécharger dans cette section. Pour y parvenir, cliquez sur le bouton “Ajouter un module depuis mon ordinateur”.

Une nouvelle section devrait être apparu, cliquez sur le bouton “parcourir”.

Puis sélectionnez le fichier “sellermania.zip” et cliquez sur “ouvrir”.

Enfin, cliquez sur le bouton “Télécharger ce module”.

Un message de confirmation doit apparaître.

Enfin, écrivez "Froggy" dans le champs de recherche des modules, tous les modules Froggy vont s'afficher. Cliquez alors sur le bouton "installer" du module que vous venez de télécharger. Vous serez automatiquement redirigé vers la page de configuration du module.

1.3.2 Mise à jour sur PrestaShop 1.6

Pour mettre à jour votre module, vous devez just charger le fichier zip de la nouvelle version du module.

Pour cela, vous devez tout d'abord télécharger la dernière version du module sur notre site internet froggy-commerce.com

Alors, tout comme pour l'installation, connectez-vous sur votre panneau d'administration PrestaShop.

Une fois connecté, allez dans la section “Modules”.

Vous devriez avoir à présent la mise à jour du module “sellermania.zip”. Vous allez devoir le charger dans cette section. Pour y parvenir, cliquez sur le bouton “Ajouter un module depuis mon ordinateur”.

Une nouvelle section devrait être apparu, cliquez sur le bouton “parcourir”.

Puis sélectionnez le fichier “sellermania.zip” et cliquez sur “ouvrir”.

Enfin, cliquez sur le bouton “Télécharger ce module”.

Un message de confirmation doit apparaître.

Votre module a été mis à jour !

2. Configuration du module

Voici ce que vous devriez avoir sur la page de configuration du module:

Vous pouvez naviguer dans le module en cliquant sur les différents boutons au dessus du lien de documentation.

Tout d'abord, la section concernant l'export catalogue :

Pour envoyer votre catalogue vers Sellermania, vous avez deux solutions :

1) Utilisez les liens qui génèrent le catalogue à la demande et envoyez les à Sellermania.

Avantage : Vous n'avez besoin de l'aide ni d'un technicien ni de votre hébergeur, vous avez juste à copier / coller les liens à Sellermania.
Inconvénient : Selon le moment que choisit Sellermania pour récupérer votre catalogue, cela peut ralentir votre serveur, en particulier si c'est pendant un pic de visiteurs sur votre site.

2) Configuration avancée : Mettez en place une tâche cron qui va générer votre catalogue toutes les nuits.

Puis donnez le chemin des fichiers CSV pour chaque language à Sellermania (comme vous pouvez le voir, les chemins sont affichés par le module, vous avez juste à les copier / coller à Sellermania).

Avantage : La génération du catalogue CSV peut demander de grandes ressources à votre serveur, de ce fait, générer votre catalogue durant la nuit, quand votre nombre de visites est au plus bas, est une bonne idée.
Inconvénient : Vous devez mettre en place une tâche cron et ce n'est pas évident lorsque vous n'êtes pas un technicien. Vous pouvez soit demander à votre hébergeur de le faire pour vous, soit lire quelques tutoriaux et le faire par vous même (il arrive que les hébergeurs aient une interface permettant de gérer vos tâches cron).

3. Import des commandes

Configuration d'import

Si vous souhaitez importer les commandes Sellermania dans votre panneau d'administration PrestaShop, vous devez cocher "Oui" dans le premier onglet de votre module puis remplir les champs avec les accès que Sellermania vous a envoyé.

Vous trouverez les valeurs des champs "e-mail" et "token" dans la section "IDENTIFICATION SELLERMANIA" de votre interface Sellermania.

Il est fortement recommandé d'utiliser la méthode d'import par cron pour les raisons citées dans le module.

Les champs "endpoint" devrait déjà être préremplis avec les valeurs suivantes :
- "Order endpoint" : http://api.sellermania.com/v3/OrdersAPIS?wsdl
- "Order confirmation endpoint" : http://membres.sellermania.com/wsapi/wsdl/OrderConfirmation
- "Order inventory endpoint" : http://api.sellermania.com/v3/InventoryAPIS?wsdl

Lorsque vous cliquez sur le bouton "Valider", un test de connection est effectué vers Sellermania. Si les identifiants sont incorrects, vous serez alerté par un message rouge.

Si vos identifiants sont corrects, alors un message de confirmation sera affiché ainsi que la date de la dernière et de la prochaine importation de commandes.

Si vous descendez dans la page, vous verrez que vous avez de nombreuses configurations disponibles tels que la sélection de marketplace.

Pour chaque marketplace, vous pouvez choisir d'import les commandes ou non, voir même de les confirmer automatiquement.

Si vous continuez à descendre dans la page, vous arriverez à la section 3 (options), les descriptions de chaque option sont présentes dans le module.

Enfin, vous avez la section 4 (transporteur et statut), dans laquelle vous pouvez définir les statuts d'importation des commandes marketplaces ainsi que le transporteur qui leur sera associé.

Traiter les commandes

A présent, cliquez sur le menu "Commandes" dans votre panneau d'administration. Vous verrez les commandes importées depuis Sellermania dans cette section.
La place de marché à l'origine de la commande sera clairement affiché avec le status de cette dernière. The marketplace and the order reference will be indicated in the “Payment” column.

Important

Les commandes sont importés à partir de la date d'installation. Si vous avez installé votre module le 04/02/2014 12:42:23, seuls les commandes passées après cette date seront importées. (Cette date est à présent configurable dans votre back office.)

Le module Sellermania importe jusqu'à 100 commandes maximum toutes les 15 minutes. L'importation est déclenchée lorsqu'une action (n'importe quelle action) est effectuée dans le panneau d'administration.

En d'autres termes, si vous n'êtes pas actif sur le panneau d'administration, il n'y aura pas d'importations de commande jusqu'à ce que vous soyez à nouveau actif.

Si vous cliquez sur une commande importée de Sellermania, vous verrez que l'affichage est différent des commandes classiques PrestaShop.

Vous devrez confirmer ou annuler chaque produit de la commande.
Si vous annulez tous les produits, la commande aura automatiquement le statut "Annulé".
Si vous annulez seulement quelques produits de la commande, le total et le transport seront recalculés en fonction.

Vous pouvez utiliser les boutons "Confirmer tous les produits" ou "Annuler tous les produits" pour aller plus vite. Cela ne ferait que préselectionner le choix pour chaque ligne produit.

Dès que vous aurez sélectionné une option pour une ligne produit, un nouveau bouton "Enregistrer le(s) statut(s)" apparaîtra.

Si vous cliquez sur ce bouton, vos choix seront envoyés à Sellermania et un message de confirmation apparaîtra.

Le statut global de commande changera une fois que vous aurez confirmé ou annulé chaque ligne.
Cas 1: Toutes les lignes commandes sont annulées, le statut global de la commande sera "Annulé"
Cas 2: Certaines lignes commandes sont annulées, les autres sont confirmées, le statut global de la commande sera "SELLERMANIA - Commande confirmée"
Cas 3: Toutes les lignes commandes sont confirmées, le statut global de la commande sera "SELLERMANIA - Commande confirmée"

A présent, vous devez attendre le retour de Sellermania concernant cette commande. Lorsque le statut de votre produit confirmé deviendra “To dispatch”, alors vous pourrez remplir le nom du transporteur ainsi que le numéro de suivi colis.

Une fois que vous aurez rempli le nom du transporteur et le numéro de suivi colis, le statut global de la commande sera "SELLERMANIA - Commande envoyée".

Confirmation et expédition en masse sont également disponible depuis le listing des commandes.

Erreurs d'importation

De temps en temps, le module ne pourra pas importer certaines commandes de Sellermania. Si cela survient, vous verrez un petit message d'alerte apparaître en haut de de la page de liste des commandes affichant le nombre de commandes qui n'ont pas pu être importées.

Vous pourrez obtenir plus d'informations en vous rendant dans la page de configuration du module.

Si vous cliquez sur "Voir détails", vous verrez la liste des commandes qui n'a pas pu être importée.
Veuillez alors contacter le service technique de Froggy Commerce avec tous les détails inscrits dans cette page.

4. Synchronisation des stocks

Depuis la version 1.1.2 du module Sellermania, vous avez à présent un champs nommé "Inventory endpoint" dans le formulaire de configuration du module.
La valeur à indiquer dans ce champs est : http://api.sellermania.com/InventoryAPISFR_11_12_2017/InventoryAPIS?wsdl

La synchronisation des stocks avec Sellermania se déclenche lorsque :
- Une commande est passée sur PrestaShop
- Le stock d'un produit est mis à jour sur PrestaShop
- Le stock d'une déclinaison produit est mis à jour sur PrestaShop

Cette fonctionnalité est optionnelle, si vous ne remplissez pas le champs "Inventory endpoint", la synchronisation des stocks ne sera pas activée.

5. F.A.Q

5.1 Export catalogue


J'ai installé le module Sellermania et je vois le message "Fichier non généré pour le moment" à côté du lien d'export catalogue, quel est le problème ?

Ce message signifie que vous n'avez pas encore programmé la tâche cron qui génère l'export catalogue. Ceci dit, ce n'est pas obligatoire, veuillez vous référer à la section #2.

J'utilise les liens d'export direct et j'obtiens une page blanche avec le message "ERROR1", "ERROR2" ou "ERROR3", quel est le problème ?

Ce message d'erreur ne devrait jamais arriver, soyez sûr de copier / coller le lien complet dans la barre d'adresse de votre navigateur.
Si vous copiez / coller le lien complet et que celui-ci se termine par "&k=", cela signifie que le token de sécurité n'a pas été généré. La seule solution est alors de désinstaller puis réinstaller le module.
Si cela ne fonctionne toujours pas, veuillez nous contacter en utilisant le formulaire de contact du site. Faîtes nous parvenir le lien d'export qui pose problème ainsi qu'une capture écran du formulaire de configuration du module où les liens sont affichés.

Important

Si vous avez déjà importé des commandes depuis Sellermania et que vous rencontrez des problèmes avec le lien d'export, ne désinstallez pas votre module et contactez nous directement. Faîtes nous parvenir le lien d'export qui pose problème ainsi qu'une capture écran du formulaire de configuration du module où les liens sont affichés.

5.2 Importation des commandes

Pourquoi l'adresse e-mail du marchand est associée aux commandes importées au lieu de l'e-mail du client ?

Beaucoup de marketplaces fournissent des alias d'e-mails au lieu des e-mails des clients. Si vous envoyez un e-mail à l'une de ces adresses, cela peut avoir pour conséquence un bannissement de votre compte sur la marketplace concernée.
C'est pourquoi nous associons l'e-mail du marchand au compte client pour éviter l'envoi de mails automatiques par PrestaShop
Cependant, vous pouvez toujours utiliser un alias e-mails fournis par la marketplace à vos propres dépens, vous pourrez le trouver sur l'écran du détails de la commande du client.

Comment puis je faire pour récupérer les documents PDF de factures, bons de livraison et avoirs ?

Ces fonctionnalités ne sont pas disponibles dans notre module pour le moment. Nous n'avons pas de date de sortie pour ces fonctionnalités pour le moment.

Pourquoi le prénom et le nom du client sont inversés par moment ?

Les marketplaces nous envoies le prénom et le nom dans un seul champs, et, il arrive que le nom soit placé avant le prénom.
Le module sépare les noms en deux champs pour pouvoir les enregistrer dans PrestaShop, donc, malheureusement, nous ne pouvons rien faire concernant ce problème.

Il semble que certaines de mes commandes ne sont pas importées, que puis je faire ?

Avant de nous contacter, vous devez effectuer les actions suivantes :
1) Vérifiez que votre module est à jour, nous sortons des mises à jour régulièrement et il se peut qu'elles corrigent votre problème. Si il ne l'est pas, mettez le à jour.
2) Vérifiez que les commandes en question sont bien présentes dans l'interface de Sellermania. Si ce n'est pas le cas, le problème vient de Sellermania, nous vous invitons à rentrer en contact avec leur support.
3) Enfin, dans la configuration du module, vérifiez la présence d'erreurs lors de l'importation des commandes (voir section 3.3). Si oui, envoyez nous le rapport affiché.

Dans quels cas le module PrestaShop synchronise t'il les stocks avec Sellermania ?

Le module Sellermania pour PrestaShop permet la synchronisation des stocks en temps réel entre PrestaShop et Sellermania
- Lors du passage d'une nouvelle commande sur PrestaShop
- Lors de la modification de stock d'un produit sur PrestaShop
- Lors de la modification de stock d'une déclinaison produit sur PrestaShop
Dans ces cas-là, PrestaShop envoie une mise à jour à Sellermania afin d'effectuer le même mouvement de stock sur Sellermania.
La mise à jour est très rapide et se fait en quelques secondes par la correspondance entre le code SKU sur Sellermania et le champs "Référence" sur PrestaShop.

Comment activer /désactiver la synchronisation des stocks avec Sellermania ?

Si vous souhaitez activer la synchronisation des stocks, remplissez le champs "Inventory endpoint" dans la configuration de votre module (voir section #3), sinon laissez ce champs vide.

Sellermania continue-t-il à mettre à jour les stocks en fonction des marketplaces ?

Oui, une vente faite sur une marketplace ajuste les stocks sur les autres marketplaces, sans passer par PrestaShop. Le temps que les ventes Sellermania soient intégrées à PrestaShop vous pouvez avoir un stock différent entre PrestaShop et Sellermania. Ce n'est donc pas nécessairement un problème.

La quantité dans PrestaShop n'est pas la même que celle de Sellermania, est-ce normal ?

Pour une même référence SKU, en l’absence de ventes sur une marketplace vous devez constater que si vous faites une modification sur PrestaShop, quelques secondes plus tard, cette modification est prise en compte sur Sellermania. Attention, PrestaShop envoie le « différentiel » de la mise à jour et n’écrase pas le stock Sellermania ! (ce afin de laisser Sellermania mettre à jour les marketplaces indépendamment de l’intégration des commandes dans PrestaShop)

Exemple d’une Synchronisation entre PrestaShop et Sellermania :

Stock Sellermania : 10
Stock PrestaShop : 10

Une vente est faite sur une marketplace (pas encore intégrée sur PrestaShop)
Stock Sellermania : 10-1=9
Stock PrestaShop : 10

PrestaShop fait une vente (les commandes Sellermania ne sont toujours pas intégrées)
Stock Sellermania : 9-1=8 (la vente PrestaShop vient décrémenter)
Stock PrestaShop : 10-1=9

Les ventes marketplaces sont intégrées à PrestaShop
Stock Sellermania : 8
Stock PrestaShop : 9-1=8

Cas particulier qui pourrait causer une désynchronisation de stocks entre PrestaShop et Sellermania :

Exemple :
Vous démarrez avec des stocks différents entre Sellermania et PrestaShop
Stock Sellermania = 20
Stock PrestaShop = 30
Cette différence restera jusqu’à ce que vous écrasiez votre stock Sellermania par celui de PrestaShop, ou l’inverse.

Autre scénario :

Vous changez la quantité PrestaShop et la passez de 30 à 1, soit -29. Sellermania n’accepte pas de quantité négative, le module met donc 0 dans Sellermania.
Vous changez de nouveau la quantité dans PrestaShop et remplacez 1 par 10 (admettons que vous aviez oublié un zéro !) Sellermania va être mis à jour à 9 : 0 + (10 - 1)

Que devez-vous faire ? Quelques bonnes pratiques :

1) Si vous êtes abonné au Mappeur Sellermania : C’est une bonne idée de programmer votre Mappeur afin qu’il aspire votre flux PrestaShop au moins une fois par jour (format « inventaire simple »). Ceci écrasera les stocks Sellermania par ceux qui sont dans PrestaShop. De cette façon, pendant la journée le module fait les mises à jour très rapidement sur Sellermania en fonction des ventes PrestaShop (via la syncrhonisation), et une fois par jour vous refaites une synchronisation globale (via le Mappeur).
2) Si vous n’êtes pas abonné au Mappeur : Chargez une fois de temps en temps un fichier dans Sellermania afin de refaire une mise à plat.
3) Mettez les stocks à jour uniquement dans PrestaShop, et pas dans Sellermania : En effet, il n’y a aucune synchronisation dans le sens Sellermania > PrestaShop. Tout changement dans Sellermania causerait une désynchronisation des deux systèmes. Les stocks seraient alors corrects dans Sellermania, là où vous faites des mises à jour, mais incorrects dans PrestaShop, ce qui serait dommage !
4) Dans Sellermania, n’oubliez pas de configurer vos exports vers les marketplaces automatiquement (onglet Préférences) !