Commencer
Préambule Rakuten
Compatibilité La version 4 du module fonctionne sur Prestashop 1.4, 1.5, 1.6 et 1.7. Préconfiguration Par défaut la configuration est parfaitement adapté aux besoin courants. Ne configurez le module que si vous en éprouvez le besoin et si vous ne connaissez les conséquences de ces réglages. Fonctionnalités Une fois la configuration terminée vous retrouvez les fonctionnalités actives du module : Dans l’onglet Catalogue > Rakuten France Dans l’onglet Commandes > Rakuten FranceQuelques lecturesBien savoir différencier une offre et un produit
Pour commencer, prenons un exemple de la vie de tous les jours ; vous êtes devant la vitrine d’un magasin, un article vous plait, par exemple un T-Shirt présenté en vitrine. Vous venez donc d’apercevoir un produit qui vous plait. Vous entrez dans le magasin, vous vous dirigez vers le rayon où se situe ce T-Shirt, vous aller y trouver les offres correspondantes : ce T-Shirt, dans toutes les tailles et les coloris, avec des prix différents, il s’agit donc des offres. Revenons aux placesPeu de lecturesValider votre structure de catalogue (Rakuten)
Il est important de toujours appliquer la même méthodologie pour créer des articles, leur appliquer une référence, un code EAN, etc. Ainsi votre catalogue sera structuré pour vos besoins internes et externes, donc les places de marché dans le cas présent. Dans tous les cas, le champ référence est utilisé comme SKU pour la place de marché. C’est à dire que le champ Référence est votre identifiant interne unique pour Rakuten France, communément appelé le SKU. Ce champ sera utilisé pour identifiePeu de lectures
Configurer
Installer le module
La procédure d’installation est décrite sur le site de Prestashop ici : http://addons.prestashop.com/fr/content/21-howto Cette documentation est ancienne mais correspond parfaitement à la réalité actuelle, tous les cas sont précisément décrits et c’est pourquoi nous avons décidé de ne pas la ré-écrire. Si la procédure d’installation automatique réalisé depuis le backoffice ne fonctionne pas, suivez également les instructions de cette documenPeu de lecturesConfigurer les Paramètres de Connexion
Vous utilisez pour la première fois le module, vous devez configurer vos paramètres de connexion qui permettront au module de se connecter. Connectez vous à votre compte vendeur, puis Paramètres du Compte > Token. Vous pouvez vous y rendre directement depuis ce lien (accessible après s’être connecté à votre compte vendeur) : [https://www.priceminister.com/usersecure?action=usrwstokenaccess](https://www.priceminister.coQuelques lecturesConfigurer un Modèle
Comme indiqué dans le préambule, il faut lire “modèles de données produits” pour comprendre l’utilité des modèles. Vous utiliserez les modèles pour compléter pour un ensemble d’articles les données nécessaires pour Rakuten France. Les modèles seront utilisés également si vous avez des déclinaisons afin de les envoyer sous forme de “Variantes” qui esPeu de lecturesConfigurer un Profil
Comme indiqué dans le préambule, les profils sont utilisés pour établir la correspondance entre vos produits tels qu’ils sont sur votre boutique Prestashop et tels qu’ils doivent arriver sur Rakuten France. Vous pourrez aussi appliquer des règles globales telles que lPeu de lecturesConfigurer les Mappings
Vous avez des attributs produits qui ne correspondent pas aux attributs attendus par Rakuten France, vous avez alors besoin de remplacer une valeur par une autre, les mappings sont utilisés pour cela. Les mappings sont aussi applicables, de la même manière, pour les caractéristiques. Vous trouverez deux sections, une section Attributs, uQuelques lecturesSélection de Catégories
Si vos profils ne sont pas encore configurés, rendez vous dans l’onglet Profils en premier, avant de sélectionner les catégories. Vous sélectionnerez les catégories des produits que vous souhaitez exporter. A gauche la catégorie doit être cochée, à droite vous devez sélectionner un profil, ici un exemple encadré en rouge:  Vous indiquerez si le module doit utiliser la synchronisation par Référence (SKU) ou ID Produit. L’utilisation du choix ID Produit n’est généralement pas nécessaire et nous recommandons l’utilisation du champ Référence. Vérifiez que vous produits ont tous dePeu de lecturesStatuts des Commandes
Une fois les commandes importées et lors de l’expédition de la commande, il sera nécessaire d’actualiser le statut pour notifier à Rakuten France l’expédition et le numéro de suivi. Le module notifie Rakuten France, Rakuten France notifie le client. Vérifiez votre configuration : Vous avez configuré au préalable vos statuts de commandes :Peu de lecturesRègles de Prix
Vous pourrez définir des règles de prix pour vos export vers Rakuten France, ces règles s’appliquent sur les prix toutes taxes comprises. Vous pourrez définir une règle de prix pour chaque profil. Les règles de prix sont des tranches, pour chaque tranche vous pourrez définir une valeur ou un pourcentage. Voici un exemple : Dans cPeu de lectures
Repricing
Repricing – Informations Générales
Prérequis Vous avez une pleine maîtrise du module, vous savez créer des produits, gérer des modèles et profils, synchroniser vos offres, importer vos commandes, toutes vos tâches planifiées sont opérationnelles (etc.). Le Repricing est la dernière fonctionnalité a activer, elle nécessite aussi une bonne connaissance générale de Rakuten France. Notez toutefois, la configuration est très simple, se fait sur une seule page : . Commencez votre configuration en ajoutant une seul stratégie, une fois cette première configuration maîtrisée vous pourrez configurer jusqu’à une stratégie par [Profil](https://doc.common-Quelques lecturesRepricing – Fonctionnement, Tests
Dans l’onglet Tâches Planifiées de la configuration, vous retrouverez une section Repricing avec deux scripts, un destiné au téléchargement du fichier de repricing, l’autre destiné au traitement du fichier et calcule des prix. Afin d’être efficace, il est recommandé de mettre en place ces tache planifiée toutes les 30 minutes, avec la tache planifiée destiné au traitement du fichier qui sera exécuté 5min après le script de téléchargement du fichier de repricing. Pour les tests, on lancera plusPeu de lecturesRepricing – Configuration des tâches planifiées
Le module va afficher de nouvelles entrées dans les tâches planifiées, vous devrez donc suivre les instructions de l'onglet : Tâches Planifiées. Notez toutefois qu'il y a quelques particularités à signaler ; La configuration donnée par le module correspond à un fonctionnement sans le module Prestashop Cronjobs qui est bridé à une fréquence de 1h, puisque le module Cronjob ne permet pas d'aller en deçà d'une heure. Les liens des tâches planifiées se trouvent dans la partie “Tâches planifiées” uPeu de lectures
Utiliser
Export – Création de Produits
1. Préparez l’envoi de vos produits Vous avez consulté le préambule, vos paramètres de connexion sont configurés, vous avez configuré un [profil](https://doc.comPeu de lecturesExport – Envoi des Offres
Vous configuré votre module, sélectionné des catégories, renseigné les profils, configuré le transport, vous pouvez ePeu de lecturesExport – Rapports
Dans cet onglet vous verrez l’historique des fichiers envoyés, vous pourrez télécharger le fichier XML et afficher le Rapport. Le Rapport vous permet d’afficher le résultat de l’intégration de votre fichier par Rakuten France. Il peut arriver qu’il y ait des erreurs d’intégration qui n’ont pas pu être anticipés par le module, le rapport vous permetPeu de lecturesImport des Commandes Rakuten
Le module affichera la liste des commandes à importer, vous pourrez les importer individuellement ou par lot. Un script d’import automatique est mis à votre disposition, référez vous à la section tâches planifiées de la documentation. Une fois importées, vous retrouverez les commandes dans votre liste des commandes habituelles, les commandes Rakuten France ont alors une méthode de paiement “Rakuten France”. Important : Si le mode “Par Référence” est configuré (Configuration du module), LePeu de lecturesExtension Fiche Produit
Rendez vous sur une fiche article de votre boutique. Un onglet Rakuten France apparaît en + des informations habituelles : Dans cet onglet, vous pourrez indiquer toutes les valeurs optionnelles spécifiques à Rakuten France. Ces options permettent de régler finement votre export pour ce produit, vous retrouverez notamment : LePeu de lecturesTâches Planifiées Rakuten
Pour chaque plateforme vous trouverez une liste de tâches planifiées, communément appelées “cron”, permettant par exemple la mise à jour automatisée de votre catalogue sur Rakuten France. Aussi, nous vous conseillons d’utiliser le module crontab de Prestashop : https://github.com/PrestaShop/cronjobs Le module vaPeu de lectures
Support
Contact Rakuten
Support Common-Services pour le module Rakuten France Marketplace pour Prestashop Dans tous les cas avant de contacter le support vous devrez avoir pris connaissance de la documentation, et sachez qu’il est aussi frustrant pour le support que le client n’ait pas lu la documentation que pour le client de s’entendre dire d’aller lire la documentation ! Le module existant depuis 2011, la plupart des problèmes sont connus et répertoriés dans la catégories problèmes fréquents ou dans notre baseQuelques lecturesLimites de support et de garantie
Limites du Support Est hors de responsabilité le paramètrage lié au quantitatif de la boutique (quantité produits, images, catégories…) Sont exclues les mises à jour de versions de la boutique Prestashop Sont exclus le changement de serveur, d’hébergeur ou de version de PHP Les modifications du module entrainent une révocation de fait du support Il ne sera pas offert de support en cas de mises en service multiples ou de changement majeur du catalogue Limites de Garantie NouPeu de lectures
Problèmes Fréquents
Mettre à jour le fichier modèle
Il faut parfois mettre à jour le fichier modèle (de définition) afin d’ajouter (ou supprimer) de nouveau champs, requis ou non, par Rakuten France lors de la création de vos produits. Pour cela, allez dans la configuration du module et regardez votre modèle Rakuten France et récupérez son nom : Dans notre exemple, le nom du modèle est ***vPeu de lecturesQu’est-ce que le mode matching ?
Par défaut, le module synchronise vos offres, on parle de synchroniser par abus de langage, mais ce n’est pas le propos. Si votre offre correspond à une offre sur Rakuten France, donc si la référence de votre produit sur Prestashop correspond à la référence sur Rakuten France (le SKU) alors l’offre est mise à jour, la quantité, le prix (…). Quand vous n’avez pas cette référence sur Rakuten France, le module peut envoyer l’offre incluant le code EAN ou UPC, à ce moment là Rakuten France rechercPeu de lecturesL’alias est obligatoire pour les créations de produit
L’alias du modèle est manquant dans le fichier XML envoyé à Rakuten France. Allez dans la configuration du module et vérifiez votre modèle, le type de produit doit être absent : Sélectionnez de nouveau le type de produit est enregistré la configuration.Peu de lecturesProduit supprimé de la boutique n’est pas supprimé sur PriceMinister
L’API Rakuten France fonctionne en mode “mise à jour” et non pas en mode “purger et remplacer”, ce qui signifie que si aucune information n’est envoyé concernant un produit il n’est changera pas (même stock, même quantité, …). Afin de supprimer un produit de Rakuten France, vous devez le marqué comme étant désactivé dans sa fiche produit puis faire un export d’Offres afin qu’il soit mis à jour. Si le produit a déjà été supprimé de votre boutique avant d’avoir envoyé la mise à jour d’Offres ilPeu de lecturesSelf intégration de place de marché, comment cela fonctionne ? quel est le rôle de chacun ?
Vous avez été redirigé sur cette page pour que soit bien compris le contexte, le principe de l’auto-intégration de catalogue sur une place de marché, comment nous fonctionnons, comment réussir votre intégration place de marché. Place de Marché vs eBay Il est souvent revendiqué que l’envoi de produits sur eBay est plus simple et moins contraignant, ce qui est vrai. Pourquoi ? Car historiquement, eBay n’est pas une place de marché mais un site d’enchères et de petites annonces, donc un prodPeu de lecturesMulti-boutiques: questions et problèmes fréquents
Vous avez certainement été redirigé sur cette page car vous utilisez le mode multi-boutiques de Prestashop, il faut donc que vous preniez connaissance des cas les plus généraux, les plus fréquemment rencontrés ; Contextes En utilisant le multiboutiques vous vous engagez a avoir pris connaissance de la documentation corrélative de Prestashop et à ne pas nous consulter pour des problèmes liés aux contextes ; Le contexte se mPeu de lecturesImpossible d’importer une référence dupliquée
Vous importez vos commandes et vous obtenez un message d’erreur comme celui ci : ||| Impossible d'importer une référence dupliquée (doublon) (demo_1) Ce problème survient lorsque vous ayez deux produits avec la même référence, ou alors votre produit principal et une de ses déclinaisons ont la même référence. Pour résoudre ce problème, vérifiez pour le produit de la commande que le produit principal et ses déclinaisons ne partagent pas la même référence : ![PrestaShop Rakuten vérification dPeu de lecturesLe produit n’existe pas
Vous exportez vos produits et vous obtenez un message d’erreur comme celui ci : ||| Ce produit n'existe pas sur Rakuten France. Il faut le créer avant. **** Ce problème survient lorsque vous envoyer un flux d’offres mais que le produit n’a pas été créé auparavant. Pour résoudre ce problème, rendez-vous dans la section “Produits” et faite un export de vos produits. Prenez une plage de date assez grande afin de récupèrer un maximum de produits. ![PrestaShop Rakuten export produits](httpsPeu de lecturesFastCGI Rakuten
FastCGI Certain hébergements fonctionnent sous FastCGI et d’autres sous mod_php. L’usage général pour les installations Prestashop est mod_php. Nos modules fournissent toutes sortes de diagnostics sur la base du fonctionnement avec mod_php, uniquement, car c’est le standard Prestashop. Nous vous rappelons que nous indiquons systématiquement sur nos fiches articles que nos solutions sont faites pour fonctionner sur des hébergements compatibles et recommandés par Prestashop dont voici la lisPeu de lecturesLimitations de configuration PHP
Vous rencontrez des problèmes techniques avec le module, nous vous redirigerons sur cette page. Un onglet PHP Info est disponible dans l’onglet Informations du module, consultez cette page : Cliquez sur PHP Info. Recherchez y les limitations les plus fréquemment rencontrées et nécessaires pour le bon fonctionnement du module, celles cPeu de lecturesProblème de permissions et de droits en écriture
Le module affiche un message d’erreur indiquant qu’il est impossible de créer le fichier. Il s’agit souvent d’un problème de permissions, de droit en écriture dans les dossiers et fichiers du module. Il faut vérifier que le module ait bien accès en écriture dans le répertoire d’export. Utilisez votre client FTP habituel, par exemple Filezilla Connectez vous sur votre serveur, rendez vous dans le répertoire du module, modules/priceminister : ![PrestaShop Rakuten répertoire du module](httpPeu de lecturesL’execution du script AJAX a échoué.
Vous obtenez un message d’erreur comme celui ci : ||| L'exécution du script AJAX a échoué. Veuillez vérifiez votre configuration et si le problème persiste envoyez une copie d'écran au support technique de Common-Services Différentes possibilités, la plus fréquente est que le nom de domaine que vous utilisez ne correspond pas au nom de domaine configuré dans vos paramètres Prestashop votre navigateur y voit une requête croisée entre différents domaines ce qui représente un problème de sécuritéPeu de lecturesInformations / Erreurs Courrantes
Le module procède a des vérifications de configuration et d’environnement pour s’assurer du bon fonctionnement du module sur votre installation Prestashop. Si un des message n’est pas référencé sur cette page, n’hésitez pas à nous contacter, consultez la page relative au support. Avertissements PHP : Limites Temps ou Mémorie PHP : ||| Configuration PHP: max_execution_time, la valeur recommandée est au moins 120, votrePeu de lecturesCode EAN/UPC manquant
Vous exportez vos produits et vous obtenez un message d’erreur comme celui ci : ||| Code EAN manquant pour les produits, References: [demo_1, demo_2] Il s’agit d’une liste de référence de produits vous pourrez retrouver le produit en collant la référence dans la barre de recherche de Prestashop. Cette liste indique tous les produits qui ont le champ “EAN” qui n’est pas renseigné, par exemple : ![PrestaShop Rakuten exemple produit sans EAN](https://storage.crisp.chat/users/helpdesk/websitPeu de lecturesCodes EAN en double
Vous exportez vos produits et vous obtenez un message d’erreur comme celui ci : ||| Produit "X/Y" - Code EAN en double Le produit concerné contient un EAN en double, c’est à dire que le code EAN du produit est présent deux fois ou plus dans la base de données ce qui est erroné. Exemple fréquent de doublon de code EAN : ![PrPeu de lecturesCode EAN incorrect pour les produits
Vous exportez vos produits et vous obtenez un message d’erreur comme celui ci : ||| Produit "demo_1" - Code EAN erroné - "9999399" Le produit concerné contient un EAN dont la clé de vérification est erronée, c’est à dire que le code EAN ne correspond pas aux spécifications GS1 ou n’a pas été émis par GS1. Les places de marché requièrent des codes EAN uniquement émis par l’organisme GS1, les codes générés par d’autres modules ou logiciels, les listes vendues ou gratuites disponibles sur InQuelques lecturesRéférence en double pour les produits
Vous exportez vos produits et vous obtenez un message d’erreur comme celui ci : ||| Produit Identifiant "xxx-yyy" - Référence en double Le produit concerné est un doublon, c’est à dire que la référence du produit est présente au moins deux fois dans la base de données ce qui est erroné. Exemple de doublon : Vous devez vérifierPeu de lecturesProduits avec une référence manquante
Vous exportez vos produits et vous obtenez un message d’erreur comme celui ci : ||| ID Produit/Déclinaison: 1/2 - Référence manquante Il s’agit d’un identifiant produit et son identifiant de déclinaison dans le format 1/2, 1 étant l’ID du produit, 2 l’ID de la déclinaison. Ce message indique que le produit na pas de champ “Référence” de renseigné, par exemple : ![PrestaShop Rakuten produit sans référence](https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/prestaPeu de lecturesUne page blanche s’affiche
Quand on clique sur un onglet du module, une page blanche est affichée ou Après installation du module, quand on clique sur Configurer, une page blanche s’affiche Il peut s’agir d’une page blanche ou d’une page du backoffice Prestashop mais tronquée. Dans ce cas, cela indique qu’il peut y avoir une erreur derrière cela et que pour l’afficher il faut activer le mode “Développement” quelques instant le temps de faire apparaître l’erreur. Suivez ce tutoriel Prestashop qui vous indiquera cPeu de lectures