Boulanger (Mirakl)

Add a channel catalogue

Add a Boulanger 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.

map Categories

map your categories with Boulanger's using "Categories mapping".

Complete Attributes mapping

map your products catalogue fields with the fields requested by the channel, based on fields definitions. If necessary, enter hard values, use functions and/or adapt the values by creating rules. For fields with valid values, select the suggested value or map with your products catalogue values.
If a value is missing in the drop-down menu, please contact your Boulanger 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 Boulanger recommends you fill them in to improve your products visibility.

Special features for Boulanger:

Get compliant with anti-waste law (AGEC)

Boulanger has informed us that new attribute is being created on the Mirakl side, you will be informed when it is made available: 

• A new field will be available in your Mirakl back office to indicate your main IDUs. 

While waiting for the creation of this attribute, Boulanger invites you to collect the necessary information.

1. Set up your special offers/sales

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

• "price": strikethrough price of your product (original price). If your product is 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

Sales: To find out the deadline for sending your on sales data, please contact your Boulanger account manager.

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 in your channel back office.

2.2 Shipping costs

Please note that each product is linked to a logistics category. The shipping costs are calculated on the basis of:

• the delivery method linked to the product
• the logistics category linked to the product

For the logistics category, you may choose between several options:

Keep the logistics category assigned by default by the channel. In that case, no action needs to be taken by you in Lengow.

OR

Change the logistics category assigned by default by the channel. In that case, fill in the field "logistic_class" (contact your channel account manager to obtain the list of authorised values).

Note: Go to your Mirakl back office if you want to set up free shipping costs for all your products.  

3. Variation values

Boulanger doesn't manage products variations and will create a separate product page for each product variation from your products catalogue.

For instance, there will be different product pages for a mobile phone available in different colours on Boulanger:
- One product sheet for the product X in black
- One product sheet for the product X in grey
- One product sheet for the product X in red
- One product sheet for the product X in blue

4. Get compliant with anti-waste law (Agec)

Boulanger provides an attribute in your offers feed to indicate the UID associated with your products. : "eco_contributions".

Fill in the identifier for the corresponding REP sector.

Manage your Exclusions

Follow the usual instructions for exclusions for this channel:

Preview your data

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

Configure your Options

Configure options before sending your products catalogue to the channel.

Mirakl_storeid : Enter here your Mirakl store identifier

More about Mirakl Authentication System

Launch the channel catalogue

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

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

• Send your optimised catalogue to Boulanger

Two distinct feeds are sent to the channel through API:

• Product Feed: enables the integration and creation of products. It is sent to the channel once a day. If your products are free from errors, they will be created on the channel and will appear online within 48 hours, after the offer feed has been sent.
• Offer Feed: enables the update of prices, stock, etc. It is sent to the channel every hour. When the channel receives the offer feed, data is updated almost immediately on the channel website.

Read Channels reports

Read product and offer Channels 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 Channels reports are available and downloadable from:

• Lengow: "Channel" tab > select "Boulanger" > click on "Activity"
• Your Boulanger 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

• Edit "product data"

Contact your Boulanger account manager to edit this data.

• Edit "offer data"

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

Unpublish/Delete an offer

• To stop advertising an offer on Boulanger, read our recommendations.
• To delete an offer from your Boulanger Mirakl back office, set the quantity of the product at 0 (zero) in the "Attributes mapping" area.

Note: This channel updates stock quantities at 10 am and 3 pm. If you send the value "0" in the quantity field for a specific product, this product can not be ordered anymore but you may have to wait a few hours until the information "out of stock" appears on the product page.

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

Contact Boulanger

• Johanna Dendievel : johanna.dendievel@boulanger.com
• Nicolas Ferret : nicolas.ferret@boulanger.com