Setting up a Le BHV Marais API

Le BHV Marais offers a wide range of products in categories such as fashion, beauty, home decor, and gourmet food. Their API is build is a Mirakl-based platform. Please ensure that you have an active Mirakl account to begin integrating and sending your product listings to Le BHV Marais.

Step 1: Add a new Le BHV Marais connection

If you have a Mirakl Le BHV Marais account, go to ''Connections > Add connection”. Click on “+ Add a new connection” to see a screen, where you can choose Le BHV Marais.

Fill in the label for your connection, for example, Le BHV Marais. And then click on ''Connect with Le BHV Marais''. 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 Le BHV Marais API in Channable

Now go to the API's overview, in your project. Click on Add new API, Select the Le BHV Marais connection you just made, and give your new API a name.

Select the field you want to use for Unique ID per item (we recommend the 'id' field), and the Language for categories, currently French and English: GB are available.

You can also add a master rule group here. Click on “Continue” to finish creating the new Le BHV Marais API.

Step 3: Create your product listings in Channable

Once you have created the Le BHV Marais 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. For example, take a look at our common rules support article.
3. Build
   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.
   
   • Shipping class: The logistic classes, for Le BHV Marais, can be found as static values under the “Shipping class” field. The Shipping classes are configured for each seller with your Onboarding Manager of Le BHV Marais.
   • Event code: This attribute is a unique code used to identify offers for specific commercial promotions. Before each national or targeted promotional event, your Account Manager at Le BHV Marais will provide you with this specific code via email. This code can then be entered in the Event code attribute.
   • Private copy levy: In France, the private copying levy is a legal requirement that compensates authors and rights holders for private copies made using blank media such as CDs, DVDs, external hard drives, and USB drives. This levy is included in the sale price of these blank media items and is then distributed to the creators and rights holders through collective management organizations. Sellers are required to specify the amount of the ''copie-privée'' levy in euros for each applicable item in this category.
   • 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.
   • Private Sales Channel:To utilize a different pricing for the loyalty customers for the 'vp' channel, channel specific pricing has been enabled. (Private Sales Channel). To enable this, please follow the steps in this article.

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

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.

Step 4: Send your product data to Le BHV Marais

Almost there, your product listings are ready to be sent. If you have not activated your project, go to Settings > 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 Le BHV Marais 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 Le BHV Marais.

Step 5: Check your product listings for errors

If you have sent your product listings to Le BHV Marais go to the Preview tab of your Le BHV Marais API. Click 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, and check out our error solutions section on how to correct errors.