Mirakl marketplaces
Many large retailers run their marketplace on Mirakl, for example MediaMarkt / Saturn, Decathlon, Douglas, Conrad and Leroy Merlin. They all use the same seller API, so one StoreLinkr integration connects you to each of them.
Key features
- Several marketplaces in one project: Connect every Mirakl marketplace you sell on as its own sales channel, each with its own API key, product selection and pricelist. The overview shows which marketplace each channel belongs to.
- Offers on the existing catalog: StoreLinkr offers your products on the marketplace's catalog by EAN, with your price, promotional price and stock. Products the marketplace already knows need no category mapping.
- Automatic order acceptance: New orders are accepted for you, so the marketplace does not cancel them, and are then imported into StoreLinkr with the delivery address.
- New products in the catalog: a product the marketplace does not know yet is created in its catalog, together with the offer. See Creating products in the marketplace catalog.
- Returns: returns from the marketplace are imported into your returns overview.
- Buy box repricer: follow the buy box of your offers and let StoreLinkr advise or set the price that wins it, within your own limits. You can also use a Mirakl marketplace only for prices. See Buy box repricer.
- Shipment tracking: When you ship an order, StoreLinkr sends the carrier and tracking code to the marketplace and confirms the shipment.
What you need
- A seller account on the marketplace, approved by the retailer.
- An EAN on every product you want to offer. Products without an EAN are skipped.
- For a product the marketplace does not know yet, mapped categories and attributes, so it can be created in the catalog. See Creating products in the marketplace catalog.
Guides per marketplace
In several countries
Benelux
Germany, Austria and Switzerland
- AUTODOC
- BAUHAUS
- Fressnapf
- Happy Size
- home24
- HORNBACH
- limango
- Manor
- Shop Apotheke
- voelkner
- XXXLutz
- zooplus
France
- Alltricks
- Auchan
- Boulanger
- Bricomarché
- BUT
- Carrefour
- Castorama
- Conforama
- Cultura
- E.Leclerc
- Galeries Lafayette
- Jardiland
- Kiabi
- La Poste
- La Redoute
- LDLC
- Leroy Merlin
- Maisons du Monde
- Place des Tendances
- Rue du Commerce
- Sarenza
- Showroomprivé
- Truffaut
- Vente-unique
- Vertbaudet
Spain and Portugal
- Brico Dépôt
- Carrefour España
- Casa del Libro
- El Corte Inglés
- PcComponentes
- Planeta Huerto
- Sprinter
- Tiendanimal
- Worten
Italy
Poland and the Czech Republic
Another Mirakl marketplace works the same way: choose Other Mirakl marketplace and paste the web address of its seller back office.
Need help with a Mirakl marketplace? Contact our support team for expert assistance.
Connecting a Mirakl marketplace
You connect a Mirakl marketplace with the web address of its seller back office and an API key. Repeat these steps for every Mirakl marketplace you sell on: each one becomes its own sales channel.
1. Get your API key
- Log in to the seller back office of the marketplace, for example the MediaMarkt or Decathlon seller portal.
- Click on your name in the top right corner and open your user settings.
- Open the API Key tab, generate a key and copy it.
- Copy the web address of the back office from your browser as well, for example
https://mediamarktsaturn.mirakl.net.
An API key only works for the marketplace that created it. A MediaMarkt key will not work for Decathlon.
2. Connect to StoreLinkr
- Log in to your StoreLinkr Portal.
- Navigate to Sales Channels -> Marketplaces.
- Click Connect a marketplace and click the tile of your marketplace, for example Praxis. Use the search field or the country filter to find it. Choose the Mirakl tile for a Mirakl marketplace that is not in the list.
- For some marketplaces the URL is filled in for you. Otherwise, or when you choose Other Mirakl marketplace, paste the web address of the seller back office. A full address like
https://example.mirakl.net/loginis fine. - Paste your API Key.
- Only fill in the Shop ID when your API key has access to more than one shop. You find the shop ID in the seller back office.
- Choose the Country, the Product Selection and the Pricelist.
- Click Test connections and then Connect a marketplace.
How offers and orders work
- Offers: Each product is offered on the catalog product with the same EAN. The offer SKU is the product's SKU, or its EAN when the SKU is empty. Price, promotional price and stock follow your product data.
- Orders: StoreLinkr accepts new orders automatically and imports them once the marketplace has released the delivery address. Refused or cancelled order lines are left out. The customer email is the anonymised address that the marketplace provides. Every Mirakl marketplace numbers its own orders, so orders of two marketplaces with the same order number stay separate.
- Offers that are not yours: when StoreLinkr cleans up offers that left your product selection or whose product was deleted, it only removes offers it created itself. Offers you manage by hand in the seller back office are left alone.
- Returns: StoreLinkr imports the returns of the marketplace regularly. They appear in your returns overview with the marketplace they came from. On the return you see the marketplace, the return method, the track & trace and the reason per product. Returns of orders from before you connected the marketplace are skipped.
- Shipping: When you ship an order with a tracking code, StoreLinkr passes the carrier and tracking code on to the marketplace and marks the order as shipped.
Mirakl resets offer settings that StoreLinkr does not send, such as a lead time or logistic class you set by hand in the back office.
Creating products in the marketplace catalog
Every Mirakl marketplace has its own catalog. If the marketplace already knows the EAN of a product, the offer is created right away. Other products are created in the catalog together with their offer, which can take a while because the marketplace only accepts a new batch every 15 minutes.
- Go to Sales Channels -> Marketplaces and open the categories of the marketplace.
- Map your categories to categories of this marketplace. Click Reload categories if the list of the marketplace is out of date or could not be loaded.
- Open Marketplace attributes. For the mapped categories you see the attributes the marketplace asks for, marked Required, Recommended or Optional. Tick Show optional attributes to see the optional ones too.
- Most attributes are filled automatically, for example from the product attribute with the same name. For the others, choose under Value from whether the value comes from a Product field, a Product attribute or a Fixed value, and save.
On the offers page, a product that is still being created shows Being added to the marketplace catalog. If the marketplace refuses it, you see Not accepted by the marketplace with the reason. Fix what the reason describes, for example an attribute you still have to map. Products that were refused are sent again after you change a mapping.
Next steps
- Configure your product selections for export
- Review your Sales Channels to monitor the connection