Guide marketplace pour Mirakl
Exigences des fiches produit, spécifications de flux et conseils d'optimisation pour Mirakl.
Qu'est-ce que Mirakl ?
Mirakl est la principale plateforme de marketplace-as-a-service (MaaS) derrière des centaines de grandes marketplaces exploitées par des enseignes. Contrairement à Amazon ou eBay, Mirakl n'est pas un site où les consommateurs font leurs achats. C'est la plateforme SaaS qui fait tourner les marketplaces d'opérateurs comme B&Q, Decathlon, Galeries Lafayette, Macy's, Carrefour, Currys, Best Buy Canada et bien d'autres. Quand une enseigne lance une marketplace ouverte aux vendeurs tiers, elle choisit très majoritairement Mirakl en Europe et de plus en plus aux États-Unis. Pour un vendeur, 'vendre sur Mirakl' veut donc dire vendre chez l'opérateur Mirakl que tu vises, avec des schémas d'intégration largement communs d'un opérateur à l'autre.
Mirakl a deux côtés bien distincts : le côté opérateur (pour les enseignes qui exploitent une marketplace, avec la reprise des catalogues des vendeurs tiers, le mapping des attributs, le contrôle de la qualité du contenu et le routage des commandes) et le côté vendeur (pour les vendeurs tiers qui publient sur les marketplaces des opérateurs, avec la gestion des offres, le traitement des commandes et le suivi de performance). Pour l'opérateur, l'enjeu est de reprendre des catalogues vendeurs hétérogènes, de mapper leurs attributs sur sa propre taxonomie, de lancer des contrôles qualité et de publier les offres validées sur sa boutique. Pour le vendeur, l'enjeu est symétrique : fournir des données produit qui passent ces contrôles dès le premier envoi. C'est là que WISEPIM intervient, côté vendeur.
Mirakl accepte les données produit via l'Operator API et la Seller API, via des imports CSV ou Excel structurés et via les intégrations partenaires de l'écosystème Mirakl Connect. Chaque opérateur définit sa propre structure de catalogue (catégories et attributs obligatoires) dans le cadre Mirakl, mais les schémas d'intégration de base restent les mêmes. Tu peux donc servir plusieurs marketplaces Mirakl depuis un seul PIM. En connectant WISEPIM à une marketplace Mirakl, tu envoies tes données produit en tant que vendeur à l'opérateur via la Seller API : dans une catégorie feuille de son arborescence, avec en option des attributs obligatoires complétés par AI et vérifiés par rapport aux listes de valeurs autorisées de Mirakl. Chaque offre arrive ainsi avec la complétude d'attributs dont ont besoin les acheteurs comme les agents d'achat AI.
En bref
Exigences des fiches produit sur Mirakl
Champs obligatoires et facultatifs des fiches produit sur cette marketplace
Chaque opérateur Mirakl fixe ses propres règles de titre, mais la plupart suivent le schéma marque + nom du produit + attribut distinctif, qui correspond aux bonnes pratiques des marketplaces. Certains opérateurs comparent automatiquement les titres à leur catalogue existant, d'autres s'appuient sur un rapprochement assisté par AI. Évite le langage promotionnel, les majuscules partout et les informations propres au vendeur. Le titre doit décrire le produit, pas l'offre.
Bosch GSB 18V-21 Professional perceuse-visseuse à percussion sans fil : 18V, 2 batteries 2,0AhUn identifiant produit valide est obligatoire sur pratiquement toutes les marketplaces Mirakl. L'opérateur utilise le GTIN pour rattacher les offres des vendeurs aux produits existants du catalogue (et éviter les doublons) et pour vérifier l'authenticité du produit. La plupart des opérateurs refusent dès l'import les offres au GTIN manquant ou invalide. Pour les marques propres ou les articles sans marque, les opérateurs demandent en général un enregistrement GS1 valide avant la mise en ligne.
5012044000002Chaque opérateur définit sa propre taxonomie de catégories. Tu dois rattacher chaque offre à la bonne catégorie de l'opérateur, et la catégorie détermine souvent les attributs supplémentaires obligatoires. Dès que ton catalogue prend de l'ampleur, le rattachement des catégories depuis le PIM devient incontournable : rattacher des milliers de SKU à la main n'est pas une option. Dans WISEPIM, chaque connexion Mirakl charge l'arborescence de catégories de son opérateur, et tu choisis une catégorie feuille à l'export ou tu définis une catégorie par défaut pour la connexion.
Maison & Jardin > Outillage électrique > Perceuses > Perceuses-visseuses à percussionLes opérateurs gèrent la mise en forme HTML de façon différente. Certains acceptent le HTML enrichi (listes, gras, paragraphes), d'autres exigent du texte brut. Garde donc une description source dont tu tires une version HTML et une version texte nettoyée. Dans WISEPIM, tu choisis pour chaque connexion Mirakl si le HTML est échappé à l'export. Les descriptions doivent mettre en avant des caractéristiques produit factuelles, pas la marque du vendeur.
La perceuse-visseuse à percussion sans fil Bosch GSB 18V-21 Professional offre un couple de 55 Nm pour percer et visser sans effort dans le bois, le métal et la maçonnerie...La plupart des opérateurs Mirakl récupèrent les images par URL plutôt que par import direct : un hébergement d'images fiable est donc important. L'image principale demande en général un fond blanc, le produit occupant 75 à 85 % de la surface. Les images suivantes peuvent montrer des vues d'ambiance, de détail ou de comparaison de taille. Les opérateurs peuvent refuser automatiquement les images sous une résolution minimale ou avec du texte en surimpression détecté.
https://cdn.example.com/products/bosch-gsb-18v-21-main.jpgChaque catégorie d'opérateur définit un ensemble d'attributs structurés obligatoires et facultatifs. Exemples chez les opérateurs alimentaires : allergènes, ingrédients, déclaration nutritionnelle, pays d'origine, conditions de conservation. En bricolage : tension, couple, dimensions, matériaux. Avec l'enrichissement par AI activé, WISEPIM déduit les attributs obligatoires de la catégorie choisie à partir de ton contenu produit et les vérifie par rapport aux listes de valeurs autorisées de Mirakl.
Tension : 18V ; capacité de batterie : 2,0Ah ; mandrin : 13mm ; couple max. : 55Nm ; poids : 1,6kgLe prix et le stock se gèrent au niveau de l'offre (par vendeur et par produit). La plupart des opérateurs Mirakl acceptent les mises à jour de prix et de stock en temps réel par API ainsi que des imports CSV planifiés. Certains opérateurs imposent des règles de marge minimale ou vérifient la parité de prix avec leurs propres tarifs.
Prix : 129.99 ; stock : 47Flux produit Mirakl
Format du flux
JSON (Operator/Seller API), CSV/Excel (imports de fichiers), XML (legacy)
Comment envoyer tes données produit à cette marketplace
Mirakl propose des API REST complètes pour les workflows opérateur et vendeur. La Mirakl Operator API gère la reprise des catalogues, la gestion des catégories, la définition du schéma d'attributs, la validation des offres et l'orchestration des commandes. La Mirakl Seller API gère la création de produits, la gestion des offres, le traitement des commandes et le suivi de performance. Les vendeurs sans intégration API peuvent aussi, chez pratiquement tous les opérateurs, importer des fichiers CSV ou Excel via le portail vendeur Mirakl, mappés sur le schéma de l'opérateur.
Types de fichiers acceptés
Système de catégories de Mirakl
Chaque opérateur Mirakl définit sa propre arborescence de catégories. Il n'existe pas de 'taxonomie Mirakl' unique : les catégories de Decathlon diffèrent de celles de B&Q, qui diffèrent à leur tour de celles de Macy's. C'est voulu, car chaque opérateur structure son catalogue selon son modèle économique. Si tu vends sur plusieurs marketplaces Mirakl, tu dois donc refaire le rattachement des catégories pour chaque opérateur. C'est précisément là qu'un référentiel produit central, depuis lequel tu exportes vers chaque opérateur, fait gagner le plus de temps.
Conseils de mapping
Spécifications des données produit
Exigences précises pour les titres, descriptions, images et prix des produits
Titres et identifiants propres
Exigences
Bonnes pratiques
- Vérifie tes GTIN dans le registre GS1 GEPIR avant l'envoi pour éviter des refus en masse à l'import
- Utilise un rapprochement de produits assisté par AI pour savoir si une offre peut se rattacher à un produit existant du catalogue de l'opérateur (à privilégier) ou s'il faut créer un nouveau produit
- Génère des titres par opérateur avec des prompts propres à chaque canal : ce qui marche chez Decathlon peut dépasser la limite de caractères de B&Q
- Garde dans ton PIM un titre maître, adapté à l'export pour chaque opérateur
Rattachement aux catégories de l'opérateur
Exigences
Bonnes pratiques
- Prends le schéma de l'opérateur comme référence pour le rattachement, jamais des tableaux manuels à grande échelle
- Enregistre les rattachements existants par SKU et par opérateur pour ne pas les refaire à chaque mise à jour courante du catalogue
- Abonne-toi aux notifications de changement des opérateurs (quand elles existent) pour refaire tes rattachements avant des changements incompatibles
- Si tu vends à plusieurs opérateurs, garde une taxonomie interne de référence et rattache une fois par opérateur à l'export
Conformité et attributs réglementés
Exigences
Bonnes pratiques
- Vérifie chaque offre avec Quality Guard avant l'envoi : repérer des allergènes manquants ou des données CE invalides à l'import coûte moins cher qu'une suspension
- Gère les champs réglementés (allergènes, ingrédients, INCI, âges) à un seul endroit et diffuse-les de là vers chaque opérateur
- Suis les évolutions de conformité propres à chaque opérateur via Mirakl Connect ou les newsletters des opérateurs, et adapte tes prompts d'enrichissement quand les règles changent
Cycle de vie de l'offre (prix, stock, délai d'expédition)
Exigences
Bonnes pratiques
- Utilise la Mirakl Offer API pour des mises à jour de stock en temps réel plutôt que des imports CSV planifiés, quand ton volume le justifie
- Fixe des stocks de sécurité un peu sous ta disponibilité réelle pour absorber les variations dues aux commandes en cours
- Consulte chaque semaine la scorecard de performance Mirakl et corrige les baisses de SLA avant qu'elles ne mettent en danger la santé de ton compte
Refus de fiches produit fréquents sur Mirakl
Évite ces erreurs courantes qui font refuser tes fiches produit ou les masquent aux acheteurs
GTIN/EAN/UPC manquant ou invalide
Vérifie chaque identifiant produit dans le registre GS1 GEPIR (gepir.gs1.org) avant l'envoi. Achète tes identifiants directement auprès de GS1, car ceux de revendeurs tiers sont souvent refusés. Pour les marques propres ou les produits sans marque, enregistre un préfixe GS1 valide avant la mise en ligne.
Des attributs obligatoires de la catégorie manquent ou sont vides
Récupère avant l'envoi, via l'API Mirakl, la liste des attributs obligatoires de la catégorie cible de l'opérateur et vérifie que chaque offre a une valeur pour tous les champs obligatoires. Quality Guard dans WISEPIM t'aide à repérer les champs manquants avant l'export.
Le produit ne correspond à aucune entrée du catalogue existant et la création de nouveaux produits est restreinte
Certains opérateurs n'acceptent que des offres sur des produits du catalogue déjà validés. Si ton produit ne correspond pas, demande sa création via le processus de soumission de l'opérateur ou utilise un rapprochement assisté par AI pour trouver des correspondances proches que tu aurais manquées.
Les informations sur les allergènes ou les ingrédients sont incomplètes (opérateurs alimentaires)
Fais passer le texte des ingrédients de tes fournisseurs par une étape de détection des allergènes. Vérifie-le par rapport aux 14 allergènes majeurs du règlement INCO. Si des données manquent vraiment, ne soumets pas l'offre : les opérateurs refusent les offres alimentaires incomplètes à l'import.
L'image échoue au contrôle de résolution ou de qualité du fond
Vérifie que les images principales font au moins 1000x1000 pixels (2000x2000 recommandé), utilise un fond blanc pour les images principales et évite le texte en surimpression. Héberge les images sur un CDN fiable et vérifie avant l'envoi que les URL pointent vers le bon fichier.
Le titre contient des formulations ou une mise en forme interdites
Retire des titres les formules promotionnelles (Free Shipping, Best Seller), les mots tout en majuscules, les caractères spéciaux et la marque du vendeur. Régénère les titres par opérateur avec un prompt propre au canal qui respecte la limite de caractères et la convention de nommage de chaque opérateur.
Non-respect des listes de valeurs de l'opérateur (par exemple un nom de couleur inconnu)
Fais correspondre les valeurs en texte libre à la liste de valeurs fermée de l'opérateur. Chaque opérateur publie ses valeurs autorisées par attribut via l'API Mirakl. Synchronise-les régulièrement et vérifie tes offres par rapport à elles avant l'envoi.
Conseils d'optimisation des fiches produit sur Mirakl
Bonnes pratiques pour améliorer la visibilité et les ventes de tes fiches produit
Regroupe des données fournisseurs hétérogènes en un référentiel prêt pour Mirakl
Que tu reprennes en tant qu'opérateur les catalogues de vendeurs tiers ou que tu vendes en tant que vendeur sur plusieurs marketplaces Mirakl, la complexité des données est la même : chaque source livre ses informations produit dans un format différent. En tant que vendeur, tu regroupes ces données dans WISEPIM en un référentiel produit propre et structuré, tu complètes les manques par AI et tu exportes de là vers chaque opérateur. Tu évites ainsi la saisie manuelle qui dévore sinon une grande partie du temps d'une équipe opérations.
Traite chaque opérateur Mirakl comme un canal à part
B&Q, Decathlon, Macy's, Galeries Lafayette et Carrefour tournent tous sur Mirakl, mais chacun a sa propre taxonomie, son propre schéma d'attributs, ses propres règles de titre et ses propres consignes de contenu. Garde un référentiel produit interne unique et adapte-le à l'export pour chaque opérateur. Dans WISEPIM, chaque opérateur est une connexion Mirakl distincte avec sa propre arborescence de catégories.
Vérifie tout par rapport au schéma de l'opérateur avant l'import
Les opérateurs Mirakl refusent dès l'import les offres avec des attributs obligatoires manquants, des GTIN invalides ou des valeurs hors limites. Corriger ces erreurs après le refus fait perdre du temps et pèse sur ton score de performance chez l'opérateur. Vérifie chaque offre avant l'export, par exemple avec Quality Guard pour les champs manquants et avec l'enrichissement par AI, qui vérifie les attributs obligatoires par rapport aux listes de valeurs de Mirakl.
Opérateurs : investis dans un contrôle qualité automatisé sur tous les vendeurs
Quand tu lances une marketplace sur Mirakl, c'est surtout la qualité constante du contenu de tous les vendeurs tiers qui fait l'expérience client. Les files de contrôle manuelles ne passent pas à l'échelle. Utilise un scoring de la qualité du contenu assisté par AI pour piloter automatiquement la publication des offres : refuse les fiches incomplètes, harmonise les attributs contradictoires et ne publie que les offres qui atteignent ton niveau d'exigence.
Prépare tes données pour le commerce agentique
Les marketplaces Mirakl deviennent de plus en plus la cible d'agents d'achat AI (ChatGPT, Gemini, Perplexity). Les agents lisent des données structurées, pas des textes marketing : schema.org Product, GTIN, attributs complets. Les opérateurs et vendeurs en avance sur la qualité des données lisibles par machine seront surreprésentés dans la recherche de produits et les achats passés par des agents.
Suis les scorecards de performance Mirakl d'aussi près que celles d'Amazon
Chaque opérateur Mirakl publie des scorecards de performance vendeur : expédition à l'heure, suivi valide, taux d'acceptation des commandes et délai de réponse aux messages clients. Les vendeurs sous le seuil peuvent être déclassés dans la recherche de l'opérateur ou suspendus temporairement. Consulte chaque semaine les scorecards de chaque opérateur et corrige les baisses de SLA avant qu'elles ne mettent en danger la santé de ton compte.
Utilise Mirakl Connect pour travailler plus vite avec les opérateurs
Mirakl Connect est l'écosystème de Mirakl qui propose des intégrations prêtes à l'emploi entre vendeurs et opérateurs. Pour les vendeurs, Connect simplifie nettement la candidature et le lancement sur plusieurs marketplaces Mirakl. Pour les opérateurs, Connect offre un vivier sélectionné de partenaires vérifiés. Dans les deux cas, Connect raccourcit l'onboarding, qui domine sinon la première phase d'une stratégie marketplace.
Vendre sur Mirakl : avantages et inconvénients
Comment mettre tes produits en ligne sur Mirakl
Un guide étape par étape pour mettre tes produits en ligne sur cette marketplace
01
Repère les opérateurs Mirakl qui correspondent à ta stratégie
Détermine quelles marketplaces Mirakl t'intéressent. Dans le commerce britannique, ce sont souvent B&Q, Currys et des opérateurs spécialisés par catégorie. Pour toute l'UE s'ajoutent Decathlon, Galeries Lafayette, Carrefour et d'autres du même type. Chaque opérateur a ses propres conditions et sa propre base de vendeurs : choisis ceux qui correspondent à ta catégorie et à tes clients.
02
Candidate chez l'opérateur et obtiens tes identifiants API Mirakl
Pose ta candidature via le processus de recrutement des vendeurs de l'opérateur (souvent via Mirakl Connect chez les grands opérateurs). Une fois accepté, l'opérateur te délivre des identifiants API Mirakl pour ton compte vendeur sur sa marketplace. Chaque opérateur génère ses propres identifiants, qui ne valent pas chez les autres opérateurs.
03
Rattache ton catalogue à la taxonomie et au schéma d'attributs de l'opérateur
Récupère la taxonomie de catégories et le schéma d'attributs de l'opérateur via l'API Mirakl. Détermine pour chaque SKU la bonne catégorie feuille et vérifie que tous les attributs obligatoires sont remplis. À plus grande échelle, ce rattachement a sa place dans ton PIM plutôt que dans des tableaux manuels, car le rattachement manuel s'effondre bien avant 10 000 SKU.
04
Vérifie en amont par rapport aux règles de contenu de l'opérateur
Chaque opérateur impose ses propres règles de titre, exigences d'image, règles sur les allergènes (alimentaire), règles CE (électronique et bricolage) et listes de valeurs. Vérifie chaque offre avant l'export, par exemple avec Quality Guard et l'enrichissement par AI, qui vérifie les attributs obligatoires par rapport aux listes de valeurs de Mirakl. Repérer les erreurs avant l'import coûte bien moins cher qu'un refus suivi d'un nouvel essai.
05
Soumets tes offres et suis les indicateurs de performance Mirakl
Soumets tes offres via la Mirakl Offer API (mises à jour en temps réel) ou des imports CSV planifiés, selon ton volume. Consulte chaque semaine la scorecard de performance de chaque opérateur : expédition à l'heure, suivi valide, taux d'acceptation et délai de réponse aux messages clients. Corrige les baisses de SLA avant qu'elles ne mettent en danger la santé de ton compte. Utilise Mirakl Connect pour raccourcir l'onboarding chez d'autres opérateurs.
Playbook Mirakl pour opérateurs et vendeurs
Que tu lances une marketplace sur Mirakl (workflow opérateur) ou que tu vendes à plusieurs opérateurs Mirakl, ce guide couvre l'architecture des données, les schémas de qualité du contenu et l'enrichissement assisté par AI qui distinguent les leaders du reste.
- Checklist de lancement opérateur : onboarding des vendeurs tiers, mapping des attributs, SLA de qualité du contenu et workflows de validation des offres
- Playbook pour vendre chez plusieurs opérateurs : un catalogue de référence unique, rattaché à chaque opérateur Mirakl et diffusé canal par canal
- Cadre de scoring de la qualité du contenu qui écarte automatiquement les offres incomplètes ou non conformes avant publication
- Schémas d'enrichissement par AI pour transformer les données fournisseurs en Excel, PDF et texte libre en fiches propres, prêtes pour Mirakl
- Checklist du commerce agentique : comment faire apparaître tes fiches Mirakl dans les recommandations des agents AI
Questions fréquentes
Questions courantes sur la mise en ligne de produits sur Mirakl
Découvre d'autres guides marketplaces
Continue d'explorer
Une sélection d'étapes suivantes pour aller plus loin.
Prêt à vendre sur Mirakl ?
WISEPIM t'aide à gérer tes fiches produit sur plusieurs marketplaces depuis une seule plateforme centrale.