Ubaldi (Mirakl)


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

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

Add a channel catalogue

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

EAN matching

Ubaldi recommends that the sellers do the EAN matching before creating products.

Make sure you have completed the following attributes:

  • ID offre (offer ID)
  • EAN
  • Quantité (quantity)
  • Prix (Price)
  • Prix promo (Promotion price - if applicable)
  • Temps d’expedition (Delivery time)
  • Ecotaxe (ecotax - if applicable, otherwise 0)
  • Taxe de copie privée (Private copy tax - if applicable, otherwise 0)
  • Durée de la garantie en mois (Warranty period in months)

map Categories

map your categories with Ubaldi's through "Categories mapping".

Complete Attributes mapping

map 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 value or map with your products catalogue values.

If a value is missing in the drop-down menu, please contact your channel 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 the channel recommends you fill them in to improve your products visibility.

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 channel account manager.

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


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

This channel 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 the channel:
- 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

Parent products must be excluded from the feed sent to Ubaldi, if your products catalogue contains any.

4. July 2021 legislation - Get compliant!

In your Ubaldi back-office, fill in these fields:

  • VAT number registered in UE zone ("N° TVA enregistré dans la Zone EU")

  • Shipped from UE zone ("Expédition depuis la zone EU"). This will apply to all your products.

If one or more products are sent from a different zone than the one you indicated in your Ubaldi backoffice :
  • In Lengow complete the "Expédié depuis la Zone EU" (shipped from UE zone) field in the Attributes mapping, using a Rule to refine the value for specific products.

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

A new attribute is provided by Ubaldi to enter the IDU of your products:

  • eco-contributions

It will be coupled with the amount of the eco-tax to be filled in as well. Use the following format:
E.g. "ProducerID1|3.00,ProducerID2|0.49"

If the producer has no value, you must indicate 0.00
Ex : "Producer1|3.00,Producer2|0.00

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 above dedicated to variations.

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 Ubaldi:

    • Check that your Ubaldi online store has been created and opened.
    • Check that there are no rules created in your back office Ubaldi.

Two distinct feeds are sent to Ubaldi through API:

  • Product Feed: enables the integration and creation of your products. It is sent to Ubaldi once a day. If your products are free from errors, they will be created in Ubaldi 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 Ubaldi every hour. When Ubaldi receives the offer feed, data is updated almost immediately on Ubaldi's 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 Ubaldi. For each product in error, Ubaldi specifies the reason for the rejection.

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:
    • 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 Ubaldi account manager to edit this data.

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

Unpublish/Delete an offer

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


Articles in this section

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