Mirakl-based channels: common issues

About this document

This document describes the most common issues with channels based on the Mirakl marketplace framework, and how to troubleshoot them.

Table of contents


1004|Category could not be identified

The product does not exist


Mirakl provides merchants with a familiar framework across multiple channels, facilitating and speeding up processes such as the integration and maintenance of these channels. As Mirakl-based channels work in a standardized way, the steps to troubleshoot them also tend to be the same.

This includes the following channels:

  • Afound
  • Åhléns
  • Blokker
  • Carrefour.es
  • Catch Australia
  • Conforama
  • Conrad
  • Darty
  • Decathlon
  • Douglas
  • ePRICE
  • Fnac (content only)
  • fonQ
  • INNO
  • H&M Home
  • Kleertjes.com
  • Leen Bakker
  • Maisons du Monde
  • MediaMarkt Saturn
  • Secret Sales
  • vidaXL

1004|Category could not be identified

You have set up mappings in the Mirakl back-end, which interfere with ChannelEngine's content export. Effectively, any mappings on Mirakl's end block ChannelEngine's ability to create and update product content on the channel.

To solve this, go to the dashboard of your Mirakl back-end and remove all existing mappings.

Mirakl back-end: mappings removal

NB: the same error may appear if the data model used by the marketplace is updated, and a deprecated category is still in use on ChannelEngine. For more information on this, check out the article ChannelEngine: why is a category marked as deleted by channel?.

The product does not exist

ChannelEngine back-end: the product does not exist

Most Mirakl-based channels perform content checks when customers submit new product information. These checks may take a few hours or a couple of days.

If your product shows a number accompanied by the reason "The product does not exist" under the channel's  Listed products section, it means that the channel is checking the product's content. Once the check if finalized, this message should disappear and the product should be visible in the channel's front-end – provided that its content is approved.

You can see detailed status reports in the channel's Mirakl back-end. These reports contain specific errors if a product or product offer cannot be created.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.