BHV (Mirakl)


Contact BHV to know if you are eligible to sell your products on their website.

To distribute your products on BHV, check that your products catalogue contains the data normally required by Lengow.

Add a channel catalogue

Add a BHV channel catalogue in your Lengow account.

We recommend defining a Segment within your product catalogue to only configure and send the products you want to publish on this channel.

Match Categories

Match your categories with BHV's through "Categories Matching".

Complete Attributes Matching 

Match your products catalogue fields with the fields requested by the channel, based on field definition. If necessary, enter hard values, use functions and/or adapt the values by creating rules. For fields with valid values, select the suggested values or match with your products catalogue values.
If a value is missing in the drop-down menu, please contact your BHV account manager and ask for the creation of the concerned value.

Some fields are mandatory and must be completed for your products to be created or updated. Other fields are optional but BHV recommends you fill them in to improve your products visibility.

Some special features for BHV:

1. Set up your special offers/sales

To set up special offers, fill in the following fields:

1.1 Promotions

  • price: strikethrough price of your product (original price). If your products are not discounted, this field must be filled in with your usual selling price.
  • discount-price: discounted price of your product.
  • discount-start-date (optional): the date on which your promotion/sale begins. If you fill in this field and the "discount_price" field, the promotion will only begin on the date provided. Format: yyyy-mm-dd.
  • discount-end-date (optional): the date on which your promotion/sale ends. If you fill in this field and the "discount_price" field, the promotion will stop on the date provided. Format: yyyy-mm-dd.
  • code-manifestation: code of the private sales organized by BHV. Contact your BHV account manager to get this code.

1.2 Private sales

  • price[channel=VP]: strike-through price.
  • discount-price[channel=VP]: promotional price.
  • discount-start-date[channel=VP]: date on which the private sales BHV begin. Format: yyyy-mm-dd. If this field remains empty, the promotion will be displayed immediately. 
  • discount-end-date[channel=VP]: date on which the private sales BHV end. Format: yyyy-mm-dd. If this field remains empty, the promotion will be displayed for a indefinite period.
  • code-manifestation: code of the private sales organized by BHV to display the operation label and add the product to the merchandising. Contact your BHV account manager to get this code.

2. Delivery method and costs

Shipping costs and delivery methods are defined by the channel. Contact it to obtain the table of costs.

2.1 Delivery methods

Select delivery methods has to be done in your BHV back office. Click on the tab "Boutique" > "Settings" > "Delivery".

2.2 Shipping costs

For shipping costs, please note that each product family is associated with a default logistics category. Rates are calculated based on the logistics category associated with the product and the delivery method chosen by the buyer.

You will find the chart of the price list in your Mirakl> tab "Informations".

For more information, contact your BHV Account Executive.

For the logistic category, you can choose to:

  • Indicate free shipping for all of your products. This is configured at the level of your Mirakl back office: "Shop"> "Settings"> "Delivery"> tick the box "Free Shipping".
  • Keep the logistic category assigned by default by BHV. In this case, no action is to be taken on your side.
  • Determine a free threshold for each logistic category, by filling the box provided for this purpose in Mirakl "Shop"> "Settings"> "Delivery".
  • Change the default logistics category assigned by BHV ("logistic_class" field).

3. Variation values

BHV accepts variations based on size and color.

To manage your variations, fill in the following fields:

  • sellerProductId (mandatory): parent identifier of your products (a common identifier to all variations for one product), which is used to group size and/or color variations. This attribute cannot be empty:
      • For simple products: enter the same value as in the SellerArticleID attribute.
      • For products with variations: fill in with the parent identifier of your products (identical reference for each declination).
  • Fill in the attributes corresponding to your product variations: "color" and/or "size". 
Parent products must be excluded from the feed sent to BHV, if your products catalogue contains any.  

4. July 2021 VAT legislation - Get compliant

You are selling and shipping from and to Europe. Any action is required from your part.

If this is not your case, BHV requires you fill in the country from where you ship orders in your BHV Mirakl backoffice under the " Expéditions et modalités de retours" part (Shipping and return). 

5. Get compliant with anti-waste law (AGEC)

An attribute is provided by BHV to enter the IDU of your products:

  • eco-contribution

Fill in : 

