Setting up a Le BHV Marais API

UI update: There is a new channel selection page and overview for Feeds and Marketplaces (previously called APIs)! Some visuals and instructions may not be up-to-date.

Note: EAN codes, Title, and description are mandatory for Le BHV Marais. Make sure these match the requirements of the platform, otherwise, no product listings can be created for your products.

Le BHV Marais offers a wide range of products in categories such as fashion, beauty, home decor, and gourmet food. Their API is built on 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.

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

2

Add a new Le BHV Marais API in Channable

Now go to the APIs 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).

Click on “Continue” to finish creating the new Le BHV Marais API.

3

Create your product listings in Channable

Once you have created the Le BHV Marais API, set up your product data by following the API steps below.

1

Categories

For your product listings 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 products listings.

3

Build - Shared attributes

Shared attributes are attributes that apply across all your items, like price and stock.

1. Start by mapping fields to attributes marked as required by the marketplace.

2. Check the remaining attributes and map fields to ones relevant for your business.

3. Click Save.

4

Build - Attributes per category

Category attributes are attributes that apply to items from specific categories, like battery information for electronic items, or sizing information for clothing.

1. Start by mapping fields to attributes marked as required by the marketplace.

2. Check the remaining attributes and map fields to ones relevant for your business.

3. Click Save.

• Shipping class: Logistic classes for Le BHV Marais are available as static values under the “Shipping class” field. Shipping classes are configured for each seller with your Onboarding Manager of Le BHV Marais.

• Event code: A unique code used to identify offers for specific commercial promotions. Your Account Manager at Le BHV Marais will provide this code before each promotional event; enter it in the Event code attribute.

• Private copy levy: In France, sellers must specify the amount of the "copie-privée" levy in euros for applicable items (e.g., blank media).

• Eco-contributions: If operating in France, add eco-contributions to your offers. See the list of available EPR categories in this article.

• Private Sales Channel: To use different pricing for loyalty customers on the 'vp' channel, channel-specific pricing is enabled (Private Sales Channel). To enable this, follow the steps in this article.

4

GPSR and DSA requirements

The European Union (EU) has introduced new GPSR and DSA requirements for online platforms, including marketplaces.

For your Le BHV Marais API in Channable, make sure to fill in the category attributes in the Build step

• GPSR - Contact du Fabricant: Enter the phone number of the manufacturer.

• GPSR - Personne Responsable Ue: Enter the name of the person responsible in the EU.

5

Send your product data to Le BHV Marais

Activate your project by going to Settings > Project settings and clicking Activate project. Then go back to the Channels overview and open “Your Le BHV Marais API Name > Settings” and activate the API by selecting “Activate API”.

After activation, click the “Run now” button to send your product listings to Le BHV Marais.

6

Check your product listings for errors

After sending your product listings to Le BHV Marais, go to the Preview tab of your Le BHV Marais API. Click filter on "error" to see which product listings have errors and were not placed. Click on a specific error to see more information about the cause.

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: There are two attributes named 'SellerArticleId' and 'SellerProductId'. '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.