Setting up a Maisons du Monde API
UI update: You can now find error information in the Feedback tab (formerly the Errors tab) of the Build step.
UI update: There is a new channel selection page and overview for Feeds and Marketplaces (previously called APIs)! Some visuals and instructions may not be up-to-date.
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.
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.
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.
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.
Create your product listings in Channable
Follow these steps to set up your channel.
Categorize your products
To set up your product data, assign categories to your products.
AI product categorization: Automatically assigns product categories through our algorithm.
Manual Categorization: Manually assign product categories with custom rules. You can create detailed filters to map each product to the correct category.
Uncategorized Items: Products that still need to be reviewed and categorized
Set up rules
Rules help you quickly optimize your product data for the marketplace you want to sell on.
Rule templates: Commonly used rules you can adjust for your use case.
Rules setup: Set up rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.
Build your listings
The Build step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.
Mandatory and optional fields:
Mandatory fields : Required to list your products on this marketplace
Recommended : Recommended to avoid errors
Optional : Not required to list
Shared attributes: Shared attributes are the common fields that apply across your products, such as EAN, prices, and titles. This step ensures uniformity in basic product information across your listings.
Use static or dynamic Values
Static values: Fixed values that don’t change (e.g. brand name, manufacturer)
Dynamic values: Fields that automatically change based on the linked data (e.g. stock, prices)
Category-specific attributes: Category-specific attributes are fields that specifically apply to the category for your products. This step helps fine-tune your listings to meet category requirements for your marketplace.
Fill in attributes that are specific to the selected category (e.g. such size for clothing or dimensions for furniture.)
Tip: Click Auto-map fields to automatically map categories with information previously provided in the same channel.
Check the quality of your set up
The Quality step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.
Solve errors, prioritizing mandatory errors first.
Actions:
View items: See products with specific issues.
View in build: Redirects to the Build step to map missing information.
Set categories: Directs to the Categories step to categorize items.
Show source: Available for ID fields. Directs to the Settings step.
Preview before activating
The Preview step displays the attributes you mapped in the Build step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.
Filtering:
Filter by error: Click the All dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
Filter by category: Click the All categories dropdown and select the category you want to filter by.
Before you continue:
Review Shared attributes: Ensure all mandatory shared attributes are filled.
Review Category-specific attributes: Ensure all mandatory category-specific attributes are filled.
Check for errors: Correct any red-marked fields.
Additional information regarding Maisons du Monde:
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!
Sales channels: 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.
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.
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: 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.
Last updated
Was this helpful?