The purpose of this procedure is to explain to you how to use BeezUP to publish your DIY, gardening and home improvement products on the Leroy Merlin marketplace.
1. Prerequisites to know before selling on Leroy Merlin
a. Offers and products publications
Offers publications occur every 2h, products ones every 24h.
Offers publications use "update" mode (aka 'normal' on Mirakl side): publications only send offers matching these criteria:
- modified offers since last successful publication
- last publication failed offers
- deactivated (or removed or filtered) offers since last publication : are sent with quantity=0
✅ Note: if your offers are all exactly similar to last successful publication, next publication will be skipped.
b. Required EANs
Leroy Merlin accepts only products provided with EAN.
c. Sales channel management
The Leroy Merlin API FRA channel allows you to distribute your products and offers on leroymerlin.fr, leroymerlin.it and bricoman.fr.
Your products will be created automatically on the 3 platforms and your offers are created by default on leroymerlin.fr
Remember to send your titles and images in Italian or spanish via the ad hoc fields that have the suffix '_IT' or '_ES'. This is not mandatory but allows you to better reference your products on the marketplace.
You can choose one or more sales channels, to do so you must transmit one of these values (LMFR, LMIT, LMES and BMFR) in the "exclusive-channels" field, possibly separated by commas.
The fields "price", "discount-start-date", "discount-end-date" and "discount-price" affect the offers of the three sales channels.
If you want to choose different prices per channel, transmit the information in fields: "price_LMIT", "price_BM", "discount-start-date_LMIT", "discount-start-date_BM", "discount-end-date_LMIT" and "discount-end-date_BM".
2. Integration process
✔️ If you don't have any account, contact Leroy Merlin support service.
✔️ In Beezup, add the channel "Leroy Merlin FRA API" in 'my listings.
✔️ Proceed to categorization for the categories you want to send.
✔️ Proceed to the mapping of "Leroy Merlin FRA API" in order to send, at least, all required information.
For more information on each field, you can click on the "i" info to obtain explanations and / or go to our dedicated portal here.
✔️ Go to API settings tab and enter your API access:
Shop ID: that you will find by clicking on "Store/Settings", and taking the value next to "user name".
API key: that you will find by clicking on your email on top right as show below:
✔️ Enable Leroy Merlin FRA API (Switch ON). If everything is ok publications should start within 2h. In order to make sure that publications are well occurring, you can check the "Last publications" tab to access publication results and detailed error page.
Make sure at first, your "products" publications are ok.
Once all potential errors are fixed on products feed, contact Leroy Merlin, to make sure they do create your products.
Once Leroy Merlin creates your products, check your "Offers" publications, to make sure then your offers appear online on Leroy Merlin. 😁
✔️ If everything is fine (products & offers), your products are ready to be sold and your sales will appear in the "Order" tab within BeezUP or your own backoffice if you enabled this option.
3. Attributes meaning
Very often, in your product release report, you will get a code list attributes in error. Unfortunately these codes can be difficult to understand.
To help you know their correspondence with the attributes from the mapping page, we created a portal: click here to discover it.
We hope this page will help you better understand your error reports and thus allow you to act as quickly as possible on your publications.
We wish you good sales on Leroy Merlin!