Leroy Merlin is a popular online home improvement, DIY (Do It Yourself) and gardening supply marketplace. Bricoman is a home improvement and hardware store owned by the same company (ADEO) that specializes in building materials, fixtures, mounting materials and professional tools.
In this article, you'll learn how to set up a Leroy Merlin channel to create, update, and manage Leroy Merlin and/or Bricoman listings in Channable.
Contents
- Step 1: Connect to Leroy Merlin via Mirakl
- Step 2: Set up your Leroy Merlin/Bricoman channel
- Step 3: Create product listings
- Best practices for Mirakl marketplaces
- Additional information/requirements for Leroy Merlin/Bricoman
- Step 4: Activate your channel
- Step 5: Review and fix listing errors
Before you start
Good to know
- You can only create listings for Leroy Merlin regions France, Italy, Spain and Portugal
- You can only create listings for Bricoman France.
- Leroy Merlin uses the Mirakl platform. This means you need a Mirakl account to send your product listings to Leroy Merlin.
- Some attributes may be mandatory even if they don't seem relevant for your specific situation (e.g. an attribute for adding a Spanish title when you’re only selling in Germany). You can leave these attributes unmapped.
You'll need
- A Mirakl Connect account
- A project in Channable with imported products
Step 1: Connect to Leroy Merlin/Brico via Mirakl
- In your Channable account, go to Channels and search for Leroy merlin or Maxeda Brico.
- Click on it, and select + Add a new connection.
-
At Connect with, click Leroy merlin/Maxeda Brico.
- For Label, keep the name as is, or change it. This is only used to identify your Leroy Merlin channel within Channable.
- Click Connect with Leroy merlin/Connect with Maxeda Brico.
You’ll be redirected to Mirakl to log in to your Mirakl account. This is to authenticate your connection to ensure Channable can list products for you.
After successfully logging in, your connection will be ready, and you will be navigated back to set up your channel.
Step 2: Set up your Leroy Merlin/Bricoman channel
- Click [your Leroy merlin connection]/[your Bricoman connection].
-
Configure your settings for your channel:
- For Name, give your channel a name.
-
For Unique ID per item, select a field containing your products ID codes (e.g.
id) - For Language, choose the language your product data is in.
- For Use master rule group, you can set a rule group if you already have one to apply to your channel.
- For Status, leave your API deactivated for now.
- Click Save.
Step 3: Create product listings
1) Categorize your products
Organize your product data by assigning relevant categories to your products.
If you've set up another channel with the same products, you can copy categories from that setup to apply to your channel.
- In the Categories step, click on the Manual Categorization tab.
- Click Copy categories. In the pop-up, select a project to copy categories from.
- Click Copy here.
- In the Categories step, click on the Manual Categorization tab.
- Click Generate categories. At Set category field, select the field containing your product categories (this is often 'category').
- Click Save.
- If you have remaining products without categories, continue to Manually generate categories.
You can create conditions to assign categories to products in bulk.
- In the Categories step, click on the Uncategorized items tab.
- Check your items to see if you can identify a common pattern you can filter by. (For example, if 'electric' is in the title of all small electric goods)
- Click on the Manual Categorization tab and select Add category.
- Create a rule to apply categories to products in bulk.
Example: If title contains electric set to category [select relevant category from dropdown]. - Click Save.
- Click Items after in the footer to see how many items were affected by your rule.
- Repeat until you're satisfied with the amount categorized.
2) Set up rules
Rules help you optimize your product data for your channel.
- Rule templates: Commonly used rules you can adjust and customize for your needs.
3) 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 : Suggested to avoid errors
- Optional : Not required to list
Shared attributes
-
Use static or dynamic Values:
- Static values: Fixed values that don’t change (e.g. brand name, manufacturer)
- Dynamic values: Fields that automatically update based on the linked data (e.g. stock, prices)
Category-specific attributes
Best practices for Mirakl marketplaces
Adding multiple attribute values
Separate multiple values in an attribute with a pipe symbol "|" for proper detection and processing.
Seller's Product ID for single/simple products
There are two attributes called SellerArticleId and SellerProductId. SellerProductId is the Parent ID, while SellerArticleId refers to variant items.
- For single products, both
SellerArticleIdandSellerProductIdmust be filled with the same value.
For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide.
Additional information/requirements for Leroy Merlin/Bricoman
GPSR requirements
The European Union (EU) has introduced new GPSR and DSA requirements for online platforms, including marketplaces.
To comply with GPSR for PcComponentes, you will need to do the following:
- In the Build step, go to the Shared attributes tab.
- Scroll to the General Product Safety Regulation (GPSR) section.
- Map the attributes in that section to your product data.
- If your product safety information applies to all your products: Click Manual and paste your product safety information in the provided field.
- If your product safety information differs per product: Create a new project field, add information to it with a rule, then map the field here (select Project field > [field containing your product safety information]).
- Click Save.
Shipping class
Shipping class is marked as optional by Mirakl, but is actually a requirement to list on Leroy Merlin.
- In [your Leroy Merlin channel], go to the Build step.
- In the Item section, select the dropdown next to Shipping class and map a static value for your parcel type (Static values > [YOUR SHIPPING TYPE])
- Click Save.
| Code | Label | Description |
| XXXS | Logistic class XXXS |
Parcels up to 5kg. Maximum dimension: 34cm Maximum circumference (length+width+depth): 86cm |
| XXS | Logistic class XXS |
Parcels up to 10kg. Maximum dimension: 50cm Maximum circumference (length+width+depth): 117cm |
| XSXXS | Logistic class XXS-XS |
Parcels up to 15kg. Maximum dimension: 94cm Maximum circumference (length+width+depth): 187cm |
| XS | Logistic class XS |
Parcels up to 15kg. Maximum dimension: 100cm Maximum circumference (length+width+depth): 150cm |
| INIT | Logistic class S (default) |
Parcels up to 30kg. Maximum dimension: 94cm Maximum circumference (length+width+depth): 187cm |
| SM | Logistic class S-M |
Parcels up to 50kg. Maximum dimension: 150cm Maximum circumference (length+width+depth): 200cm |
| M | Logistic class |
Bulky packages up to 110kg. Maximum dimension: 200cm Maximum circumference (length+width+depth): 400cm Maximum volume: 3m³ |
| L | Logistic class |
Bulky packages up to 250kg. Maximum dimension: 450cm Maximum circumference (length+width+depth): 600cm Maximum volume: 11m³ |
| LXL | Logistic class |
Bulky packages up to 1000kg. Maximum dimension: 500cm Maximum circumference (length+width+depth): 750cm Maximum volume: 20m³ |
| XL | Logistic class |
Bulky packages up to 2000kg. Maximum dimension: 600cm Maximum circumference (length+width+depth): 1000cm Maximum volume: 30m³ |
| Outsized | Logistic class | Bulky packages heaver than 2000kg or exceeding maximum dimensions, circumference and volume |
| FREE | Free shipping | Logistic class for free shipping |
Lead time to ship
Alongside shipping class, you need to provide the average time (in days) between receiving an order and shipping it.
- In [your Leroy Merlin channel], go to the Build step.
- In the Item section, select the dropdown next to Lead time to ship and select the time in days it takes for you to ship an order (Static values > [time in days])
- Click Save.
Sales channels
Certain Mirakl marketplaces provide the option to define sales channels, allowing you to customize your product listings for different markets/regions. This feature can be particularly useful when you want to set different prices or apply other offer data for each channel.
With a project field, you can dynamically use the Enabledor Disabled setting to adjust which products in your channel are sent to which specific sales channel. Learn more.
France storefronts only - Eco-contributions
If your company is operating in France, your company must add eco-contributions to your offers on the marketplace. You can find a list of available EPR categories here.
Step 4: Activate your channel
- If you haven't activated your project, go to [your project] > Settings and click Activate project.
- Select the Settings step in [your Leroy Merlin channel] and click Activate API.
- Click Save.
- Click X to return to the Channel overview page.
- Click Run now to send your product listings to Leroy Merlin and/or Bricoman.
Step 5: Review and fix listing errors
Resolving errors:
- In Description, click on the error name. This takes you to an overview of the products with that error.
- In ID, click the ID number and scroll. You should see a red highlighted callout in the section where the error occurred. Hover over the callout for more information.
- If the error is a mapping error, click View in build to be directed to the attribute you need to map/re-map, which is highlighted in blue.
- For more information about the attribute and its accepted values, hover over .
- Resolve the error.
- Repeat for remaining errors. When you're ready, run your channel again by clicking Run now.
You can check your successfully listed products in the Successful tab.
Common Errors and Solutions
mirakl_unknown_error_code
This error signifies a group of errors that typically occur when Mirakl can’t identify a product’s EAN in the Mirakl database. This means the product is either new to Mirakl, or missing attributes it needs to be recognized as a product.
Solution:
- Check your categories: In the Categories step, check that your product categories are correctly matched. If they're not, take a moment to map them accurately. For detailed instructions on this process, refer to our article on mapping categories.
- Check your mapping: In the Build step, check your mapped fields and correct anything that looks incorrectly mapped. You can use rules to create and populate new fields.
Once you’ve checked both your categories and mapped attributes, click Run now to run your channel again.
Error 1004: The category could not be identified
This error occurs when items are sent with categories that don't match the categories on Mirakl. Any existing mapping in Mirakl will override the category mapping you make in Channable.
Solution:
To fix this, remove any existing category mapping from Mirakl.
- In your Mirakl Connect account, go to Settings > Catalog Mapping.
- At My catalog structure, click Root and select Category. This opens up all mapping related to categories.
- Click Category again and select Remove mapping.
- Return to [your Leroy Merlin channel] in Channable and click Run now to run it again.
Your category mismatch should be resolved.