How to set up a Leroy Merlin or Bricoman channel

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.

---

Before you start

You'll need

• A Mirakl Connect account

• A project in Channable with imported products

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.

1

Connect to Leroy Merlin/Brico via Mirakl

1. In your Channable account, go to Channels and search for Leroy merlin or Maxeda Brico. Note: If it doesn’t appear, click Clear to reset your filters.

2. Click on it, and select + Add a new connection.

3. 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.

4. Click Connect with Leroy merlin / Connect with Maxeda Brico.

You’ll be redirected to Mirakl to log in to your Mirakl account. This authenticates the connection so 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.

2

Set up your Leroy Merlin/Bricoman channel

1. Click [your Leroy merlin connection] / [your Bricoman connection].

2. Configure your settings for your channel:

   • Name: give your channel a name.

   • Unique ID per item: select a field containing your products ID codes (e.g. id)

   • Language: choose the language your product data is in.

   • Use master rule group: (optional) set a rule group if you already have one to apply to your channel.

   • Status: leave your API deactivated for now.

3. Click Save.

Note: You can't set up different Leroy Merlin channels for different countries with the same connection. If you want to list in multiple regions from one channel, you'll need to set up Sales Channels.

3

Create product listings

This step includes categorization, rules, and mapping (Build).

Categorize your products

Organize product data by assigning relevant categories to your products.

Copy categories from another channel

1. In the Categories step, go to the Manual Categorization tab.

2. Click Copy categories. In the pop-up, select a project to copy categories from.

3. Click Copy here.

Generate categories using project fields

1. In the Categories step, click Manual Categorization tab.

2. Click Generate categories. At Set category field, select the field containing your product categories (often category).

3. Click Save.

4. If you have remaining products without categories, continue to Manually generate categories.

Manually generate categories

1. In the Categories step, click the Uncategorized items tab.

2. Check your items to identify common patterns to filter by (e.g., 'electric' in the title).

3. Click Manual Categorization and select Add category.

4. Create a rule to assign categories in bulk (e.g., If title contains "electric" → set category [select relevant category]).

5. Click Save.

6. Click Items after in the footer to see how many items were affected.

7. Repeat until satisfied.

Set up rules

Rules help optimize your product data for your channel.

• Rule templates: commonly used rules you can adjust and customize.

Build your listings

The Build step is where you configure your product listings to match marketplace requirements.

• Mandatory fields: required to list your products on this marketplace

• Recommended: suggested to avoid errors

• Optional: not required to list

Important: Some attributes may be mandatory even if they don't seem relevant for your situation (e.g., an attribute for adding a Spanish title when you’re only selling in Germany). You can leave these attributes unmapped.

Shared attributes

• Common fields across products: EAN, prices, titles.

• Use static or dynamic values:

  • Static values: fixed (e.g., brand name)

  • Dynamic values: fields that update automatically (e.g., stock, prices)

Category-specific attributes

• Attributes that apply specifically to selected categories (e.g., size for clothing, dimensions for furniture).

Tip: Click Auto-map fields to automatically map using information using information from your other channels or other similar setups. Learn more.

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: SellerArticleId and SellerProductId. SellerProductId is the Parent ID, while SellerArticleId refers to variant items.

  • For single products, both SellerArticleId and SellerProductId must be filled with the same value.

More on Mirakl

4

Additional information / requirements for Leroy Merlin / Bricoman

GPSR requirements

The EU introduced GPSR and DSA requirements for online platforms, including marketplaces.

To comply (example workflow):

• In the Build step, go to Shared attributes.

• Scroll to the General Product Safety Regulation (GPSR) section.

• Map the GPSR attributes to your product data:

  • If product safety information applies to all products: click Manual and paste safety info.

  • If it differs per product: create a project field, add info via a rule, then map the project field (Project field > [field containing your product safety information]).

• Click Save.

Shipping class

Shipping class is marked optional by Mirakl, but is required to list on Leroy Merlin.

