> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/places-de-marche-mirakl/guide-mirakl-parametres-et-solutions.md).

# Guide Mirakl : Paramètres et solutions

Apprenez comment A configurer les marketplaces Mirakl et résoudre les Erreurs courantes du canal.

Mirakl fournit la plateforme sur laquelle reposent de nombreuses marketplaces, donc ces marketplaces partagent souvent les Paramètres, le comportement et des Erreurs courantes.&#x20;

Utiliser cette page pour dépanner vos Canaux Mirakl et corriger les Erreurs de la **Feedback** onglet en rapport avec votre canal **Résultat** étape.

<details>

<summary><i class="fa-shop">:shop:</i> Marketplaces Mirakl en Channable</summary>

* 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

</details>

***

### Ajouter plusieurs valeurs A un attribut&#x20;

Si un attribut accepte plus d'une valeur, séparez les valeurs avec un pipe (`|`). Par exemple : `cotton|polyester`. Mirakl lit chaque valeur entre les pipes comme une entrée distincte.

### Erreurs courantes et Comment réparer

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Erreur</th><th>Ce que cela signifie</th><th>Comment réparer</th></tr></thead><tbody><tr><td><code>Offre - produit introuvable</code>, ou <code>mirakl_unknown_error_code</code></td><td>Le produit n'est pas encore reconnu par la base de données Mirakl.</td><td>Suivez <a href="#fix-product-not-found-errors">Corriger les Erreurs "product not found"</a>.</td></tr><tr><td><code>Produit - soumission en attente</code></td><td>La marketplace traite encore le produit.</td><td>Attendez, alors<a href="#download-the-non-integrated-products-report"> téléchargez un rapport des produits non intégrés</a> pour le Statut le plus récent.</td></tr><tr><td><code>Produit - Erreur de données</code>, ou <code>Produit - erreur d’intégration</code></td><td>La place de marché a rejeté les données du produit.</td><td>Vérifiez les autres erreurs du produit dans l’ <strong>Feedback</strong> onglet et corrigez-les d’abord.</td></tr><tr><td><code>1000 : l’attribut obligatoire est vide</code></td><td>Un attribut obligatoire n’est pas mappé, ou le champ mappé a une valeur vide.</td><td><a href="#fix-an-attribute-value-in-the-build-step">Mappez un champ qui contient des valeurs prises en charge.</a>.</td></tr><tr><td><code>1001 : catégorie inconnue fournie</code></td><td>La catégorie ne correspond pas à une catégorie de la place de marché, ou vous avez envoyé le libellé de la catégorie au lieu de son code.</td><td>Vérifiez que le format correspond à celui des places de marché ou vérifiez le code de catégorie de la place de marché.</td></tr><tr><td><code>1004 : catégorie inconnue fournie</code></td><td>Un mappage de catégorie dans votre compte Mirakl remplace le mappage dans Channable.</td><td>Suivez <a href="#remove-category-mapping-in-mirakl-error-1004">Supprimez le mappage de catégorie dans Mirakl</a>.</td></tr><tr><td><code>2004 : un attribut a une valeur trop longue</code></td><td>La valeur dépasse la limite de caractères de la place de marché.</td><td>Vérifiez les exigences de la place de marché et ajoutez une <a href="https://helpcenter.channable.com/manage-improve-product-data/manage-product-and-improve-data-fr/regles-modifier-et-enrichir-en-masse/how-to-use-actions-then-in-rules/actions-sur-le-texte/rule-action-maximum-length.md">règle de longueur maximale</a> au champ mappé.</td></tr><tr><td><code>2006 : un attribut a une valeur qui ne fait pas partie des valeurs autorisées</code></td><td>La valeur ne figure pas dans la liste des valeurs prises en charge de la place de marché.</td><td>Utilisez des règles pour modifier la valeur et la rendre prise en charge.</td></tr><tr><td><code>2007 : une valeur d’attribut ne correspond pas à une expression régulière</code></td><td><p>La valeur est dans le mauvais format. </p><p></p><p>Par exemple, Carrefour Espagne exige un EAN à 13 chiffres.</p></td><td>Utilisez des règles pour reformater la valeur.</td></tr></tbody></table>

