How to set up a Leroy Merlin or Bricoman channel

1. In your Channable account, go to Channels and search for Leroy merlin.

2. Click on it, and select + Add a new connection.
3. At Connect with, click Leroy merlin.
   1. 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.

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.

1. Click [your Leroy merlin connection].
2. Configure your settings for your channel:
   1. For Name, give your channel a name.
   2. For Unique ID per item, select a field containing your products ID codes (e.g. id)
   3. For Language, choose the language your product data is in. 
   4. For Use master rule group, you can set a rule group if you already have one to apply to your channel.
   5. For Status, leave your API deactivated for now.
3. Click Save.

To set up your product data, assign categories to your products.

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

Learn more about categorizing for marketplaces

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.

Read more about using rules for marketplaces

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 fields that specifically apply to the category for your products .This step helps in 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.) 

Learn more about the Build step for marketplaces

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.

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

Learn more about the Quality step for marketplaces

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.

Learn more about the Preview step for marketplaces

1. If you haven't activated your project, go to [your project] > Settings and click Activate project. 
2. Select the Settings step in [your Leroy Merlin channel] 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.

Resolving errors:

1. In Description, click on the error name. This takes you to an overview of the products with that error.
2. 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.
   1. 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.
   2. For more information about the attribute and its accepted values, hover over .
3. Resolve the error.
4. 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. 

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:

1. 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.
2. 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.

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.

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

1. At My catalog structure, click Root and select Category. This opens up all mapping related to categories.
2. Click Category again and select Remove mapping. 
   
3. Return to [your Leroy Merlin channel] in Channable and click Run now to run it again.

Your category mismatch should be resolved.