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.
Table of contents
- Add a new Maisons du Monde connection
- Add a new Maisons du Monde API in Channable
- Create your product listings in Channable
- Send your products to Maisons du Monde
- Check your product listings for errors
- Best Practises
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.
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.
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.
Step 3: Create your product listings in Channable
To set up your API, follow the steps outlined below. Click on each step to expand and view the detailed instructions, which will guide you through the entire process.
1. Categorization
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.
- Smart Categorization: This feature automatically assigns categories to your products based on predefined criteria, simplifying the categorization process.
- Manual Categorization: Manually assign categories to your products by setting specific rules. You can create detailed filters to map each product to the correct category.
- Uncategorized Items: Review and categorize any items that remain uncategorized to ensure all products are properly organized.
2. Rules
Create different rules to optimize your product data. For examples, refer to our common rules support article for guidance.
- Rules Setup: Set up various rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.
3. Build step
The Build step in Channable allows you to configure all necessary attributes for your items, ensuring your product data aligns with marketplace requirements. This step is crucial for successful product listings and avoiding errors.
3.1 Overview
- Access the Build step: Start by accessing the centralized interface of the Build step. This is where you will manage and map all product attributes.
- Identify mandatory and optional Fields: Mandatory fields are highlighted in pink, indicating they are essential for listing your products. Optional fields are marked in orange and can be filled based on specific needs.
3.2 Populate Shared Attributes
-
Fill Shared Attributes: Enter common details that apply to all 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: Directly input values that remain constant, like brand name or manufacturer.
- Dynamic Values: Utilize fields that automatically update based on linked data, ideal for variables like stock levels or prices.
-
Use static or dynamic Values:
After you have filled in the desired values for the Shared attributes, continue to the Category specific attributes below.
3.3 Specify Category-Specific Attributes
- Select product category: Choose the relevant category for your product, such as clothing or furniture.
- Input Category - specific attributes: Fill in attributes that are specific to the selected category, such as size for clothing or dimensions for furniture. This step helps in fine-tuning your listings according to category requirements. Here you can again use static or dynamic values.
4. Quality step
The quality step provides instant feedback on setup quality, highlighting mandatory and optional errors to ensure your product data meets the marketplaces' standards.
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, directing to the settings step.
5. Preview step
The preview step displays mapped attributes for multiple items, highlighting errors before exporting to the marketplace.
Features
- Search & filter: Find specific products or filter by error message/category.
- Item overview: Shows all items to be exported; it can filter to show only items with errors.
- Detailed product preview: Displays missing information and dynamic actions to correct errors.
Checklist for finalizing attributes
- 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.
6. Result step
The result tab provides an overview of your API setup outcomes, including successful uploads, errors, and a preview of the products to be listed. This tab ensures your product data is correctly processed and identifies any issues that need resolution.
- Overview: The result tab shows the status of your product listings, highlighting errors and issues for detailed insights.
- Preview products: Displays an overview of products to be sent to the marketplace, allowing verification of correctly filled attributes.
- Successful: Lists products successfully processed and ready for listing, confirming compliance with marketplace requirements.
- Errors: Identifies errors during processing, providing detailed information to troubleshoot and resolve issues.
Optional tabs like repricer errors, repricer event history, stock updates, and fulfillment updates appear only if relevant to the API you are using. Click here to read more about the Result step.
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.
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.