Showroomprivé (Mirakl)

Add a channel catalogue

Add a channel channel catalogue in your Lengow account.

Using this channel you will be able to sell in France, in Belgium and/or in Spain.

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

Some fields are mandatory and must be completed for your products to be created or updated.

• sku: Unique ID (can be your own value)
• product-id: EAN code of your product
• product-id-type: "EAN" value if you enter an EAN code in product-id field

Other fields are optional but the channel recommends you fill them in to improve your products visibility.

The detailed list of all required and recommended attributes is available in your Mirakl back-office.
Read our dedicated article.

Multi-country settings

On the Lengow platform, specific products and offers attributes are available depending on the countries of publication.

For your products data (title, description, etc.), use the attributes containing the country code corresponding to each publication country and language. 

For example for the Spanish market, use the product attributes containing "_es":

Common product attributes for Spain:

• "product_title_es"
• "product_description_es"
• "product_manufacturer_part_number_es"
• "product_ingredients_es"
• "product_model_name_es"

Only one products catalogue can be the source of a channel. If your product information for different countries is split among several catalogues, you can:

• use other catalogues as additional sources to the main catalogue.
• create a global catalogue containing your data for all countries, for example through a reprocessing (chargeable if done by Lengow).

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

To set your offers for Belgium fill in the dedicated attributes:

• "price[channel=BEFR]"
• "discount-price[channel=BEFR]"
• "discount-start-date[channel=BEFR]"
• "discount-end-date[channel=BEFR]"

Note: Product attributes for Belgium are the same as for France (Description titre..etc..)

To set your offers for Spain fill in the dedicated attributes:

• "price[channel=ES]"
• "discount-price[channel=ES]"
• "discount-start-date[channel=ES]"
• "discount-end-date[channel=ES]"

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

2.3. Leadtime-to-ship

It corresponds to the time (in days) necessary to prepare an order.

Lead time to ship can be useful for built-on-demand products which need to be built, prepared, and packaged before they are sent. In this case you can specify a lead time to ship of five days for example, so that the customer knows that it will take five days before you ship the order.

The default maximum lead time to ship is set to 45 days.

3. Variation values

To manage products variation complete the following attribute with your "parent" ID:

• variant_group_code

4. Specific settings

4.1 General Product Safety Regulation (GPSR)

To comply with the General Product Safety Regulation (GPSR) applicable from December 13, 2024, you must provide to Showroomprivé the following information about your products through attributes available in Lengow:

• "PERSON_RESPONSIBLE_FOR_UE": Information of the person responsible within the EU (name, postal and e-mail address).
• "MANUFACTURER_CONTACT": Manufacturer information (name, company name or registered trademark, postal and e-mail address).
• "PRODUCT_WARNING_SECURITY_INFORMATION_IMAGE_ES" or "PRODUCT_WARNING_SECURITY_INFORMATION_PDF_ES" : Product warning and safety information for Spain (to be supplied in PDF or Image format).
• "PRODUCT_WARNING_SECURITY_INFORMATION_IMAGE_FR" or "PRODUCT_WARNING_SECURITY_INFORMATION_PDF_FR" : Product warning and safety information for France (to be supplied in PDF or Image format).

For more information, contact marketplace.supportseller@showroomprive.net 

4.2 AGEC Law

Showroomprivé provides attributes to make you compliant with the AGEC law. They can be found in Lengow for the relevant categories:

• "PRODUCT_SUSTAINABILITY_INDEX": sustainability index rated between 0 and 10.
• "PRODUCT_SUSTAINABILITY_INDEX_PICTURE_EN": sustainability table in image format (JPEG, PNG, or WEBP).
• or "PRODUCT_SUSTAINABILITY_INDEX_PDF_EN": sustainability table in PDF format.
  These attributes related to the Sustainability Index become mandatory from the end of February 2025.

4.3 VAT legislation

Fill in the shipping-country field.

If necessary, create a Rule to indicate a different value between your products.

If this field is left empty in the Attributes Matching, the value from your backoffice will be taken into account when accepting the order as well if you use the automatic order acceptance in Lengow.

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.
• Regarding the identifiers you have to complete:

• Mirakl_storeid : Enter here your Mirakl store identifier

More about Mirakl Authentification System

Launch the channel catalogue

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.
• Offer Feed: enables the update of prices, stock, etc. It is sent to the channel every hour.

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.

Product and offer Channels reports are available and downloadable from:

• Lengow: "Channel" tab > select "name of the channel" > click on "Activity"
• Your Channel Mirakl back office

Edit a product file

Check our usual guidelines to edit your data.

• Edit "product data"
• Edit "offer data" : Data is automatically updated as soon as the offer feed is sent out(the frequency is indicated at the "Launch the channel catalogue" step).

Unpublish/Delete an offer

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

Manage your orders

You can manage your orders in the Lengow platform.

1. Order retrieval

Lengow retrieves orders placed on the channel website every 15 minutes over a day, and once a day over 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.

Starting October 2024, Showroomprivé will also request the tracking URL to be provided when shipping an order, if you're using a carrier unregistered by Mirakl.

Contact

marketplace.seller@showroomprive.com

marketplace.supportseller@showroomprive.net