Guide d'intégration produits
- Caroline Brosse
- Elies Mecili
- Anciaes Laura
Nous avons mis en place ce guide afin de vous accompagner pas à pas et permettre la mise en ligne de vos produits sur Pixmania.
N’hésitez pas à utiliser le sommaire afin d’accéder aux pages souhaitées.
Nous restons disponibles pour toute question.
L'équipe Pixmania
partenariats@pixmania.com
1/ Création de vos produits
Avant de commencer, il est important de différencier le produit d’une offre.
Un produit est un ensemble d’informations constituant une fiche-produit : titre, image, description, product ID / EAN / UPC / ISBN, taille / couleur... > L’ensemble des produits constitue le catalogue (appelé MCM)
Une offre est constituée d’informations commerciales : prix / quantité / état… Une offre permet de vendre un produit existant dans le catalogue.
A - Choisir sa méthode d’intégration
5 choix s’offrent à vous :
Création manuelle : depuis le Back Office, recommandé pour moins de 20 produits
Fichier d’intégration : depuis Excel, recommandé si pas d’automatisation catalogue
Intégrateur de flux
Intégration par API
Intégration par HTTP / FTP
Quelque soit la méthode utilisée, il est primordial de remplir un MAXIMUM d’attributs et de qualifier vos fiches produits dans le détail pour un maximum de visibilité, enrichir la page du produit et augmenter les taux de conversion.
1. Création manuelle depuis le Back-Office
Mon stock > Ajouter une offre
Première étape : En amont, vérifier si le produit fait déjà partie de notre catalogue en recherchant : un nom de produit, une marque ou une référence...
Si le produit n’existe pas dans notre catalogue, Créer un produit
Il suffira alors de remplir manuellement les champs demandés en veillant à bien catégoriser le produit et en remplissant un MAXIMUM D’ATTRIBUTS.
Si le produit existe dans notre catalogue cliquez sur Vendre ce produit.
Passez à l'étape, d'ajout d’offre ici
2. Création par fichier
Prix et stock > Importer par fichier
1 Télécharger votre fichier
2 Indiquer le contenu du fichier (produits)
3 Indiquer le mode d’import (le mode normal est recommandé)
4 Cliquer sur Importer
Voici le modèle fichier Produits et Offres Pixmania avec le détail des attributs qui s’affichent une fois la catégorie sélectionnée dans la colonne A.
Nous recommandons de remplir UN MAXIMUM d’attributs afin de gagner en visibilité.
Pour les valeurs d'attributs sous forme de liste, celles-ci apparaissent lorsque vous cliquez sur la cellule. Vous pouvez retrouver l’intégralité des valeurs pour chaque attribut sur la feuille « Données de références » ou « ReferenceData »
3. Création par intégrateur
Au préalable, il est nécessaire de connecter votre boutique Mirakl à la solution de l'intégrateur que vous aurez choisi.
Pour cela, on vous demandera :
Votre ID Shop à récupérer dans Mon compte > Paramètres
Votre clé API à récupérer en cliquant sur votre adresse mail en haut de page puis dans Mes préférences utilisateur > Clé API
Le paramétrage du catalogue se fait sur l'interface de l'intégrateur.
Voici la liste des intégrateurs avec lesquels Pixmania est connecté :
 |  |
 |
