Connecting Mirakl

Many marketplaces run on Mirakl, such as Decathlon, Kruidvat, ANWB and MediaMarktSaturn. With the Mirakl connection, Stockhub fetches your orders from such a marketplace and sends your stock to the marketplace. You create the connection yourself in the customer portal. You need an API key and the Shop ID from the marketplace's Mirakl back office.

If you sell on several marketplaces that run on Mirakl, create a sales channel per marketplace.

Getting the details from Mirakl

Log in to the marketplace's back office. This is the environment for sellers, not the marketplace's website.

API key:

1. Click your user name in the top right and choose My user settings.
2. Open the API Key tab.
3. If you do not have a key yet, click Generate a new key.
4. Copy the API key and store it safely. If you cannot generate a key, ask the main user of your account.

Shop ID:

1. In the back office, open the settings of your shop.
2. Note the Shop ID. Where exactly it is shown differs per marketplace.

More information from Mirakl: https://help.mirakl.com/

Creating the connection in Stockhub

1. In the menu, go to Integrations > Sales channels.

2. Click New sales channel. The Add sales channel window opens.

3. Choose Mirakl.

4. Fill in the details:

   • Description: a recognisable name, for example the name of the marketplace.
   • Shipping name: this name appears on the shipping label. This field is optional.
   • Marketplace: choose the marketplace you sell on. Stockhub then fills in the address of the Mirakl environment itself. If your marketplace is not listed, choose Other and enter the marketplace's API address under URL. This address ends in /api, for example https://name-of-the-marketplace.mirakl.net/api. You get this address from the marketplace.
   • API Key: the API key from Mirakl.
   • Shop ID: the Shop ID from Mirakl.

   

5. Click Test connection. If you see Connected, the details are correct. If you see Connection failed, check the API key, the Shop ID and the marketplace or URL.

6. Click Next. If you get the message URL must end with /api, complete the URL.

7. Under Synchronisations, choose what Stockhub exchanges with the marketplace. Set each setting to Active or Inactive:

   • Import orders: fetch orders from the marketplace.
   • Update existing product info and Import new products: you only see these if the fulfilment company has switched them on.
   • Update stock to channel: send your stock from Stockhub to the marketplace.
   • Sync a virtual stock amount: this amount is added to your actual stock.
   • Send track & trace email: you only see this if the fulfilment company has switched it on.

8. Click Save.

After connecting

A new sales channel starts in draft status. You then see the message Pending sales channel approval. The fulfilment company activates the channel, after which the synchronisations start.

Good to know:

• In Mirakl, a new order first waits for acceptance. Stockhub only fetches an order once it has been accepted. Accept your orders yourself in the back office, or set Auto accept orders to Active on the Sync tab. Stockhub then accepts the waiting orders for you.
• Many marketplaces do not pass on the customer's e-mail address. On the Sync tab, enter an address under Dummy emailaddress that Stockhub uses for orders without an e-mail address.
• You can change the marketplace, URL, API key and Shop ID later on the Details tab of the channel.

See also Verkoopkanalen beheren for the tabs of the detail screen, the synchronisation settings and deleting a channel.