Important: Ensure your shipping class matches the settings in your Leroy Merlin account (My account > Settings > Shipping)

• 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.

Note: Leroy Merlin's default parcel type is INIT.

Available shipping classes:

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: 117cm
XSXXS	Logistic class XXS-XS	Parcels up to 15kg. Maximum dimension: 94cm. Maximum circumference: 187cm
XS	Logistic class XS	Parcels up to 15kg. Maximum dimension: 100cm. Maximum circumference: 150cm
INIT	Logistic class S (default)	Parcels up to 30kg. Maximum dimension: 94cm. Maximum circumference: 187cm
SM	Logistic class S-M	Parcels up to 50kg. Maximum dimension: 150cm. Maximum circumference: 200cm
M	Logistic class	Bulky packages up to 110kg. Maximum dimension: 200cm. Maximum circumference: 400cm. Maximum volume: 3m³
L	Logistic class	Bulky packages up to 250kg. Maximum dimension: 450cm. Maximum circumference: 600cm. Maximum volume: 11m³
LXL	Logistic class	Bulky packages up to 1000kg. Maximum dimension: 500cm. Maximum circumference: 750cm. Maximum volume: 20m³
XL	Logistic class	Bulky packages up to 2000kg. Maximum dimension: 600cm. Maximum circumference: 1000cm. Maximum volume: 30m³
Outsized	Logistic class	Bulky packages heavier than 2000kg or exceeding maximum dimensions, circumference and volume
FREE	Free shipping	Logistic class for free shipping

Lead time to ship

• 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 you to ship an order (Static values > [time in days]).

• Click Save.

Sales channels

Some Mirakl marketplaces allow defining sales channels to customize product listings for different markets/regions (e.g., different prices per channel).

• You can use a project field to dynamically set Enabled/Disabled per product for each sales channel.

France storefronts only - Eco-contributions

If your company operates in France, you must add eco-contributions to your offers on the marketplace. See available EPR categories.

5

Activate your channel

1. If your project isn't activated, go to [your project] > Settings and click Activate project.

2. In [your Leroy Merlin channel], go to the Settings step and click Activate API.

3. Click Save.

4. Click X to return to the Channel overview page.

5. Click Run now to send your product listings to Leroy Merlin and/or Bricoman.

6

Review and fix listing errors

• Go to the Result step and click the Feedback tab. This displays processing errors your product data currently has.

• Not all errors prevent listing. Use the Successful tab as the source of truth.

Resolving errors:

• In Description, click the error name to see affected products.

• In ID, click the ID number and scroll. A red highlighted callout shows where the error occurred. Hover over the callout for more info.

• If the error is a mapping error, click View in build to go to the attribute to map/re-map (highlighted in blue).

• For more info about an attribute and accepted values, hover over the info icon.

• Resolve the error and repeat for remaining errors. When ready, click Run now.

You can check your successfully listed products in the Successful tab.

Common errors and solutions

mirakl_unknown_error_code

This error typically occurs when Mirakl can’t identify a product’s EAN in Mirakl’s database — the product may be new to Mirakl or missing attributes needed to be recognized.

Solution:

• Check your categories: In the Categories step, ensure product categories are correctly matched.

• Check your mapping: In the Build step, verify mapped fields and correct incorrect mappings. Use rules to create and populate new fields.

After adjustments, click Run now to run your channel again.

Error 1004: The category could not be identified

This occurs when items are sent with categories that don't match Mirakl’s categories. Any existing mapping in Mirakl will override the category mapping in Channable.

Solution: Remove existing category mapping from Mirakl.

1. In your Mirakl Connect account, go to Settings > Catalog Mapping.

2. At My catalog structure, click Root and select Category to open mapping related to categories.

3. Click Category again and select Remove mapping.

4. Return to [your Leroy Merlin channel] in Channable and click Run now.

Your category mismatch should be resolved.

For more details on Mirakl errors, how-tos, and best practices, see: Mirakl guide: settings and solutions