To main website
  1. Channable
  2. API's
  3. Mirakl API

Articles in this section

See more

Setting up a Maisons du Monde API

Do you want to learn interactively all basics related to the creation of an API export, or how to make an advanced setup for an API in Channable? Learn how to create a Channacademy account in the Channable app through this Help Center article and start with the Basic APIs or Expert APIs course.

Maisons du Monde is a French furniture and home decor company with almost 250 stores across France, Italy, Spain, Luxembourg, Belgium, Germany, and Switzerland. Over 190 of these stores are located in France.

Step 1: Add a new Maisons du Monde connection

The Maisons du Monde uses the Mirakl platform, which means you will need a Mirakl account to start sending your product listings to Maisons du Monde.

When you have a Mirakl Maisons du Monde account, go to "[Your company] settings menu > Connections > Add connection". Click on "+ Add a new connection" and you will see a screen, where you can select Maisons du Monde. Fill in the label for your connection, for example, Maisons du Monde. Then click on ''Connect with Maisons du Monde''. You will be redirected to the environment where you can log in with your Mirakl credentials. After logging in, you will be redirected back to Channable where the connection will be available.

Maisons 1.png Mirakl API - Worten.png

Step 2: Add a new Maisons du Monde API in Channable

Navigate to the API's overview of your project and select Add new API. Select the Maisons du Monde connection you just created and give the new API a name.
Maisons 2.png
Select the field you want to use for Unique ID per item (we recommend the 'id' field), and select the Language for categorizations and attributes set up. Additionally, you have the option to include a master rule group if desired. Click on "Continue" to finish creating the new Maisons du Monde API.

Important: Maisons du Monde has the option to define Sales Channels in our API. If you want to know more about channels, or about how to set this up, please follow the steps in this article. It's important to note that setting up separate Maisons du Monde APIs for different countries while using the same connection will not work, as it will result in APIs all overwriting each other.

Step 3: Create your product listings in Channable

Once you have created the Maisons du Monde API, you can set up your product data by following the steps of the API.

  1. Categories
    For your product data to be created, your products need a category. Add categories to your products by using the generate categories feature, or create new categories from scratch.

  2. Rules
    Create different rules to optimize your product data. Take a look at our common rules support article for some examples.

  3. Build
    Here you can find our preset template for the product listings. All you have to do is fill it out by clicking on the field itself and selecting what you would like to go in there. For example, the field 'Price' should display the price of your product and so on. When you have finished setting up the product listings, just click 'save' at the bottom of the screen.
    Maisons 3.pngImportant: Mirakl APIs do not have a 'title' in the build step. There is a “ Product Title" field in the attribute step to connect the title!
    Tip! Notice the question mark behind every field, if you hover over the question mark you will see the description of the field and suggestions for possible values.
  4. In the build step, you can also find the Sales channels tab where you can fill in your pricing information for each separate sales channel on Maisons du Monde. More information about these Sales channels can be found here.  
    Maisons 4.png
  5. Attributes
    Almost done! Next up is filling in the fields in the Attributes step. Select the category you want to optimize first. An example of what should be in front of you now can be seen in the screenshot below. A more detailed explanation of what to do in the Attributes step can be found in our Attributes support article. 

Step 4: Send your products to Maisons du Monde

Almost there, your product listings are ready to be sent. If you have not activated your project, go to Setup > Project settings on the left-hand side of the screen and click 'activate project'. After, go back to the APIs overview and go to "Your Maisons du Monde API Name" > Settings, where you activate the API by selecting "Activate API". After you have completed this step, navigate back to the APIs overview and select the blue "Run now" button to send your product listings to Maisons du Monde.

Step 5: Check your product listings for errors

After you have sent your product listings to Maisons du Monde, go to the Results tab of your Maisons du Monde API. Click in the filter on 'error'. Now you can see which product listings have errors and are not placed. Click on a specific error to see more information on what is causing the error. If you have solved some errors by changing the settings or product information, re-run the Maisons du Monde API to see the new results. 

Best practices

Adding multiple attribute values: when adding multiple values in an attribute field for Mirakl Marketplaces, separate each value with a pipe symbol "|" to ensure proper detection and processing. 

Seller's Product ID for Single/simple products: Please note that there are two attributes named 'SellerArticleId' and 'SellerProductId,' respectively. 'SellerProductId' refers to the Parent ID, while 'SellerArticleId' refers to the variant items. For single products, both attributes must be filled with the same value.

For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide. Click here to read more.