Mirakl guide: settings and solutions

Mirakl is a company that facilitates a platform for online marketplaces. It doesn't operate a marketplace of its own; instead, it provides the infrastructure on which various Marketplaces can be built.

Marketplaces built on Mirakl's platform share a common framework, which means they often share similar behaviors, settings and similar issues.

This guide explains how to troubleshoot common obstacles and best practices when running a Marketplace built on Mirakl with Channable.

---

Our supported Mirakl Marketplaces

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

Best practices and settings for Mirakl

How to add multiple attribute values

If you need to enter multiple values for a single attribute field for a Mirakl Marketplace, separate each value with a pipe symbol "|". This formatting ensures Mirakl correctly recognizes and processes each separate entry.

Mirakl Errors

What is the mirakl_unknown_error_code and how to solve it?

An error you can encounter is the mirakl_unknown_error_code. This error signifies a group of issues that typically arise when a product’s EAN isn’t recognized by the Mirakl database — indicating the product is either new to the marketplace or is missing required attributes.

In short: something required by the Marketplace is missing or not correctly filled out.

While this might seem complex, the solution often involves a few straightforward steps:

• Categories: Ensure your product categories are correctly matched in the Categories step of your API. If they are not, map them accurately.

• Build: Verify the Build step of your API is accurately configured. For example, an incorrect EAN field linked here can cause errors. Adjust any mismatches.

• Attributes: In the API's Attributes step, link each field to the correct counterpart and ensure the values are appropriate for the selected category.

• Rules: Use rules to refine your data further. See the attribute builder support article for enhancing the Attributes step in your API.

Once categories and attributes are filled out in your API, go to the APIs overview and run the API by clicking the blue "Run now" button.

Error 1004: The category could not be identified

Error 1004 indicates items are being sent with incorrect category mapping that cannot be matched with the categories from the Marketplace on Mirakl. This is often caused by pre-existing manual category mapping in your Mirakl Marketplace.

How to resolve the issue:

Navigate to Settings in the left-hand bar, and click on 'Settings' > 'Catalog mapping'.You will see the mapping. The orange-encased field (Category) may have been manually added.Select the orange-encased 'category' and the mapping will be displayed on the right-hand side.Click on 'Category' again (this is safe to delete because Channable did not put it there), then click 'Remove mapping'.After removing the manual mapping, go back to the Mirakl API in Channable and run the API again. This refreshes the category associations and should eliminate the category mismatch error.

Get the Mirakl error report

Because Marketplaces are built on the Mirakl platform, obtaining an error report follows the same procedure across marketplaces.

1. Log in to your Mirakl account and go to Catalog > Product Imports.

1. Find the imports done by Channable and their timestamps. Click the "See details" button for the most recent import.

1. Select "Non-integrated products report" to download the error report automatically.

Note: The file is a CSV. If using Microsoft Excel you may need to transform/import the file.

After downloading and converting the file, look for the "Status" column to see specific error(s) for each item.

What are the statuses in Mirakl?

To see product status, go to Catalog Manager for an overview of all your products.

• To understand an umbrella status, click the question mark (?) next to the product.

• To see the meta-status (detailed), open the product page and click (?).

• Use Catalog Manager filters to view statuses in bulk.

Products on the platform have three primary statuses: Validation, Acceptance and Synchronization. Combinations of these produce various meta statuses.

The Statuses in Mirakl Catalog Manager

Status	Meta status	Description
Validation	Valid data	The Product Data is compliant with the Marketplace requirements.
	Invalid data	The Product Data is not compliant with the Marketplace requirements.
	Pending media	The media (images, videos, documents) of the product data is not yet processed by the Mirakl platform.
	Not computed	When the Marketplace activates product data validation for a channel, the validation statuses for the products are not automatically recomputed. In this case, these products get the 'Not computed' status for the given channel. Several actions can trigger the re-computation of the validation status of a product: - After the rebuild of the Product Data Sheets - when you modify the Source Product Data Sheet and these modifications are reflected in the Master Product data Sheet - when you modify a Master Product Data Sheet All new products get the suitable validation status for each activated channel.
Acceptance	New	The product is new, and the Marketplace must accept or reject it.
	Changes required	Your Marketplace has rejected the product due to data quality issues. You must update your products before your Marketplace reviews the product again. You can view the rejection reason by hovering your mouse over the question mark (?)
	Pending verification	You have been asked to update a product or products. Changes have been made. The marketplaces must now decide to accept or reject the product/products.
	Accepted	Your Marketplace has accepted the product.
	Rejected	Your Marketplace has rejected the product. You can view the rejection reason by hovering your mouse over the question mark (?)
Synchronization	Synchronized	The product is integrated into the Marketplace platform.
	Not synchronized	The product is not integrated into the Marketplace platform.
	Synchronization error	An error occurred during the integration of the product.

For more information on Mirakl statuses, you can visit their help center.