|
|
|
|---|
Si votre intégrateur de flux n’apparait pas dans la liste, n’hésitez pas à nous contacter directement.
4. Création par API
Les flux produits et offres peuvent être gérés par API.
Votre clé API est au préalable à récupérer en cliquant sur votre adresse mail en haut de page puis dans Mes préférences utilisateur > Clé API
Vous trouverez ici un document explicatif.
5. Création par HTTP/ FTP
Cette méthode est à utiliser si votre catalogue de produits se trouve sur un serveur FTP
N'hésitez pas à contacter le support technique qui pourra activer les configurations des produits et/ou des offres.
B - Informations importantes - Produits
Attribut | Définition |
|---|---|
EAN | 13 chiffres permet d’identifier le produit (code barre) |
SKU Offre sku | Chaque produit doit avoir une référence unique |
Titre FR title-fr_FR | Structuré, concis, dotés de mots clés Ne pas indiquer la marque dans le titre car celle-ci se greffe lors de la mise en ligne |
Description FR description-fr_FR | La description de votre produit doit être bien structurée, concise, dotée des mots clés que vos prospects chercheront. |
Image_1 Image_1 | HD / 1000X 1000 px / 1ère image fond blanc / mini 2 visuels > 5 maxi Format accepté : GIF (.gif) - JPEG (.jpg) - PNG (.png) - WEBP (.webp) Taille maximale : 10244KB |
Catégorie Category | Catégorie à renseigner avec une grande précision pour une meilleure visibilité |
Variant Variant_group_code | Vous pouvez mettre en place des variations de produit par couleur, capacité… en indiquant un code de regroupement (1234 / ABCD…) pour identifier des variants. Il est nécessaire que les attributs soient renseignés pour que cela remonte sur le site : Pack iPhone 14 Pro Max 128 Go, violet intense  Pack iPhone 14 Pro Max 128 Go, or Pack iPhone 14 Pro Max 256 Go, violet intense Pack iPhone 14 Pro Max 256 Go, or Exemple de variants pour accessoires, à faire par marque et par gamme :
|
Couleur color | Sélectionner une des couleurs de la liste (première couleur primaire uniquement) |
Key selling points / | A ne pas négliger, points clés afin de mettre en avant votre produit |
Marque Brand | Contacter le service support (supportpro@pixmania.com) pour vérifier que la marque de vos produits est déjà dans notre base ou le cas échéant, demander la création de celle-ci au support technique (Format Apple) |
5 conseils clés :
La qualité des visuels est le 1er critère de conversion
Soignez le titre de vos produits pour générer un maximum de clics
Rédigez des descriptions produits riches et pertinentes
Renseignez vos catégories avec parcimonie pour structurer votre catalogue
Ajoutez le maximum d’attributs produits pour vous permettre une visibilité optimale. Ne pas négligez les Key Selling Point
|
|
|---|---|
 |
 |
