Guide Mirakl : paramètres et solutions
Mirakl n’exploite pas sa propre marketplace. Il fournit à la place l’infrastructure que d’autres utilisent pour créer et gérer la leur.
Comme de nombreuses marketplaces Mirakl utilisent la même configuration, elles ont souvent des paramètres, un comportement et des problèmes courants similaires.
Marketplaces Mirakl dans Channable
Decathlon
Fnac
Leroy Merlin
fonQ
Darty
Bricoman
Mediamarkt
Conforama
Carrefour France/Espagne
Manor
PcComponentes
Maxeda Brico&Praxis
Leen Bakker
ePrice
Douglas
Galeries Lafayette
Home24
Sprinter
Showroomprive
Hornbach
Conrad
Vtwonen
Galeries Lafayette
Qu’est-ce que l’erreur mirakl_unknown_error_code et comment la résoudre ?
Lorsque cette erreur se produit, cela signifie que le produit n’est pas reconnu par Mirakl. Les raisons possibles incluent :
Des détails produit manquants, comme les attributs spécifiques à la catégorie.
Les informations produit sont encore en attente, affichées comme « Product - submission pending ».
Des erreurs dans les données envoyées, indiquées par « Product - data error » ou « Product - integration error ».
En bref : il manque quelque chose d’obligatoire pour la Marketplace, ou ce n’est pas correctement renseigné.
Même si cela peut sembler complexe, la समाधान consiste souvent en quelques étapes simples :
Catégories: Vérifiez que vos catégories de produits sont correctement associées dans l’ étape Categories de votre API. Si ce n’est pas le cas, mappez-les correctement.
Construire: Vérifiez que l’étape Build de votre API est correctement configurée. Par exemple, un champ EAN incorrect associé ici peut provoquer des erreurs. Corrigez toute incohérence.
Attributs: Dans l’ étape Attributes de l’API, associez chaque champ à son équivalent correct et assurez-vous que les valeurs conviennent à la catégorie sélectionnée.
Règles: Utilisez des règles pour affiner davantage vos données. Consultez l’article d’aide sur le générateur d’attributs pour améliorer l’étape Attributes de votre API.
Une fois les catégories et les attributs renseignés dans votre API, allez dans la vue d’ensemble des API et exécutez l’API en cliquant sur le bouton bleu « Run now ».
Bonnes pratiques et paramètres pour Mirakl
Ajouter plusieurs valeurs d’attribut
Si vous devez saisir plusieurs valeurs pour un seul champ d’attribut dans une Marketplace Mirakl, séparez chaque valeur avec le symbole pipe « | ». Ce format garantit que Mirakl reconnaît et traite correctement chaque entrée distincte.
Erreurs Mirakl courantes et comment les résoudre
Offre - produit introuvable
Cette erreur se produit lorsque l’EAN d’un produit n’est pas reconnu par la base de données Mirakl.
Cela se produit généralement lorsque :
Le produit est encore en cours de traitement par Mirakl (affiché comme
Product - submission pending).L’import du produit a échoué en raison de données obligatoires manquantes ou invalides (par exemple, des attributs spécifiques à la catégorie). Cela s’affiche généralement comme
Product - data errorouProduct - integration error.
Comment corriger
Dans l’ Résultat étape de votre canal marketplace Mirakl, allez dans le Feedback .
Examinez les autres erreurs liées aux produits déjà répertoriées.
Vérifiez les retours d’erreur dans la colonne Erreur . Si nécessaire, ajustez vos données à l’aide de des règles.
Vérifiez et mappez les attributs marqués comme obligatoires dans l’ Construire étape. Vérifiez l’ icône et les info-bulles pour voir les valeurs acceptées.
Cliquez Exécuter pour relancer votre canal.
Product - submission pending
Cette erreur se produit lorsque la marketplace traite encore les informations de votre produit.
Pour obtenir les informations d’état les plus récentes, téléchargez un rapport des produits non intégrés dans Mirakl.
1000 : l’attribut obligatoire est vide
Un attribut obligatoire pour cette marketplace n’a pas été mappé, ou contient une valeur vide.
Comment corriger :
Dans l’ Feedback onglet dans l’ Résultat étape, cliquez sur l’erreur.
Cliquez sur l’ID lié dans la colonne ID .
Faites défiler pour voir les champs marqués Mapping manquant pour [insérez l’attribut].
Cliquez Voir dans Construire. Cela vous redirigera vers l’attribut concerné dans l’ Construire .
Mappez le champ manquant. Si vous n’avez pas de champ avec des valeurs acceptées, vous pouvez créer un nouveau champ et le remplir à l’aide de des règles.
Conseil : pendant que vous êtes ici, examinez les autres erreurs restantes marquées comme Requis par la marketplace (indiqué par un point bleu). Cliquez sur l’ icône pour obtenir plus d’informations/un exemple de valeurs acceptées.
Cliquez Sauvegarder.
Cliquez Exécuter.
1001 : catégorie inconnue fournie
La valeur de catégorie fournie ne correspond pas à une catégorie de la marketplace, ou un libellé a été fourni à la place du code.
Comment corriger :
Dans l’ Feedback onglet dans l’ Résultat étape, cliquez sur l’erreur.
Cliquez sur l’ID lié dans la colonne ID .
Cliquez Voir dans Construire. Cela vous redirigera vers l’attribut concerné dans l’ Construire .
Mappez le champ manquant. Si vous n’avez pas de champ avec des valeurs acceptées, vous pouvez créer un nouveau champ et le remplir à l’aide de des règles.
Conseil : pendant que vous êtes ici, examinez les autres erreurs restantes marquées comme Requis par la marketplace (indiqué par un point bleu). Cliquez sur l’ icône pour obtenir plus d’informations/un exemple de valeurs acceptées.
Cliquez Sauvegarder.
Cliquez Exécuter.
2004 : un attribut contient une valeur trop longue
Le champ mappé pour cet attribut doit être inférieur à la limite de caractères spécifiée.
Comment corriger :
Dans l’ Feedback onglet dans l’ Résultat étape, cliquez sur l’erreur 2004.
Notez l’attribut concerné indiqué dans la colonne Erreurs et la limite de caractères.
Accédez à l’étape Construire étape et vérifiez quel champ vous avez mappé pour l’attribut concerné.
Conseil : pendant que vous êtes ici, examinez les autres erreurs restantes marquées comme Requis par la marketplace (indiqué par un point bleu). Cliquez sur l’ icône pour obtenir plus d’informations/un exemple de valeurs acceptées.
Accédez à l’étape Règle .
Créez une règle de longueur maximale sur le champ que vous utilisez afin de vous assurer qu’il respecte la limite de caractères. N’oubliez pas de cliquer sur Sauvegarder pour appliquer les modifications.
Cliquez Exécuter.
2006 : un attribut contient une valeur qui ne fait pas partie des valeurs autorisées
Cette erreur se produit lorsque le champ que vous avez mappé contient une valeur qui n’est pas acceptée.
Comment corriger :
Dans l’ Feedback onglet dans l’ Résultat étape, cliquez sur l’erreur 2006.
Cliquez sur l’ID lié dans la colonne ID .
Faites défiler pour voir les champs marqués Valeur non valide pour [nom de l’attribut]. À côté, cliquez sur Voir dans Construire. Cela vous redirigera vers l’attribut concerné dans l’ Construire .
Notez le champ que vous avez mappé pour l’attribut concerné.
Conseil : pendant que vous êtes ici, examinez les autres erreurs restantes marquées comme Requis par la marketplace (indiqué par un point bleu).
Cliquez sur le icône à côté de l’attribut concerné pour afficher les exemples et les valeurs possibles.
Utilisez des règles pour mettre à jour ou créer un nouveau champ de projet avec les valeurs acceptées. N’oubliez pas de cliquer sur Sauvegarder pour appliquer les modifications.
Si vous créez un nouveau champ de projet, veillez à le remapper dans l’ Construire étape vers ce nouveau champ.
Cliquez Exécuter.
2007 : une valeur d’attribut ne correspond pas à une expression régulière
Cette erreur se produit si la valeur de l’attribut n’est pas au format attendu.
Comment corriger :
Dans l’ Feedback onglet dans l’ Résultat étape, cliquez sur l’erreur 2007.
Cliquez sur l’ID lié dans la colonne ID .
Faites défiler pour voir les champs marqués Valeur non valide pour [nom de l’attribut]. À côté, cliquez sur Voir dans Construire. Cela vous redirigera vers l’attribut concerné dans l’ Construire .
Notez le champ que vous avez mappé pour l’attribut concerné.
Conseil : pendant que vous êtes ici, examinez les autres erreurs restantes marquées comme Requis par la marketplace (indiqué par un point bleu).
Cliquez sur le icône à côté de l’attribut concerné pour afficher les exemples et les valeurs possibles.
Utilisez des règles pour mettre à jour ou créer un nouveau champ de projet avec les valeurs acceptées. N’oubliez pas de cliquer sur Sauvegarder pour appliquer les modifications.
Si vous créez un nouveau champ de projet, veillez à le remapper dans l’ Construire étape vers ce nouveau champ.
Cliquez Exécuter.
Rapports d’erreurs Mirakl
Vous pouvez télécharger différents rapports d’erreurs dans Mirakl pour analyser différents problèmes. Vous les trouverez tous dans Catalogue > Importations de produits.
Rapport d’erreurs du fichier source : Indique ce qui ne va pas dans votre fichier source ou dans son format. Les données affichées montreront exactement les mêmes retours que ceux qui apparaissent dans votre canal marketplace dans Channable.
Rapport des produits non intégrés (recommandé) : Indique ce que la marketplace a rejeté ou est en train de vérifier après le traitement de votre envoi.
À utiliser lorsque : Vous avez exécuté votre canal avec succès, mais vous voyez des erreurs « Product - submission pending ».
Rapport des produits ajoutés : Confirme quels produits/lignes ont été intégrés avec succès
À utiliser lorsque : Vous souhaitez une preuve de ce qui est en ligne, ou rapprocher ce qui a été créé de ce qui a été envoyé.
Vérifier le statut des produits dans Mirakl
Les produits sur la plateforme ont trois statuts principaux :
Validation
Acceptation
Synchronisation
Des combinaisons de ces statuts produisent différents méta-statuts.
Dans votre back-office Mirakl, allez dans Catalogue > Catalog Manager. Vous verrez une vue d’ensemble de tous vos articles.
Dans l’ Nouveautés colonne, cliquez sur pour obtenir plus d’informations sur la signification d’un statut précis.
Pour afficher une description plus détaillée, ouvrez la page du produit et cliquez sur .
Conseil : utilisez les filtres pour afficher les statuts en masse.
Les produits sur la plateforme ont trois statuts principaux : Validation, Acceptation et Synchronisation. Des combinaisons de ces statuts produisent différents méta-statuts.
Statuts du Mirakl Catalog Manager
Statut
Méta-statut
Description
Validation
Données valides
Les données produit sont conformes aux exigences de la Marketplace.
Données invalides
Les données produit ne sont pas conformes aux exigences de la Marketplace.
Médias en attente
Les médias (images, vidéos, documents) des données produit ne sont pas encore traités par la plateforme Mirakl.
Non calculé
Lorsque la Marketplace active la validation des données produit pour un canal, les statuts de validation des produits ne sont pas recalculés automatiquement. Dans ce cas, ces produits obtiennent le statut « Non calculé » pour le canal concerné. Plusieurs actions peuvent déclencher le recalcul du statut de validation d’un produit : - Après la reconstruction des fiches de données produit - lorsque vous modifiez la fiche de données produit source et que ces modifications sont répercutées dans la fiche de données produit principale - lorsque vous modifiez une fiche de données produit principale Tous les nouveaux produits obtiennent le statut de validation approprié pour chaque canal activé.
Acceptation
Nouveau
Le produit est nouveau, et la Marketplace doit l’accepter ou le rejeter.
Modifications requises
Votre Marketplace a rejeté le produit en raison de problèmes de qualité des données. Vous devez mettre à jour vos produits avant que votre Marketplace n’examine à nouveau le produit. Vous pouvez consulter la raison du rejet en survolant le point d’interrogation (?)
En attente de vérification
Il vous a été demandé de mettre à jour un ou plusieurs produits. Des modifications ont été effectuées. Les marketplaces doivent maintenant décider d’accepter ou de rejeter le ou les produits.
Accepté
Votre Marketplace a accepté le produit.
Rejeté
Votre Marketplace a rejeté le produit. Vous pouvez consulter la raison du rejet en survolant le point d’interrogation (?)
Synchronisation
Synchronisé
Le produit est intégré à la plateforme Marketplace.
Non synchronisé
Le produit n’est pas intégré à la plateforme Marketplace.
Erreur de synchronisation
Une erreur s’est produite lors de l’intégration du produit.
Pour plus d’informations sur les statuts Mirakl, vous pouvez consulter leur centre d’aide.
Mis à jour
Ce contenu vous a-t-il été utile ?
Comment télécharger un rapport des produits non intégrés
Remarque : il s’agit d’un rapport détaillé que Mirakl peut mettre plusieurs jours à générer. Pour les cas urgents, contactez l’équipe d’assistance de Mirakl.
Connectez-vous à votre compte Mirakl.
Accédez à Catalogue > Importations de produits.
Dans la colonne File name, repérez quels articles ont été importés par Channable, ainsi que leurs horodatages.
Pour ces articles, cliquez sur Voir les détails pour afficher les informations d’import les plus récentes.
Cliquez Télécharger à côté de Rapport des produits non intégrés pour télécharger automatiquement le rapport d’erreurs.
Remarque : Le fichier est au format CSV. Si vous utilisez Microsoft Excel ou Google Sheets, vous devrez peut-être transformer/importer le fichier pour l’afficher.
Ouvrez le fichier dans votre logiciel.
Vérifiez la colonne Erreurs pour voir l’erreur ou les erreurs spécifiques à chaque article.
Corrigez ce que vous pouvez en vous basant sur la description de l’erreur. Mirakl reçoit ce retour de la marketplace.
Si vous ne savez pas ce que signifie la description, contactez la marketplace pour obtenir plus d’informations.