#### Plus d’informations

<details>

<summary>Corriger les Erreurs "product not found"</summary>

**Produit introuvable** Les erreurs signifient que Channable a envoyé une offre pour un produit qui n’existe pas dans le catalogue de la place de marché.&#x20;

Dans l’ **Feedback** onglet, elles apparaissent souvent comme `Offre - produit introuvable` ou `mirakl_unknown_error_code`, avec le message « Le produit n’existe pas. »

Cela se produit généralement pour l’une des raisons suivantes :

* L’identifiant du produit est incorrect. Par exemple, `EAN` est mappé au mauvais champ.
* La place de marché est encore en train de traiter le produit. L’erreur s’affiche comme `Produit - soumission en attente`.
* La validation du produit a échoué, car des attributs obligatoires manquent ou sont invalides ; la place de marché ne l’a donc pas créé. L’erreur s’affiche comme `Produit - Erreur de données` ou `Produit - erreur d’intégration`.

Chaque place de marché a son propre catalogue. Un produit actif sur une place de marché Mirakl peut tout de même manquer sur une autre.

**Pour corriger l’erreur :**

1. Dans l’étape de votre canal, **Résultat** allez à l’ **Feedback** onglet.
2. Vérifiez si les mêmes produits présentent des erreurs d’attribut, telles que `1000` ou `2006`. Si c’est le cas, corrigez-les d’abord. Voir [**Corrigez une valeur d’attribut dans l’étape Build** étape](#fix-an-attribute-value-in-the-build-step).
3. Dans l’ **Build** étape, vérifiez que le **EAN** attribut est mappé au champ qui contient vos EAN.
4. Dans l’ **Catégorie** étape, vérifiez que vos Catégories sont mappées aux catégories de la marketplace, et que les attributs de ces catégories sont renseignés dans le **Attributs par catégorie** onglet dans le **Build** étape.
5. Cliquez sur **Exécuter**.
6. Si l'erreur devient `Produit - soumission en attente`, attendez que la marketplace traite le produit. Pour obtenir le dernier statut, [**téléchargez un rapport des produits non intégrés**](#download-the-non-integrated-products-report).

Si vous ne pouvez pas fournir un attribut requis, contactez la marketplace. Celle-ci peut approuver un produit même lorsque certains attributs requis sont manquants.

</details>

<details>

<summary>Corrigez une valeur d'attribut dans l'étape Construire</summary>

Suivez ces étapes pour les erreurs suivantes :  `1000`, `1001`, `2004`, `2006`, et `2007`.

1. Dans l’étape de votre canal, **Résultat** allez à l’ **Feedback** onglet, puis cliquez sur l'erreur.
2. Dans l’ **ID** colonne, cliquez sur un ID produit.
3. Faites défiler et trouvez l'attribut marqué **Mapping manquant pour "\[attribute]"** ou **Valeur invalide pour "\[attribute]"**, puis cliquez sur **Voir dans Construire**.&#x20;
   1. Pour les erreurs 2004, notez la limite de caractères indiquée dans la **Erreurs** colonne.
4. À côté de l'attribut, cliquez sur l'icône d'information pour voir **Exemple** et **Valeurs possibles**.
5. Corrigez le champ mappé :
   * Si l'attribut n'est pas mappé, mappez un champ qui contient des valeurs acceptées.
   * Si la valeur n'est pas acceptée, utilisez des règles pour la transformer en une valeur acceptée. Pour les Catégories, utilisez le code de Catégorie, pas le Libellé.
   * Si la valeur est trop longue, ajoutez une règle de longueur maximale au champ mappé.
   * Si la valeur est au mauvais format, utilisez des règles pour la reformater.
6. Si vous n'avez pas de champ avec des valeurs prises en charge, [créez un nouveau champ, renseignez-le à l'aide de règles et mappez-le à l'attribut](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/publier-sur-les-canaux/renseigner-les-donnees-dattributs-manquantes.md) dans le **Build** étape.
7. Cliquez sur **Sauvegarder**.
8. Cliquez sur **Exécuter**.

{% hint style="info" %}

#### Remarque

Pendant que vous êtes dans l' **Build** étape, vérifiez les autres attributs marqués **Requis par la marketplace** (point bleu) et mappez-les.
{% endhint %}

</details>

<details>

<summary>Supprimer le mapping de Catégorie dans Mirakl (erreur 1004)</summary>

Erreur `1004` signifie qu'un mapping de Catégorie dans votre compte Mirakl remplace le mapping de catégorie dans Channable. Supprimez le mapping Mirakl afin que les Catégories de Channable s'appliquent.&#x20;

1. Dans votre compte Mirakl, allez dans **Paramètres > Mapping du catalogue**.
2. Sous **Ma structure de catalogue**, cliquez sur **Racine**, puis cliquez sur **Catégorie**.
3. Cliquez sur **Catégorie** de nouveau, puis cliquez sur **Supprimer le Mapping**.
4. Dans Channable, ouvrez votre canal et cliquez **Exécuter**.

</details>

### Télécharger les rapports d'Erreurs Mirakl <a href="#download-mirakl-error-reports" id="download-mirakl-error-reports"></a>

Les rapports de Mirakl indiquent ce que la marketplace a rejeté ou examine encore. Vous pouvez utiliser les rapports pour analyser différentes Erreurs. Vous les trouverez dans votre Compte Mirakl sous **Catalogue > Importations de produits**.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Rapport</th><th>Ce qu’il affiche</th><th>À utiliser quand</th></tr></thead><tbody><tr><td>Rapport des produits non intégrés <mark style="color:$info;">(Recommandé)</mark></td><td>Produits que la place de marché a rejetés ou qu’elle examine encore après avoir traité votre importation.</td><td>Votre canal a bien été exécuté, mais les produits affichent <code>Produit - soumission en attente</code> ou des erreurs de données.</td></tr><tr><td>Rapport d'erreurs du fichier target</td><td>Problèmes liés au contenu ou au format du fichier d'import. Correspond au Feedback dans Channable.</td><td>Vous souhaitez le même Feedback en dehors de Channable.</td></tr><tr><td>Rapport des produits ajoutés</td><td>Produits que la place de marché a intégrés avec succès.</td><td>Vous souhaitez A confirmer quels produits sont en ligne.</td></tr></tbody></table>

<details>

<summary><i class="fa-download">:download:</i> Télécharger le rapport des produits non intégrés</summary>

{% hint style="info" %}
Mirakl peut prendre plusieurs jours A générer ce rapport. Si c'est urgent, contactez l'assistance Mirakl.
{% endhint %}

1. Connectez-vous en A votre Compte Mirakl.
2. Aller A **Catalogue > Importations de produits**.
3. Trouvez les fichiers d'importation envoyés par Channable. Leurs noms commencent par `channable_Créer_update_`.
4. A côté du fichier le plus récent, cliquez **Voir les détails**.
5. À côté A **Rapport des produits non intégrés**, cliquez sur **Télécharger**.

<figure><img src="https://4114378255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FfC22oIB7wjoXwQkYyZMK%2Fimage.png?alt=media&amp;token=8ea429d0-3f5e-458d-abd0-616875e5108a" alt=""><figcaption></figcaption></figure>

6. Ouvrez le fichier CSV. si vous devez utiliser Microsoft Excel ou Google Sheets, vous devrez peut-être importer le fichier A la place de l'ouvrir.
7. Dans l’ **Erreurs** colonne, lisez l'erreur pour chaque produit.
8. Corrigez les Erreurs en Channable, alors cliquez **Exécuter**.

{% hint style="warning" %}
La marketplace rédige ces descriptions d'erreur. si l'une n'est pas claire, contactez la marketplace au lieu de Mirakl ou Channable.
{% endhint %}

</details>

### Vérifiez le Statut du produit en Mirakl <a href="#check-product-status-in-mirakl" id="check-product-status-in-mirakl"></a>

Chaque produit en Mirakl a un Statut de validation, un Statut d'acceptation et un Statut de synchronisation. Vérifiez Tous les éléments A voir où un produit est bloqué.

1. Dans votre compte Mirakl, allez dans **Catalogue > Gestionnaire de catalogue**.
2. Dans l’ **Statut du produit** colonne, cliquez <i class="fa-circle-info">:circle-info:</i> Juste A côté d'un Statut A voir ce que cela signifie.&#x20;
3. Pour obtenir un statut détaillé, ouvrez la page produit et cliquez <i class="fa-circle-question">:circle-question:</i>.

{% hint style="warning" icon="lightbulb" %}
A voir les statuts en masse, utiliser les filtres, comme **Statut du produit**.

<img src="https://4114378255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FHrIY9o1Y0Tx5zcOKVLOK%2Fimage.png?alt=media&amp;token=fc756c34-cadb-4fdd-81b1-f19615b020ab" alt="" data-size="original">
{% endhint %}

| Statut          | Statut méta                | Ce que cela signifie                                                                                                                                                                                                                                        |
| --------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Validation      | Données valides            | Les données produit répondent aux exigences de la marketplace.                                                                                                                                                                                              |
| Validation      | Données invalides          | Les données produit ne répondent pas aux exigences de la marketplace.                                                                                                                                                                                       |
| Validation      | Média en attente           | Mirakl n'a pas encore traité les images, les vidéos ou les documents du produit.                                                                                                                                                                            |
| Validation      | Non calculé                | La place de marché a activé la validation des données, mais Mirakl n'a pas encore recalculé le Statut de ce produit. Mirakl le recalcule lorsque les fiches de données du produit sont reconstruites ou lorsque les données du produit changent.            |
| Acceptation     | Nouveau                    | Le produit est nouveau. La place de marché doit l'accepter ou le rejeter.                                                                                                                                                                                   |
| Acceptation     | Modifications requises     | La place de marché a rejeté le produit en raison de problèmes de qualité des données. Mettez à jour le produit pour que la place de marché puisse l'examiner de nouveau. Pour voir la raison, survolez <i class="fa-circle-question">:circle-question:</i>. |
| Acceptation     | En attente de vérification | Vous avez modifié les données produit envoyées en quelque sorte. La place de marché doit maintenant décider A accepter ou rejeter vos modifications.                                                                                                        |
| Acceptation     | Accepté                    | La place de marché a accepté le produit.                                                                                                                                                                                                                    |
| Acceptation     | Rejeté                     | La place de marché a rejeté le produit. Pour voir la raison, survolez <i class="fa-circle-question">:circle-question:</i>.                                                                                                                                  |
| Synchronisation | Synchronisé                | Le produit est intégré à la place de marché.                                                                                                                                                                                                                |
| Synchronisation | Non synchronisé            | Le produit n'est pas intégré à la place de marché.                                                                                                                                                                                                          |
| Synchronisation | Erreur de synchronisation  | Une erreur s'est produite lors de l'intégration du produit.                                                                                                                                                                                                 |

{% hint style="warning" %}

#### L'acceptation est distincte de la validation.&#x20;

La place de marché examine les produits en son propre flux de travail, si bien qu'un Produit peut avoir **Données valides** et continuer à afficher **Nouveau** ou **Modifications requises**.&#x20;

Si le Statut d'acceptation ne change pas après avoir corrigé les données, contactez la place de marché.
{% endhint %}

Pour en savoir plus sur ces statuts, consultez [Centre d'Aide de Mirakl](https://help.mirakl.net/bundle/sellers/page/topics/Mirakl/mcm/seller/mcm_statuses_provider.htm).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/places-de-marche-mirakl/guide-mirakl-parametres-et-solutions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