|
|
2/ Ajout d’offres
Les produits existent dans notre catalogue, vous pouvez alors ajouter uniquement vos offres.
A - Méthodes d’intégration du flux offres
Ajout d’offres manuel
Remplissez les informations relatives à l'offre (Etat, quantité en stock, …). Les champs obligatoires sont matérialisé par *
Cliquer sur Créer l’offre
Une fois validée, l’offre sera visible sur le site dans les 15 minutes si le produit a bien été accepté en amont.
Ajout d’offres par fichier
Mon stock > Importer par fichier
1 Télécharger votre fichier
2 Indiquer le contenu du fichier (choisir offres)*
3 Indiquer le mode d’import (le mode normal est recommandé)
4 Cliquer sur Importer
A NOTER : Vous pouvez faire la création de produits & l’ajout d’offres sur un SEUL & UNIQUE fichier en téléchargeant le modèle Pixmania et en choisissant comme Contenu du fichier Offres et Produits
B - Informations importantes - Offres
Information | Définition |
|---|---|
SKU Offre sku | Référence unique |
ID Produit Product-id | Indiquer EAN ou SKU |
Product ID Type Product-id-type | Indiquer le type ID  |
Prix Offre Price | Fixer un prix de vente qui soit juste |
Quantité Offre Quantity | Indiquer le stock dont vous disposez pour chaque produit |
Etat Offre State | Neuf (11) |
Prix remisé Discount_price | Le prix de remise doit être inférieur au prix de référence. |
Date début promotion discount-start-date | Si la date de début de la promotion n’est pas définie, la réduction s’appliquer immédiatement Si la date de début et la date de fin ne sont pas définies, la remise est permanente |
Date fin promotion discount-end-date | Si la date de début et la date de fin ne sont pas définies, la remise est permanente |
Délai d'expédition (en jours) leadtime-to-ship | Indiquer le temps nécessaire pour expédier la commande Si préparation et envoi de la commande le jour même, indiquer 0 |
Warranty | Indiquer en mois - ex : 24 pour 24 mois |
Warehouselocation | Indiquer France, Espana, Europe ou Hors_Zone_EU |
C - Publier vos Offres sur le canal espagnol
Pour mettre en ligne vos offres sur le canal espagnol, merci de vérifier au préalable les points suivants
Le canal a été ouvert par votre chargé de compte.
Les paramètres de livraison ont bien été activé depuis votre interface.
Option 1 - Manuellement :
Allez dans l'onglet "Prix et Stock" > "Offres" de votre Pix’Back Office.
Sélectionnez l'offre concernée.
Cliquez sur le prix actuel à droite.
Ensuite, cliquez sur l'icône bleue "Ajouter".
Sélectionnez le type de prix spécifique, indiquez votre prix et le prix barré si nécessaire. En bas de page, choisissez le canal ES – Spain – B2C.
Enregistrez, votre offre est désormais en ligne.
Option 2 - Via Fichier Excel :
Dans l'onglet "Prix et Stock" > "Offres", choisissez l'option "Prêt pour import" en format XML en haut à droite.
Une fois le fichier téléchargé, remplissez les colonnes suivantes sur le fichier :
price[channel=ES_B2C]
discount-start-date[channel=ES_B2C]
discount-end-date[channel=ES_B2C]
discount-price[channel=ES_B2C] Remplissez ces colonnes de AA à AD avec vos prix.
Enregistrez le fichier.
Importez ces nouvelles offres depuis l'onglet "Mon stock" > "Imports de fichier". Utilisez ce lien : Lien d'Import
Ajoutez votre fichier, choisissez le mode d'import "Normal", puis cliquez sur "Importer".
Vos offres seront en ligne sur le site espagnol dans les 30 minutes.
Option 3 - Via API ou Intégrateur de Flux :
Complétez les nouvelles colonnes associées au canal espagnol (ES_B2C) :
price[channel=ES_B2C]
discount-start-date[channel=ES_B2C]
discount-end-date[channel=ES_B2C]
discount-price[channel=ES_B2C]
Suivez ces étapes pour mettre à jour vos offres sur le canal espagnol. Si vous avez des questions, n'hésitez pas à nous contacter.
3/ Suivre vos imports produits et offres
Vous pouvez suivre vos imports produits et offres depuis Mon stock > Importer par fichier
A - Suivi des Imports Produits
Pour suivre vos imports produits, rendez vous sur Mon stock > Importer par fichier puis Suivi imports produits et vérifier si votre fichier a été intégré à 100% ou si celui-ci comporte des erreurs.
A titre d’exemple :
100% des produits intégrés
Le fichier comporte des erreurs d’intégration. Vous pouvez télécharger le rapport d’erreur de la transformation
Analyser les erreurs du fichier produits
Voici les erreurs les plus courantes ainsi que les solutions associées :
Code d'erreur | Message d'erreur | Cause/Solution |
|
1000 | L'attribut {…} est obligatoire
The attribute {…} is required
| Assurez-vous que tous les attributs obligatoires ont été renseignés. Solution :
|
|
1001 | La catégorie {0} est inconnue
The category {0} is inknown | La catégorie que vous avez renseignée n'existe pas ou n'est pas correctement écrite. La solution
|
|
1002 | Nombre de champs incorrect
Incorrect number of fields | Cette erreur a deux origines possibles :
|
|
1004 | La catégorie n'a pas pu être identifiée
The category could not be identified | L'en-tête de colonne qui contient les informations de catégorie est différent de la valeur mappée dans l'assistant de configuration. Solution : Vérifiez si le nom d'attribut est correctement écrit dans l'en-tête du fichier et n'est pas différent du nom d'attribut utilisé. |
|
1006 | La catégorie de catalogue {0} doit être mappée à une catégorie de catalogue d'opérateur
The catalog category {0} must be mapped to aleaf operator catalog category | Votre catégorie n'est pas mappée à notre catégorie.
Solution : Vérifiez la catégorie est acceptée sur notre marketplace ou vérifiez la syntaxe (ex : mapping téléphone au lieu de smartphone) |
|
2006/3006 | L'attribut {0} n'est pas dans les valeurs possibles définies dans la liste de valeurs
The attribute {0} is not in the possible values set in the value list | La valeur d'attribut que vous avez renseignée n'existe pas dans la liste de valeurs que nous avons créé.
Solution Vérifiez dans l’onglet ReferenceData du modèle Pixmania les valeurs d’attributs possibles |
|
2010/3010 | L'attribut {0} doit être un entier
The attribute {0} must be an integer | Le type de l'attribut est INTEGER. La valeur que vous avez renseignée n'est pas un entier. La solution Dans le fichier produit importé, vous devez entrer une valeur entière (sans décimales). Un entier est un nombre qui peut s'écrire sans fraction (par exemple 5, 47, 280). |
|
2011/3011 | L'attribut {0} doit être numérique
The attribute {0} must be numeric | Le type de l'attribut est DECIMAL. La valeur que vous avez indiquée n'est pas un chiffre. La solution Dans le fichier produit importé, vous devez entrer une valeur numérique. Un numérique est un nombre qui peut contenir une décimale (par exemple : 25,6, 12, 65,99). |
|
B - Suivi des imports Offres
Pour suivre vos imports offres, rendez vous sur Mon stock > Importer par fichier puis Suivi imports offres et vérifier si votre fichier comporte des erreurs.
A titre d’exemple :
Si l’import d’offres comporte des erreurs, vous verrez apparaître une colonne Erreurs et en cliquant sur le symbole vous pourrez télécharger le fichier regroupant les erreurs.
Analyser les erreurs du fichier d’offres
Voici les erreurs les plus courantes ainsi que les solutions associées :
Message d'erreur | Cause/Solution |
Le produit n'existe pas
The product does not exist | Indiquer dans le fichier les " Si ce message d’erreur apparait, c'est qu'aucun produit avec cet identifiant n'existe dans Mirakl. Solution :
|
Aucune offre existante à mettre à jour
No existing offer to update
| Vous utilisez le mode "UPDATE" pour importer vos offres et le SKU de l'offre ne correspond pas à une offre existante dans Mirakl. Solution :
Mon stock > Importer par fichier > Mode d'import : Normal |
Le champ 'sku' est dupliqué dans le fichier source The 'sku' field is duplicated in the source file | Dans votre fiche vendeur, plusieurs offres ont le même "sku". Cette référence doit être unique pour chaque offre. Solution :
|
L'état du produit est inconnu
The state of the product is unknown | L'état du produit saisi n'existe pas Solution :
|
Le produit lié à la nouvelle offre est différent du produit lié à l'offre existante
The product linked to the new offer is different from the product linked to the existing offer | L'offre-sku a déjà été attribuée à un autre produit. Si une offre est supprimée, le SKU (identifiant unique) de l'offre attribué à cette offre ne peut pas être utilisé pour créer une autre offre sur un produit différent pendant 30 jours. Solution :
|
Le champ 'prix' est obligatoire
The ‘price’ field is mandatory | Le champ "prix" est introuvable dans votre fichier Solution : Si une valeur est présente dans ce champ, vérifiez si elle est correctement écrite ou formatée. Lorsque vous utilisez un format CSV ou XML, assurez-vous que le symbole monétaire soit supprimé. |
La famille logistique est inconnue
The logistic family is unknown | La famille logistique saisie n'existe pas. Solution : Spécifier une famille logistique existante
|
Le champ 'leadtime-to-ship' a une valeur invalide
The ‘leadtime-to-ship’ field has an invalid value | La valeur du champ "délai d'expédition" est incorrecte. Solution :
|
La plage de dates de remise est incorrecte
The discount range date is incorrect | Le format correct de chaque date est "aaaa-mm-jj". Solution : Vérifier si:
|
Le prix de remise est incorrect : il ne doit pas être nul ou doit être inférieur au prix The discount price is incorrect : must not be null or must be lower than price | Vous ne pouvez pas spécifier un prix réduit égal ou supérieur au prix de l'offre d'origine. Solution : Vérifiez si le prix de remise est strictement inférieur au prix d'offre. |
Mapping par fichier
Pour que votre fichier puisse être au format demandé, vous pouvez vous aider de l’assistant de configuration depuis :
Mon stock > Importer depuis un document > Ouvrir l’assistant de configuration
L’assistant de configuration vous permet d’associer les champs de votre fichier source à nos spécificités au niveau des attributs.
Ouvrez simplement l’assistant et laissez vous guider étape par étape…
Il est primordial que l'ensemble de vos catégories de produits soit dans une seule et même colonne. Pour cela vous pouvez utiliser la formule Excel &“ >”,
Si vous utilisez des fichiers CSV qui contient des caractères spéciaux, n’oubliez pas de vous assurer qu’ils soient encodés en UTF-8.
C - Modification des prix et mise en place de promotion
Modifier le prix d’un produit
Après avoir créé une offre, vous pouvez modifier vos pricing à tout moment via deux méthodes :
Modifier un prix manuellement sur le Back Office (BO)
Afin de modifier un prix manuellement, rendez-vous sur Mon stock > Liste de mes offres
Sur le côté droit, cliquez sur les pointillés et sélectionnez Editer le prix
Vous disposez des informations concernant l’offre dans le bloc à gauche
Titre
Etat
Quantité en stock
Prix en cours
← Vous pouvez observer les offres concurrentes sur le produit afin de déterminer le meilleur prix à proposer au client.
Vous pouvez modifier le Prix *
Configurer un Prix remisé (définir un prix)
N’oubliez pas de déterminer les périodes de validité car sans ces informations, le prix remisé sera permanent.
Il est primordial d’indiquer un prix initial en complément du prix remisé afin de faire apparaitre un prix barré.
2. Modifier un prix par fichier
Pour modifier le prix de vos produits et mettre en place une promotion, rendez-vous sur votre interface Mirakl.
Mon stock > Liste de mes offres
Cliquer sur Télécharger l’inventaire au format “prêt pour l’import” - l’icône ci-dessous :
Vous obtiendrez ainsi un fichier avec toutes vos offres. Et vous pourrez modifier le prix, et ajouter les dates de l’opération dans les colonnes ci joint :
D - Modification du stock
Pour modifier le stock de vos produits, rendez-vous sur votre interface Mirakl.
Mon stock > Liste de mes offres
Cliquer sur Télécharger l’inventaire au format “prêt pour l’import” - l’icône ci-dessous :
Vous obtiendrez ainsi un fichier avec toutes vos offres. Et vous pourrez modifier la quantité (Colonne H) et importer à nouveau votre fichier d’offres.
4/ Les connecteurs
Connecteur Shopify Connect
L'application Shopify de Mirakl permet d'intégrer facilement une boutique Shopify à une place de marché Mirakl et de gérer les opérations commerciales de toutes les places de marché basées sur Mirakl directement depuis Shopify.
Une fois le connecteur installé, tous vos produits seront automatiquement importés dans Mirakl Connect. Un export est effectué toutes les 5 minutes de Shopify vers Mirakl pour assurer la cohérence des données entre les deux catalogues.
Principales fonctionnalités
Synchroniser les prix et stocks entre Shopify et Mirakl
Exporter l'intégralité du catalogue de produits de Shopify vers Mirakl Connect
Créer des listes, gérer les mapping produits et exporter des produits vers le catalogue de l'opérateur à partir de Mirakl Connect
Gérer et importer leurs commandes Mirakl Marketplace dans Shopify
Lien d’installation
Créer un compte gratuitement sur Mirakl Connect, puis depuis Mirakl Connect sur la page “Catalogue Shopify” ou sur l'App Store de Shopify depuis : https://apps.shopify.com/mirakl-marketplaces-app
Pour plus d’information : consulter la page Help de Mirakl « Shopify » https://pixplace.pixmania.com/help/Customers/topics/Connectors/shopify/shopify_seller_faq.htm
Connecteur Magento Connect
L'application Magento de Mirakl permet d'intégrer facilement une boutique Magento à une place de marché Mirakl et de gérer les opérations commerciales de toutes les places de marché basées sur Mirakl directement depuis Magento.
Une fois le connecteur installé, tous vos produits seront automatiquement importés dans Mirakl Connect. Un export est effectué toutes les 5 minutes de Magento vers Mirakl Connect pour assurer la cohérence des données entre les deux catalogues.
Principales fonctionnalités
Synchroniser les prix et stocks entre Magento et Mirakl
Exporter l'intégralité du catalogue de produits de Magento vers Mirakl Connect
Créer des listes, gérer les mapping produits et exporter des produits vers le catalogue de l'opérateur à partir de Mirakl Connect
Gérer et importer leurs commandes Mirakl Marketplace dans Magento
Lien d’installation
Depuis Mirakl Connect sur la page "Catalogue Magento" ou sur l'App Store de Magento : https://marketplace.magento.com/mirakl-connector-magento2-seller.html
Pour plus d’information : consulter la page Help de Mirakl « Magento » https://pixplace.pixmania.com/help/Customers/topics/Connectors/Magento2/mg2_connector.html
Information essentielle
Afin d'assurer une expérience client optimale et le bon déroulement de vos ventes, nous vous prions de bien vouloir effectuer quelques vérifications cruciales :
Vérification des commandes : Assurez-vous que les commandes remontent correctement de votre côté au bon prix. Avez-vous bien reçu l'alerte ?
Frais de port : Confirmez que vos frais de port sont corrects, actuellement ils sont gratuits.
Délai de livraison : Vérifiez que le délai de livraison est conforme à nos standards. Par example pour une commande passée le 13/01/2024, avec la date de livraison indiquée pour le 25/01/2024, dépasse nos attentes. Pouvez-vous réduire ces délais ? Rappelons que le produit doit être livré au client en moins de 10 jours.
Communication avec les clients : Assurez-vous de répondre aux messages des clients dans la langue appropriée au pays d’envoi (en français pour ces commandes) afin de maintenir une communication claire et efficace.
Suivi de la commande : Ajoutez le tracking directement sur votre back office pour que le lien de suivi soit automatiquement envoyé au client. Vérifiez que le lien de suivi des commandes est correct et fonctionne lorsqu'on clique dessus. Merci de ne pas indiquer de tracking lorsque la commande n’est pas expédiée.
Facture : Pouvez-vous ajouter automatiquement la facture à la commande dès que vous expédiez ? Cela réduira considérablement le taux de contact.
Reglès à tenir en compte : Assurez-vous de valider une commande dans le délai maximum de 5 jours afin d’eviter que notre logiciel ferme automatiquement votre boutique.
Faire attention à : La synchronisation de votre stock en temps réel avec votre API ainsi que veiller à la synchcronisation de prix fournisseur avec les prix qui sont live sur notre site.
Vos contacts chez Pixmania
Service Comptabilité : comptabilite@pixmania.com
Service Client : service-client@pixmania.com
Service Commercial : partenariats@pixmania.com
Service Technique : supportpro@pixmania.com
Nous vous souhaitons de belles ventes sur Pixmania !