Guide Mirakl : paramètres et solutions

Mirakl est une entreprise qui fournit une plateforme pour les places de marché en ligne. Elle n’exploite pas sa propre marketplace ; elle fournit plutôt l’infrastructure sur laquelle différentes marketplaces peuvent être construites.

Les marketplaces construites sur la plateforme Mirakl partagent un cadre commun, ce qui signifie qu’elles présentent souvent des comportements, paramètres et problèmes similaires.

Ce guide explique comment dépanner les obstacles courants et présente les bonnes pratiques pour gérer une marketplace construite sur Mirakl avec Channable.

---

Nos marketplaces Mirakl prises en charge

Decathlon	Fnac	Blokker Connect !
Leroy Merlin	fonQ	Darty
Bricoman	Mediamarkt	Conforama
Carrefour France/Espagne	Manor	PcComponentes
Maxeda Brico&Praxis	Leen Bakker	ePrice
Douglas	Galeries Lafayette	Home24

Bonnes pratiques et paramètres pour Mirakl

Comment ajouter plusieurs valeurs d’attribut

Si vous devez saisir plusieurs valeurs pour un même champ d’attribut sur une marketplace Mirakl, séparez chaque valeur par le symbole pipe "|". Ce format permet à Mirakl de reconnaître et de traiter correctement chaque entrée séparée.

Erreurs Mirakl

Qu’est-ce que le mirakl_unknown_error_code et comment le résoudre ?

Une erreur que vous pouvez rencontrer est le mirakl_unknown_error_code. Cette erreur signifie un ensemble de problèmes qui surviennent généralement lorsqu’un EAN d’un produit n’est pas reconnu par la base de données Mirakl — ce qui indique que le produit est soit nouveau sur la marketplace, soit qu’il manque des attributs requis.

En bref : quelque chose d’exigé par la marketplace est manquant ou mal renseigné.

Bien que cela puisse sembler complexe, la solution implique souvent quelques étapes simples :

• Catégories: Assurez-vous que vos catégories de produits sont correctement mappées dans le Étape Catégories de votre API. Si ce n’est pas le cas, mappez-les correctement.

• La étape: Vérifiez que l’étape Build de votre API est configurée correctement. Par exemple, un champ EAN incorrect lié ici peut provoquer des erreurs. Corrigez tout désalignement.

• Attributs: Dans le Étape Attributs de l’API, liez chaque champ à son homologue correct et assurez-vous que les valeurs conviennent pour 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 constructeur d’attributs pour améliorer l’étape Attributs dans votre API.

Une fois les catégories et attributs renseignés dans votre API, rendez-vous dans l’aperçu des API et exécutez l’API en cliquant sur le bouton bleu « Exécuter » (Run now).

Erreur 1004 : La catégorie n'a pas pu être identifiée

L’erreur 1004 indique que des éléments sont envoyés avec un mapping de catégorie incorrect qui ne peut pas être associé aux catégories de la marketplace sur Mirakl. Cela est souvent causé par un mapping de catégorie manuel préexistant dans votre marketplace Mirakl.

Comment résoudre le problème :

Accédez à Settings dans la barre de gauche, puis cliquez sur « Settings » > « Catalog mapping ». Vous verrez le mapping. Le champ encadré en orange (Category) a peut‑être été ajouté manuellement. Sélectionnez le « category » encadré en orange et le mappage s’affichera sur la droite. Cliquez à nouveau sur « Category » (il est sûr de le supprimer car Channable ne l’a pas ajouté), puis cliquez sur « Remove mapping ». Après suppression du mapping manuel, retournez à l’API Mirakl dans Channable et exécutez l’API à nouveau. Cela rafraîchira les associations de catégories et devrait éliminer l’erreur de non‑correspondance de catégorie.

Obtenir le rapport d’erreurs Mirakl

Comme les marketplaces sont construites sur la plateforme Mirakl, l’obtention d’un rapport d’erreurs suit la même procédure pour toutes les marketplaces.

1. Connectez‑vous à votre compte Mirakl et allez à Catalogue > Importations de produits.

1. Trouvez les imports effectués par Channable et leurs horodatages. Cliquez sur le bouton « Voir les détails » pour l’import le plus récent.

1. Sélectionnez « 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, vous devrez peut‑être transformer/importer le fichier.

Après avoir téléchargé et converti le fichier, recherchez la colonne « Status » pour voir l/les erreur(s) spécifique(s) pour chaque article.

Quels sont les statuts dans Mirakl ?

Pour voir le statut des produits, rendez‑vous dans le Catalog Manager pour un aperçu de tous vos produits.

• Pour comprendre un statut global, cliquez sur le point d’interrogation (?) à côté du produit.

• Pour voir le méta‑statut (détaillé), ouvrez la page produit et cliquez sur (?).

• Utilisez les filtres du Catalog Manager pour afficher les statuts en masse.

Les produits sur la plateforme ont trois statuts principaux : Validation, Acceptation et Synchronisation. Les combinaisons de ces statuts produisent différents méta‑statuts.

Les statuts dans le Catalog Manager de Mirakl

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 donné. Plusieurs actions peuvent déclencher le recalcul du statut de validation d’un produit : - Après la reconstruction des fiches produit - lorsque vous modifiez la fiche produit source et que ces modifications sont répercutées dans la fiche produit maître - lorsque vous modifiez une fiche produit maître Tous les nouveaux produits obtiennent le statut de validation adapté 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 pour des problèmes de qualité des données. Vous devez mettre à jour vos produits avant que la marketplace n’examine à nouveau le produit. Vous pouvez voir la raison du rejet en survolant le point d’interrogation (?) avec votre souris.
	Vérification en cours	Il vous a été demandé de mettre à jour un ou plusieurs produits. Des modifications ont été apportées. Les marketplaces doivent maintenant décider d’accepter ou de rejeter le(s) produit(s).
	Accepté	Votre marketplace a accepté le produit.
	Rejeté	Votre marketplace a rejeté le produit. Vous pouvez voir la raison du rejet en survolant le point d’interrogation (?) avec votre souris.
Synchronisation	Synchronisé	Le produit est intégré dans la plateforme de la marketplace.
	Non synchronisé	Le produit n’est pas intégré dans la plateforme de la 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 visiter leur centre d’aide.