"eco-contribution- amount[FR-XXX]", enter the amount in euros of the eco-contribution. 
For exemple: 0.03
"producer-id[FR-XXX]", which is the identifier you entered in "Economie Circulaire" in your Mirakl shop.

More info on the anti-waste law in the dedicated article.

Manage your Exclusions

Follow the usual instructions for exclusions for this channel:

Are there product variations in your catalogue? Check whether the parent products should be excluded or not in the step dedicated to variations.

Preview your data

Check the data you are about to send to the channel using "Preview".

Configure your Options

Configure options before sending your products catalogue to the channel.

Mirakl_storeid : Enter here your Mirakl store identifier

More about Mirakl Authentification System

Launch the channel catalogue

  • Before sending your optimised catalogue to BHV:
    • Check that your BHV online store has been created and opened.
    • Check that there are no rules created in your back office BHV.

Note: contact your BHV account manager if you have any question on this matter.

Two distinct feeds are sent to the channel through API:

  • Product Feed: enables the integration and creation of products. It is sent to BHV once a day. If your products are free from errors, they will be created in BHV and will appear online within 2 days, after the offer feed has been sent.
    Note: inform your BHV account manager when you submit a new products catalogue in your Mirakl interface.

  • Offer Feed: enables the update of prices, stock, etc. It is sent to BHV every 4 hours. When BHV receives the offer feed, data is updated almost immediately on BHV website.

Read Integration Reports

Read product and offer Integration Reports to check that your products are properly configured, either at product creation level (product feed) or updates (offer feed). These reports list only items which were rejected by the channel. For each product in error, the channel specifies the reason for the rejection.

Product and offer integration reports are available and downloadable from:

  • Lengow: "Channel" tab > select "name of the channel" > click on "Activity"
  • Your Channel Mirakl back office:
    • Products feed report: "My Inventory" > "Import From File" > "Track product imports"
    • Offers feed report : "My Inventory" > "Import From File" > "Track offer imports"

Edit a product file

Contact your BHV account manager to edit this data.

Data is automatically updated as soon as the offer feed is sent out.

Unpublish/Delete an offer

If the product is:

      • Simple: there will be no preview of the product page on your store, but the link to the product page will remain active.
      • With variations: the product page still exists with the other sizes/colors available.
  • To delete an offer from your BHV Mirakl back office, set the quantity of the product at 0 (zero) in the "Attributs Matching" area.
It is necessary to exclude the deleted products from the feed to avoid any error.

Manage your BHV orders

You can manage your orders in the Lengow platform.

1. Order retrieval

Lengow retrieves new or modified orders on the channel's website:

      • Every 15 minutes
      • Once a day, for new orders made or amended in the last 5 days 

2. Order processing

Orders go through various statuses in Lengow while being processed.

3. Lengow/Mirakl orders Statuses

This marketplace uses common statuses of Mirakl orders.

4. Specific to BHV orders

      • Type of pickup point

BHV specifies the type of pickup point for parcels in a dedicated field. 

In the Lengow API, you'll find this information in the "relay.type" node. This information is also provided if you're using one of our plugins, or in the Lengow solution when exporting the orders list. 

Here are the possible values:
- For Colissimo: A2P (Pickup Station), BPR (Post Office), ACP (ColiPoste agency)CDI, BDP, CMT.
- For Chronopost: A, B, P.


Channel's news

Find here the latest changes/communications from the channel and what you have to do in Lengow:

September 2021 - Categorie & Attributes updates to come
  • To sum up

BHV will update its categories and the attributes associated with these categories on 11 October 2021.

  • What you have to do in Lengow
On 11 October, go to your Lengow account, on your BHV Feed:
  1. At the Category Matching step: Check the unassigned categories and match the categories in your catalogue to these from BHV.
  2. Then at the Attributes Matching step: Review the settings in place for the common attributes and the attributes per category and complete as much as possible the attributes that would be empty, in order to make available to BHV, the most complete catalogue possible.
To help you with this change, BHV provides you with this file of equivalences between the actual and new categories.
Note that these values are those of the previous Galeries Lafayette evolution which will be 90% similar to BHV's changes.
These actions are mandatory for you to keep displaying your products on BHV starting from 4 October 2021.

Articles in this section

Our Support hours:
9 a.m. to 6:30 p.m. CET Monday through Friday