# 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.
:shop: 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 : 1. Des détails produit manquants, comme les attributs spécifiques à la catégorie. 2. Les informations produit sont encore en attente, affichées comme « Product - submission pending ». 3. 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é. [![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/IE9hp5pWJka6o7jGhIo3/19168742250514)](https://helpcenter.channable.com/hc/article_attachments/19168742250514) 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](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products) 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](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/commencer-avec-les-marketplaces/marketplaces-etape-build), 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 error` ou `Product - integration error`. **Comment corriger** 1. Dans l’ **Résultat** étape de votre canal marketplace Mirakl, allez dans le **Feedback** . 2. Examinez les autres erreurs liées aux produits déjà répertoriées. 3. Vérifiez les retours d’erreur dans la colonne **Erreur** . Si nécessaire, ajustez vos données à l’aide de [des règles](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). 4. Vérifiez et mappez les attributs marqués comme obligatoires dans l’ **Construire** étape. Vérifiez l’ :circle-info: icône et les info-bulles pour voir les valeurs acceptées. 5. 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](#how-to-download-a-non-integrated-products-report).
1000 : l’attribut obligatoire est vide Un attribut obligatoire pour cette marketplace n’a pas été mappé, ou contient une valeur vide. Comment corriger : 1. Dans l’ **Feedback** onglet dans l’ **Résultat** étape, cliquez sur l’erreur. 2. Cliquez sur l’ID lié dans la colonne **ID** . 3. Faites défiler pour voir les champs marqués **Mapping manquant pour \[insérez l’attribut]**. 4. Cliquez **Voir dans Construire**. Cela vous redirigera vers l’attribut concerné dans l’ **Construire** . 5. Mappez le champ manquant. Si vous n’avez pas de champ avec des valeurs acceptées, vous pouvez [créer un nouveau champ](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) et le remplir à l’aide de [des règles](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} 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’ :circle-info: icône pour obtenir plus d’informations/un exemple de valeurs acceptées. {% endhint %} 6. Cliquez **Sauvegarder**. 7. 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 :** 1. Dans l’ **Feedback** onglet dans l’ **Résultat** étape, cliquez sur l’erreur. 2. Cliquez sur l’ID lié dans la colonne **ID** . 3. Cliquez **Voir dans Construire**. Cela vous redirigera vers l’attribut concerné dans l’ **Construire** . 4. Mappez le champ manquant. Si vous n’avez pas de champ avec des valeurs acceptées, vous pouvez [créer un nouveau champ](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) et le remplir à l’aide de [des règles](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} 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’ :circle-info: icône pour obtenir plus d’informations/un exemple de valeurs acceptées. {% endhint %} 5. Cliquez **Sauvegarder**. 6. 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 :** 1. Dans l’ **Feedback** onglet dans l’ **Résultat** étape, cliquez sur l’erreur 2004. 2. Notez l’attribut concerné indiqué dans la colonne **Erreurs** et la limite de caractères. 3. Accédez à l’étape **Construire** étape et vérifiez quel champ vous avez mappé pour l’attribut concerné. {% hint style="success" %} 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’ :circle-info: icône pour obtenir plus d’informations/un exemple de valeurs acceptées. {% endhint %} 4. Accédez à l’étape **Règle** . 5. Créez une [règle de longueur maximale](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/how-to-use-actions-then-in-rules/rule-action-maximum-length) 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. 6. 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 :** 1. Dans l’ **Feedback** onglet dans l’ **Résultat** étape, cliquez sur l’erreur 2006. 2. Cliquez sur l’ID lié dans la colonne **ID** . 3. 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** . 4. Notez le champ que vous avez mappé pour l’attribut concerné. {% hint style="success" %} Conseil : pendant que vous êtes ici, examinez les autres erreurs restantes marquées comme **Requis par la marketplace** (indiqué par un point bleu). {% endhint %} 4. Cliquez sur le :circle-info: icône à côté de l’attribut concerné pour afficher les exemples et les valeurs possibles. 5. Utilisez [des règles](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) 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. 1. Si vous créez un nouveau champ de projet, veillez à le remapper dans l’ **Construire** étape vers ce nouveau champ. 6. 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 :** 1. Dans l’ **Feedback** onglet dans l’ **Résultat** étape, cliquez sur l’erreur 2007. 2. Cliquez sur l’ID lié dans la colonne **ID** . 3. 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** . 4. Notez le champ que vous avez mappé pour l’attribut concerné. {% hint style="success" %} Conseil : pendant que vous êtes ici, examinez les autres erreurs restantes marquées comme **Requis par la marketplace** (indiqué par un point bleu). {% endhint %} 4. Cliquez sur le :circle-info: icône à côté de l’attribut concerné pour afficher les exemples et les valeurs possibles. 5. Utilisez [des règles](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) 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. 1. Si vous créez un nouveau champ de projet, veillez à le remapper dans l’ **Construire** étape vers ce nouveau champ. 6. 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é.
:download: Comment télécharger un rapport des produits non intégrés {% hint style="info" %} 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. {% endhint %} 1. Connectez-vous à votre compte Mirakl. 2. Accédez à **Catalogue** > **Importations de produits**.
3. Dans la colonne File name, repérez quels articles ont été importés par Channable, ainsi que leurs horodatages. 4. Pour ces articles, cliquez sur **Voir les détails** pour afficher les informations d’import les plus récentes.
5. Cliquez **Télécharger** à côté de **Rapport des produits non intégrés** pour télécharger automatiquement le rapport d’erreurs.
{% hint style="info" %} **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. {% endhint %} 6. Ouvrez le fichier dans votre logiciel. 7. Vérifiez la colonne **Erreurs** pour voir l’erreur ou les erreurs spécifiques à chaque article. 8. 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.
### 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. 1. Dans votre back-office Mirakl, allez dans **Catalogue > Catalog Manager**. Vous verrez une vue d’ensemble de tous vos articles. 2. Dans l’ **Nouveautés** colonne, cliquez sur :circle-info: pour obtenir plus d’informations sur la signification d’un statut précis. 3. Pour afficher une description plus détaillée, ouvrez la page du produit et cliquez sur :circle-question:.
{% hint style="success" %} Conseil : utilisez les filtres pour afficher les statuts en masse. {% endhint %} 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](https://help.mirakl.net/bundle/sellers/page/topics/Mirakl/mcm/seller/mcm_statuses_provider.htm).