Skip to main content
Connecting Mirakl to WISEPIM - credentials, locale mapping and a live connection test Connecting Mirakl to WISEPIM - credentials, locale mapping and a live connection test Mirakl powers the marketplaces of many large retailers. If you sell on one of them, connect it to WISEPIM to build your listings once and push them out with the right content, the right images, and the right category attributes.
Mirakl is an export-only integration. WISEPIM sends your products to the marketplace but does not read listings back. Keep WISEPIM as the place where your product data lives.
The Mirakl integration is available on the Pro plan and up.

​
Before you start

Make sure you have:
  • A WISEPIM account on the Pro plan or higher
  • A seller account on a Mirakl-powered marketplace with API access
  • Your API key from that marketplace
  • The marketplace URL you connect to

​
Connect Mirakl to WISEPIM

1

Open the Integrations page

In WISEPIM, go to Integrations and find the Mirakl tile.
2

Enter your credentials

Fill in your API key and the marketplace URL. Every Mirakl marketplace has its own address, so use the one for the marketplace you sell on.
3

Choose your default hierarchy

Pick the category hierarchy your products belong to. This is the branch of the marketplace’s category tree WISEPIM uses when it exports.
4

Test and save

Click Test Connection. When it passes, click Save.
Products attach to leaf categories only, meaning the lowest level of the tree with nothing under it. Pick a hierarchy that ends in real, sellable categories, not a top-level group.

​
Let AI fill the category attributes

Every Mirakl category asks for its own set of attributes, and there can be a lot of them. WISEPIM can work these out for you from the product data you already have. This is on by default. Leave it on and AI derives the attributes the chosen category requires, so you do not have to fill each one by hand for every product.
Enrich your descriptions and attributes in WISEPIM first. The better your source data, the more accurate the derived category attributes are.

​
What a listing needs

Mirakl rejects incomplete listings. Fill these fields before you export.
Run a data quality check on your selection before exporting. Fixing a missing EAN or image in WISEPIM is much faster than chasing a rejection afterwards.

​
Export products to Mirakl

1

Select your products

On the Products page, select the products you want to list.
2

Export to Mirakl

Click Export and choose your Mirakl marketplace as the destination.
3

Review the result

Check the export result for products the marketplace pushed back on, then fix and export again.

​
Create products that don’t exist yet

Turn on the auto-create option and WISEPIM creates products on the marketplace that are not there yet, instead of only updating the ones that already exist. Leave it off if you want to update your current listings and nothing more.

​
Locale columns are filled in their own language

Operator templates often carry one column per language, such as DESCRIPTION_NL_NL, DESCRIPTION_FR_FR or TITLE_fr. WISEPIM fills each of those with the content in that language instead of repeating the source text. If your project does not have a language a column asks for, WISEPIM translates it at export time, once per product. The translation is stored on the product and reused by every later export, existing translations are never overwritten, and the language is added to your project’s available languages so it shows up in the locale switcher. A translation that fails falls back to the source text and the export still succeeds.
Export-time translation costs 1 translation credit per product per new language, deducted per batch and refunded for products whose translation did not land. Products that already have the language are never charged. If your balance covers only part of the selection, WISEPIM translates what it can and names the shortfall in the task log.

​
Fix rejected products

When Mirakl refuses a product, WISEPIM shows you what the marketplace said, up to 20 error lines per product. Each line names the field and the problem, so you can go straight to it.
The category asks for an attribute your product does not have. Fill it on the product, or let AI derive the category attributes for you, then export again.
Check that your mapping points to a leaf category. Products cannot be attached to a parent category that has categories underneath it.
Check your API key and marketplace URL, then run Test Connection. Marketplaces issue their own keys, so a key from one Mirakl marketplace never works on another.
WISEPIM shows the first 20 error lines. Fix those, export again, and any remaining errors appear on the next run.

Enrich products

Improve titles, descriptions, and attributes with AI.

Export products

Push your listings to the marketplace.

Kaufland

Sell on Kaufland’s marketplaces from the same catalog.

Supported platforms

See every platform WISEPIM connects to.