Mirakl-based marketplaces: common issues
About this article
This article describes the most common issues with marketplaces based on the Mirakl framework, and how to troubleshoot them.
Table of contents
Mirakl provides merchants with a familiar framework across multiple marketplaces, facilitating and speeding up processes such as the integration and maintenance of these channels. As Mirakl-based marketplaces work in a standardized way, the steps to troubleshoot them also tend to be the same.
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.
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 is finalized, this message should disappear and the product should be visible in the channel's front-end – provided that its content is approved.
If the message persists, the product content may be rejected by the marketplace. 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.
Error setting HTML description
ChannelEngine checks your product descriptions for accurate HTML formatting. If the following message appears on the Validation and feedback tab: "Error setting HTML description, please check the long descriptions for invalid HTML syntax.", the reason is:
- The description contains unsupported HTML elements. Here is the list of elements supported by ChannelEngine: strong, b, em, i, br, code, h1-h6, blockquote, img, hr, p, pre, ul, ol, li.
- The HTML element is not formatted properly. E.g.: the element does not have a closing tag.
To solve this, check your descriptions for unsupported HTML elements and formatting.