> 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/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-solutions.md).

# Mirakl guide: Settings and solutions

Learn how to configure Mirakl marketplaces and resolve common channel errors.

Mirakl provides the platform that many marketplaces run on, so these marketplaces often share settings, behavior, and common errors.&#x20;

Use this page to troubleshoot your Mirakl channels and fix errors from the **Feedback** tab in your channel's **Result** step.

<details>

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

* Decathlon
* Fnac
* Leroy Merlin
* fonQ
* Darty
* Bricoman
* Mediamarkt
* Conforama
* Carrefour France/Spain
* Manor
* PcComponentes
* Maxeda Brico\&Praxis
* Leen Bakker
* ePrice
* Douglas
* Galeries Lafayette
* Home24
* Sprinter
* Showroomprive
* Hornbach
* Conrad
* Vtwonen
* Galeries Lafayette

</details>

***

### Add multiple values to one attribute&#x20;

If an attribute accepts more than one value, separate the values with a pipe (`|`). For example: `cotton|polyester`. Mirakl reads each value between pipes as a separate entry.

### Common errors and how to fix them

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Error</th><th>What it means</th><th>How to fix</th></tr></thead><tbody><tr><td><code>Offer - product not found</code>, or <code>mirakl_unknown_error_code</code></td><td>The product isn't recognized by the Mirakl database yet.</td><td>Follow <a href="#fix-product-not-found-errors">Fix "product not found" errors</a>.</td></tr><tr><td><code>Product - submission pending</code></td><td>The marketplace is still processing the product.</td><td>Wait, then<a href="#download-the-non-integrated-products-report"> download a non-integrated products report</a> for the latest status.</td></tr><tr><td><code>Product - data error</code>, or <code>Product - integration error</code></td><td>The marketplace rejected the product data.</td><td>Check the product's other errors in the <strong>Feedback</strong> tab and fix those first.</td></tr><tr><td><code>1000: Required attribute is empty</code></td><td>A required attribute isn't mapped, or the mapped field has an empty value.</td><td><a href="#fix-an-attribute-value-in-the-build-step">Map a field that has supported values</a>.</td></tr><tr><td><code>1001: Unknown category provided</code></td><td>The category doesn't match a marketplace category, or you sent the category label instead of its code.</td><td>Check the formatting matches the marketplaces or check the marketplace's category code.</td></tr><tr><td><code>1004: Unknown category provided</code></td><td>A category mapping in your Mirakl account overrides the mapping in Channable.</td><td>Follow <a href="#remove-category-mapping-in-mirakl-error-1004">Remove category mapping in Mirakl</a>.</td></tr><tr><td><code>2004: An attribute has a value that is too long</code></td><td>The value is longer than the marketplace's character limit.</td><td>Check the requirements of the marketplace and add a <a href="https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/how-to-use-actions-then-in-rules/text-actions/rule-action-maximum-length.md">maximum length rule</a> to the mapped field.</td></tr><tr><td><code>2006: An attribute has a value that is not one of the allowed values</code></td><td>The value isn't in the marketplace's list of supported values.</td><td>Use rules to change the value to a supported one.</td></tr><tr><td><code>2007: An attribute value doesn't match a regular expression</code></td><td><p>The value is in the wrong format. </p><p></p><p>For example, Carrefour Spain requires a 13-digit EAN.</p></td><td>Use rules to reformat the value.</td></tr></tbody></table>

#### More information

<details>

<summary>Fix "product not found" errors</summary>

**Product not found** errors mean Channable sent an offer for a product that doesn't exist in the marketplace's catalog.&#x20;

In the **Feedback** tab, they often appear as `Offer - product not found` or `mirakl_unknown_error_code`, with the message "The product does not exist."

This usually happens for one of these reasons:

* The product identifier is wrong. For example, `EAN` is mapped to the wrong field.
* The marketplace is still processing the product. The error shows as `Product - submission pending`.
* The product failed validation because required attributes are missing or invalid, so the marketplace didn't create it. The error shows as `Product - data error` or `Product - integration error`.

Each marketplace has its own catalog. A product that's live on one Mirakl marketplace can still be missing on another.

**To fix the error:**

