To main website
  1. Channable
  2. API's
  3. Mirakl API

Articles in this section

See more

Setting up an Leroy Merlin or Bricoman API

Do you want to learn interactively all basics related to the creation of an API export, or how to make an advanced setup for an API in Channable? Learn how to create a Channacademy account in the Channable app through this Help Center article and start with the Basic APIs or Expert APIs course.

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 (in the top right corner) > 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.

Connection settings - Customer Account.png EN_-_Leroy_merlin.png Sing in Mirakl - Oauth.png

Step 2: Add a new Leroy Merlin API in Channable

Now go to the API's overview, in your project. And click on add new API, Select the Leroy Merlin connection you just made and give your new API a name.
EN_-_Leroy_Merlin_5.png
Select the field you want to use for Unique ID per item (we recommend the 'id' field), and the Language for categories. You can also add a master rule group here if you want. Click on "Continue" to finish creating the new Leroy Merlin API.

Note: There are three countries available for this API in Channable: France, Spain, and Italy. Normally you choose the country in the Settings step, but for this API it works a bit differently. You don't choose a country in the Settings step, but you will have to indicate a country as "enabled" in the build step. More information can be found in step 3 of this article. 

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 to fill it out by clicking on the field itself and selecting what you would like to go in there. For example, the field 'Title' should display the title of your product and so on. When you have finished setting up the product listings, just click 'save' at the bottom of the screen.

        EN_-_Build_step_Leroy_Merlin.png
        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.

        Country tabs:         Next to the Item tab, you will find the France, Spain, and Italy tabs. If you only want to sell in France e.g. you will have to put the Leroy Merlin France option on 'Enabled' and the Leroy Merlin Spain and Leroy Merlin Italy on 'Disabled'. If you want to sell in all three countries, you will have to put the Leroy Merlin option in all three tabs (France, Spain, and Italy) on 'Enabled'.

        Note: In addition, you can also choose to sell on Bricoman. You can do so by putting this channel onEnabledorDisabledin the France tab. This marketplace is only available in France. 
        EN_-_Leroy_Merlin_2.png EN_-_Leroy_Merlin_3.png EN_-_Leroy_Merlin_4.png
      4. Attributes
        Almost done! Next up is filling in the fields in the Attributes step. Select the category you want to optimize first. An example of what should be in front of you now can be seen in the screenshot below. 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 on the left-hand side of the screen and click 'activate project'. After, go back to the APIs overview and go to "Your Leroy Merlin 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 Leroy Merlin.

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.