Setting up a Leroy Merlin or Bricoman API

Leroy Merlin is a chain of DIY (Do It Yourself) and garden stores of French origin. The chain is part of the Groupe ADEO. At Bricoman you can purchase building materials, fixtures, mounting materials and professional tools.

Step 1: Add a new Leroy Merlin connection

The Leroy Merlin API uses the Mirakl platform, which means you will need a Mirakl account to start sending your product listings to Leroy Merlin.

When you have a Mirakl Leroy Merlin 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 Leroy Merlin. Fill in the label for your connection, for example: Leroy merlin. And then click on ''Connect with Leroy merlin''. 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 Leroy Merlin API in Channable

Go to the "APIs > +Add new API" and select the new connection you created with Leroy Merlin. 

Select the field you want to use for Unique ID per item (we recommend the id field), and the Language that will be used in the Categories step and will determine the valid values for the Attributes. You can also add a master rule group here if you want. Click on “Save” to finish creating the new Leroy Merlin API.

Step 3: Create your product listings in Channable

Once you have created the Leroy Merlin API, you can set up your product data by following the steps of the API.

1. Categories
   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.
2. Rules
   Create different rules to optimize your product data. Take a look at our common rules support article for some examples.
3. Build
   Item: As always, you can fill in the offer information in the Item tab. Here you can find our preset template for the product listings. All you have to do is fill it out by clicking on the field itself and selecting what you would like to go in there. For example, the field 'Price' should display the price of your product and so on. When you have finished setting up the product listings, just click 'Save' at the bottom of the screen.
   Tip! Notice the question mark behind every field, if you hover over the question mark you will see the description of the field and suggestions for possible values.
   
   

   Eco-contributions

   France introduced legislation for eco-participation. If your company is operating in France, your company must add eco-contributions to your offers on the marketplace. In this article, you can find a list of available EPR categories.

   Enable Sales Channel for Item

   With a project field, you can dynamically use the Enabled or Disabled setting to adjust which products in your API are sent to each activated channel.

   
   
   Note: We support Bricoman for France only. 
4. Attributes
   Almost done! Next up is filling in the fields in the Attributes step. Select the category you want to optimize first. A more detailed explanation of what to do in the Attributes step can be found in our Attributes support article.
   

Step 4: Send your products to Leroy Merlin

Almost there, your product listings are ready to be sent. If you have not activated your project, go to "Setup > Project settings > Activate project". After, go back to the APIs overview and go to "Your Leroy Merlin API Name > Settings > 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 Leroy Merlin or Bricoman France.

Step 5: Check your product listings for errors

After you have sent your product listings to Leroy Merlin, go to the Results tab of your Leroy Merlin 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 Leroy Merlin 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. Click here to read more.