Guide d'intégration produits
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 |