Mirakl : Résolutions d'erreurs

Mirakl est une entreprise qui offre une plateforme permettant d'accéder à diverses marketplaces. Mirakl n'exploite donc pas sa propre marketplace, mais fournit l'infrastructure sur laquelle diverses marketplaces peuvent être intégrées.

Par conséquent, les marketplaces construites sur la plateforme Mirakl partagent un cadre commun, ce qui signifie qu'elles présentent souvent des fonctionnalités similaires et, occasionnellement, peuvent rencontrer des problèmes similaires.

C'est pour cela que nous avons créé ce guide. Dans celui-ci, nous allons nous pencher sur la façon dont vous pouvez résoudre les difficultés que vous pourriez rencontrer avec vos produits lorsque vous intégrer une marketplace sur Mirakl avec Channable.

Dans cet article, nous aborderons les sujets suivants :

1. Les marketplaces Mirakl que nous proposons actuellement
2. Les bonnes pratiques et paramètres pour Mirakl
3. Les erreurs Mirakl
4. Obtenir le rapport d'erreur de Mirakl
5. Quels sont les statuts dans Mirakl ?
6. Les statuts dans Mirakl Catalog Manager

Les marketplaces Mirakl que nous proposons actuellement

Bien que cela puisse sembler problématique, la solution passe souvent par quelques étapes simples.

1. Catégories
   Commencez par vous assurer que vos catégories correspondent bien à vos produits à l'étape Catégories de votre API. Si ce n'est pas le cas, prenez le temps de les mettre en correspondance. Pour obtenir des instructions détaillées sur les catégories, vous pouvez consulter cet article.
2. Construire
   Ensuite, vérifiez que l'étape de construction de votre API est correctement configurée. Par exemple, si un champ EAN incorrect a été associé, cela peut entraîner des erreurs. Procédez aux ajustements nécessaires pour corriger les éventuelles incohérences.
3. Attributs
   A l'étape Attributs, il est essentiel d'indiquer une valeur pour chaque champ obligatoire et de s'assurer que les valeurs correspondent à la catégorie sélectionnée. Pour mieux comprendre la gestion des attributs, consultez cet article sur la construction des attributs. 
4. Règles
   Utilisez des règles pour affiner vos données. Consultez cet article de notre Centre d'aide pour obtenir quelques exemples de règles courantes.

Si vous avez rempli toutes les catégories et attributs de votre API, allez maintenant sur la vue d'ensemble des APIs et cliquez sur le bouton bleu "Exécuter".

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

Si vous recevez l'erreur 1004 dans votre API Mirakl, cela signifie que vous rencontrez des problèmes avec des produits envoyés ayant des catégories incorrectes. Celles-ci ne peuvent donc pas correspondre aux catégories de la marketplace sur la plateforme Mirakl.

La cause la plus probable de ce problème est une association manuelle préexistante des catégories dans votre marketplace Mirakl. Cette association préexistante peut avoir été ajoutée manuellement et doit être corrigée pour résoudre cette erreur.

Comment résoudre le problème :

1. Naviguez vers les paramètres dans la barre de gauche, et cliquez sur "Settings" > "Catalog mapping".

2. Une fois que vous y êtes, vous voyez la correspondance ci-dessous, le champ entouré en orange (Category) est placé manuellement à cet endroit.

3. Sélectionnez la catégorie encadrée en orange et les catégories s'afficheront à droite de l'écran.

4. Cliquez à nouveau sur "Category", vous pouvez la supprimer en toute sécurité car cela ne vient pas de Channable. Cliquez ensuite sur le bouton "Remove mapping".

5. Une fois le mapping supprimé, retournez dans l'API Mirakl sur Channable et exécutez la à nouveau.

Cette action aura pour effet de renouveler les associations de catégories et devrait éliminer l'erreur liée à la non-concordance des catégories.

Obtenir le rapport d'erreur de Mirakl

Les marketplaces étant construites sur la même plateforme Mirakl, l'obtention d'un rapport d'erreur suit la même procédure. Voici comment y accéder :

Connectez-vous à votre compte Mirakl et rendez vous dans la rubrique "Catalog" > "Product imports".

Sur cette page, vous trouverez une liste des imports qui ont été effectués par Channable, ainsi que la date et l'heure de l'import.

Pour obtenir les détails les plus récents et les plus précis des erreurs pour vos produits, cliquez sur le bouton "See details" de l'import le plus récent.

Parmi les options proposées, sélectionnez "Non-integrated products report" pour afficher le rapport d'erreur. Le rapport sera automatiquement téléchargé.

Après avoir téléchargé et correctement transformé le fichier, faites défiler la partie droite de votre écran pour trouver l'onglet "Status". Cette section affiche la ou les erreurs spécifiques associées à chaque produit.

Quels sont les statuts dans Mirakl ?

Pour connaître le statut de votre produit, vous pouvez vous rendre sur la rubrique Catalog Manager. Vous y trouverez un aperçu de tous vos produits.

Pour comprendre ce que représente un statut, cliquez sur le point d'interrogation (?) situé à côté ou visitez la page du produit et cliquez sur le (?) pour obtenir une explication.

Les options de filtrage du gestionnaire de catalogue sont très utiles pour visualiser les statuts en masse. Ces filtres peuvent être combinés pour se concentrer sur un ensemble spécifique de produits.

Les produits sur la plateforme sont classés selon trois statuts principaux : "Validation", "Acceptance" et "Synchronization". La combinaison de ces statuts crée divers "méta-statuts", qui sont visibles par les utilisateurs.

Voici un aperçu des statuts et méta-statuts utilisés par Mirakl sur sa plateforme.

Les statuts dans Mirakl Catalog Manager