1. In your channel's **Result** step, go to the **Feedback** tab.
2. Check whether the same products have attribute errors, such as `1000` or `2006`. If they do, fix those first. See [**Fix an attribute value in the Build** step](#fix-an-attribute-value-in-the-build-step).
3. In the **Build** step, check that the **EAN** attribute is mapped to the field that contains your EANs.
4. In the **Category** step, check that your categories are mapped to marketplace categories, and that attributes for those categories are filled in the **Attributes per category** tab in the **Build** step.
5. Click **Run now**.
6. If the error changes to `Product - submission pending`, wait for the marketplace to process the product. For the latest status, [**download a non-integrated products report**](#download-the-non-integrated-products-report).

If you can't provide a required attribute, contact the marketplace. The marketplace may approve a product even when some required attributes are missing.

</details>

<details>

<summary>Fix an attribute value in the Build step</summary>

Follow these steps for the following errors:  `1000`, `1001`, `2004`, `2006`, and `2007`.

1. In your channel's **Result** step, go to the **Feedback** tab and click the error.
2. In the **ID** column, click a product ID.
3. Scroll and find the attribute marked **Missing mapping for "\[attribute]"** or **Invalid value for "\[attribute]"**, then click **View in build**.&#x20;
   1. For 2004 errors, note the character limit shown in the **Errors** column.
4. Next to the attribute, click the info icon to see **Example** and **Possible values**.
5. Fix the mapped field:
   * If the attribute isn't mapped, map a field that contains accepted values.
   * If the value isn't accepted, use rules to change it to an accepted value. For categories, use the category code, not the label.
   * If the value is too long, add a maximum length rule to the mapped field.
   * If the value is in the wrong format, use rules to reformat it.
6. If you don't have a field with supported values, [create a new field, fill it using rules, and map it to the attribute](https://helpcenter.channable.com/list-advertise/list-on-channels/fill-missing-attribute-data.md) in the **Build** step.
7. Click **Save**.
8. Click **Run now**.

{% hint style="info" %}

#### Note

While you're in the **Build** step, check other attributes marked **Required by marketplace** (blue dot) and map them.
{% endhint %}

</details>

<details>

<summary>Remove category mapping in Mirakl (error 1004)</summary>

Error `1004` means a category mapping in your Mirakl account overrides the category mapping in Channable. Remove the Mirakl mapping so Channable's categories apply.&#x20;

1. In your Mirakl account, go to **Settings > Catalog mapping**.
2. Under **My catalog structure**, click **Root**, then click **Category**.
3. Click **Category** again, then click **Remove mapping**.
4. In Channable, open your channel and click **Run now**.

</details>

### Download Mirakl error reports <a href="#download-mirakl-error-reports" id="download-mirakl-error-reports"></a>

Mirakl's reports show what the marketplace rejected or is still reviewing. You can use the reports to investigate different errors. You'll find them in your Mirakl account under **Catalog > Product imports**.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Report</th><th>What it shows</th><th>Use it when</th></tr></thead><tbody><tr><td>Non-integrated products report <mark style="color:$info;">(recommended)</mark></td><td>Products the marketplace rejected or is still reviewing after it processed your import.</td><td>Your channel ran, but products show <code>Product - submission pending</code> or data errors.</td></tr><tr><td>Source file error report</td><td>Problems with the content or format of the import file. Matches the feedback in Channable.</td><td>You want the same feedback outside Channable.</td></tr><tr><td>Added products report</td><td>Products the marketplace integrated successfully.</td><td>You want to confirm which products are live.</td></tr></tbody></table>

<details>

<summary><i class="fa-download">:download:</i> Download the non-integrated products report</summary>

{% hint style="info" %}
Mirakl can take several days to generate this report. If it's urgent, contact Mirakl support.
{% endhint %}

1. Log in to your Mirakl account.
2. Go to **Catalog > Product imports**.
3. Find the import files Channable sent. Their names start with `channable_create_update_`.
4. Next to the most recent file, click **See details**.
5. Next to **Non-integrated products report**, click **Download**.

<figure><img src="https://3067532480-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. Open the CSV file. If you use Microsoft Excel or Google Sheets, you might need to import the file instead of opening it.
7. In the **Errors** column, read the error for each product.
8. Fix the errors in Channable, then click **Run now**.

{% hint style="warning" %}
The marketplace writes these error descriptions. If one isn't clear, contact the marketplace instead of Mirakl or Channable.
{% endhint %}

</details>

### Check product status in Mirakl <a href="#check-product-status-in-mirakl" id="check-product-status-in-mirakl"></a>

Each product in Mirakl has a validation status, an acceptance status, and a synchronization status. Check all of them to see where a product is stuck.

1. In your Mirakl account, go to **Catalog > Catalog Manager**.
2. In the **Product status** column, click <i class="fa-circle-info">:circle-info:</i> next to a status to see what it means.&#x20;
3. For a detailed status, open the product page and click <i class="fa-circle-question">:circle-question:</i>.

{% hint style="warning" icon="lightbulb" %}
To view statuses in bulk, use the filters, such as **Product status**.

<img src="https://3067532480-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 %}

| Status          | Meta status           | What it means                                                                                                                                                                                                      |
| --------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Validation      | Valid data            | The product data meets the marketplace's requirements.                                                                                                                                                             |
| Validation      | Invalid data          | The product data doesn't meet the marketplace's requirements.                                                                                                                                                      |
| Validation      | Pending media         | Mirakl hasn't processed the product's images, videos, or documents yet.                                                                                                                                            |
| Validation      | Not computed          | The marketplace turned on data validation, but Mirakl hasn't recalculated this product's status yet. Mirakl recalculates it when the product data sheets are rebuilt or when the product data changes.             |
| Acceptance      | New                   | The product is new. The marketplace must accept or reject it.                                                                                                                                                      |
| Acceptance      | Changes required      | The marketplace rejected the product because of data quality issues. Update the product so the marketplace can review it again. To see the reason, hover over <i class="fa-circle-question">:circle-question:</i>. |
| Acceptance      | Pending verification  | You updated the product data sent in some way. The marketplace must now decide whether to accept or reject your changes.                                                                                           |
| Acceptance      | Accepted              | The marketplace accepted the product.                                                                                                                                                                              |
| Acceptance      | Rejected              | The marketplace rejected the product. To see the reason, hover over <i class="fa-circle-question">:circle-question:</i>.                                                                                           |
| Synchronization | Synchronized          | The product is integrated into the marketplace.                                                                                                                                                                    |
| Synchronization | Not synchronized      | The product isn't integrated into the marketplace.                                                                                                                                                                 |
| Synchronization | Synchronization error | An error occurred while integrating the product.                                                                                                                                                                   |

{% hint style="warning" %}

#### Acceptance is separate from validation.&#x20;

The marketplace reviews products in its own workflow, so an item can have **Valid data** and still show **New** or **Changes required**.&#x20;

If the acceptance status doesn't change after you fix the data, contact the marketplace.
{% endhint %}

For more about these statuses, see [Mirakl's Help Center](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/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-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.
