Mirakl guide: settings and solutions

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

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

This is where our Mirakl guide comes into play. In this guide, we’ll delve into how you can troubleshoot obstacles you might encounter or what some best practices are while running a Marketplace built on Mirakl with Channable.

In this article, we'll discuss the following topics:

1. The Mirakl Marketplaces we currently support
2. Best practices and settings for Mirakl
3. Mirakl errors
4. Get the Mirakl error report
5. What are the statuses in Mirakl?
6. The Statuses in Mirakl Catalog Manager

The Mirakl Marketplaces we currently support

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, it's important to separate each value with a pipe symbol "|". This formatting is crucial for ensuring that Mirakl correctly recognizes and processes each separate entry. Using this simple separator can save you time when you manage your content.

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 errors 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 attributes that have not been added to the product yet.

In short, something that is required by the Marketplace is missing or has not been correctly filled out.

While this might seem like an issue, the solution often involves a few straightforward steps.

1. Categories: Begin by ensuring that your product categories are correctly matched in the Categories step of your API. If they're not, take a moment to map them accurately. For detailed instructions on this process, you can refer to our article on category mapping.
2. Build: Next, verify that the Build step of your API is accurately configured. For instance, if an incorrect EAN field has been linked, it could lead to errors. Make the necessary adjustments to correct any mismatches.
3. Attributes: In the API's attribute step, it's crucial to link each field to the correct counterpart and ensure the values are appropriate for the selected category. For a deeper understanding of managing attributes, check out our article on attribute optimization.
4. Rules: Utilize rules to refine your data further. Our attribute builder support article can serve as a comprehensive resource to enhance the Attributes step in your API.

Once you have filled out the categories and attributes in your API, you can navigate to the APIs overview and run the API by clicking on the blue 'Run now' button.

Error 1004: The category could not be identified

If you receive the 1004 error in your Mirakl API, this means that you're encountering issues with items being sent with incorrect category mapping that cannot be matched with the categories from the Marketplace on the Mirakl platform.

This issue is likely caused by the pre-existing manual category mapping in your Mirakl Marketplace. The pre-existing mapping might have been added manually and needs to be addressed to solve this error. 

How to resolve the issue:

1. Navigate to settings in the left-hand bar, and click on 'Settings' > 'Catalog mapping'.

2. Once there you see the mapping below, the orange encased field (Category) is manually put there.

3. Select the orange-encased 'category' and the mapping will be displayed on the right-hand side of the screen.

4. Click on 'Category' again, this is safe to delete because Channable did not put it there. Proceed to click on the 'Remove mapping' button.

5. Once the manual mapping is removed, go back to the Mirakl API in channable, and run the API again.

This action will result in refreshing the category associations and should eliminate the error related to category mismatches.

Get the Mirakl error report

Due to the fact that the Marketplaces are built on the same Mirakl platform, obtaining an error report follows the same procedure. Here's how to access it:

Simply log in to your Mirakl account and head over to 'Catalog' > 'Product Imports'.

After navigating there, you'll find a list of imports that were done by Channable, along with their timestamps.

To get the latest and most accurate error details for your products, click on the 'See details' button corresponding to the most recent import.

From the options presented, select 'Non-integrated products report' to view the error report. This will result in an automatic download of the report.

After downloading the file and converting it correctly, look for the 'Status' column in the file. This column shows the specific error(s) associated with each item.

What are the statuses in Mirakl?

To see the status of your product, you can navigate to Catalog Manager. Here you'll see an overview of all your products.

To understand what an (umbrella) status means, click on the question mark (?), next to the product. To see the meta-status (Detailed) of the product, navigate to the product page and click on (?) for an explanation.

For viewing statuses in bulk, the Catalog Manager's Filter options are useful. These filters can be applied in combination to focus on a specific set of products.

Products on the platform are categorized under three primary statuses: 'Validation', 'Acceptance' and 'Synchronization'. The combination of these statuses creates various 'meta statuses', which are visible to the users.

Here's a breakdown of the statuses and meta statuses used by Mirakl on their platform.

The Statuses in Mirakl Catalog Manager