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

Not registered at Privalia yet? Please contact Andrea Carobolante ( andrea.carobolante@privalia.com ).

To distribute your products on Privalia, check that your products catalogue contains the data usually required.

Note: you don't have these values in your products catalogue? Contact the Lengow Support Team to find an alternative.

Pink Connect

Privalia IT now uses Pink Connect technology.

The PinkConnect token that you enter in the options of your Privalia feed must be unique. This means that if you have several marketplaces that use Pink Connect (Veepee, Privalia etc.), Lengow asks you to have a Pink Connect account for each of these channels.

Migration of Privalia to Izberg

If you are using an old version of Privalia (Mirakl), a contact at Privalia has certainly been assigned to you to assist you in migrating your feed.

What does this migration mean to you?

A new Privalia feed to add in Lengow and to configure
New credentials to be completed in the parameters section (PinkConect token) to connect Lengow

Note that before completing your PinkConnect credentials on the new Privalia feed, you must delete the Mirakl credentials entered on the old feed to avoid any duplicate datas.

Orders will continue to be retrieved via Mirakl, thanks to the PinkConnect Token that you have completed into the new Privalia feed, until the complete shutdown of Mirakl by Privalia (January 2021). Make sure you have fulfilled all your orders before this date.

Add a channel catalogue

Add a Privalia channel catalogue in your Lengow account.

Match Categories

Match your categories with Privalia'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 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:

previous_price: strikethrough price of your product (original price). You shouldn't modify it even during promotions or sales.
retail_price_justification: Statement justifying the origin of the strikethrough price displayed (free text)
price: discounted price of your product. If your product is not discounted, the "price" must be equal to the "previous_price".

In addition, for the sales only, fill in this field:

sales_justification: free text, indicates that the product is on sales (on both child and parent products), its start date and the period of availability. This field must be filled in only during the legal period of sales.

For example: "Sales from xx/xx/2020 until xx/xx/2020".

The "price" attribute is used for sales AND promotions. When setting the sale price in Lengow, remember to use an activation date to avoid overwriting the standard price of your product.

2. Delivery method and costs

The configuration of delivery methods and costs must be set on your Privalia back office.

3. Variation values

Privalia accepts size and/or colour, for product variations.

To manage your variations, fill in the following fields for child lines:

modello: parent identifier (a common identifier for all the variations of a product). This field must remain empty if your product has no variations.
variation_type: Indicate here the type of variation. You can set variations on two attributes maximum. Use the "comma" as separator. Here are the possible values if a product is varied on only one attribute: "color", "size".
is_variation: Informs of the presence of variations or not. Set "true" for child products and "false" for parents and simple products.

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

A distinctive page is automatically created per color. It is then recommended to use only the Size variation.

4. VAT legislation - Get Compliant!

To get compliant with European VAT legislation, fill in these three attributes in the Attributes Matching step:

shipped_from_country
shipped_from_region
shipped_from_eu_vat_zone

5. Other specificities

Images : May contain multiple images. Each image must be separated by a comma.

Please note that the images cannot be sent empty or in 404 error. Remember to set up several Conditions in Lengow for this attribute if you intend to send several images.

Example on your left is a rule for products that have three images and another rule for products that have no image 3

Manage your Exclusions

Privalia has no pre-requisites in terms of exclusions. All types of products can be sent.

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 at the "Preview" step.

Configure your Options

Configure options before sending your products catalogue to Privalia.

Regarding the identifiers you have to fill in:

PinkConnect Token:

Enter your Privalia API Key here. To collect it, go to your Privalia sales area

Here is an example of an API key: bla_bla490:60d040b6f5b7c6a4eb3e9b2083195d745aef706a

Launch the channel catalogue

Then your feed is automatically sent to Privalia by API.

The sent stream contains your :
- Product datas (once a day) : enable the integration and creation of products.
- Offer datas (every hours) : enable the update of prices, stock, etc.

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

Product and offer integration reports are available and downloadable from Lengow: "Channel" tab > select "Privalia" > click on "Activity"

Edit a product file

Edit "product data"

Contact your Privalia 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 Veepee, read our recommendations.

It is not possible to delete an offer from your Privalia back office.

Case of products in error that you cannot correct

Privalia doesn't allow to unpublish products if an attribute is missing.

If an attribute is missing for an already published product, you have to make an exclusion. Lengow will send the last known correct values for this product to Privalia. This action will enable the channel to unpublish the product.

Manage your Privalia orders

You can manage your orders in the Lengow platform.

1. Order retrieval

Lengow retrieves orders placed on Privalia website every hour.

2. Order processing

Orders go through various statuses in Lengow while being processed.

Here is the list of Lengow statuses corresponding to the marketplace orders statuses:

"waiting_acceptance": [ "WAITING_ACCEPTANCE" ]
"waiting_shipment": [ "PENDING", "PROCESSING" ]
"shipped": [ "SHIPPED" ]
"canceled": [ "CANCELLED" ]
"refunded": [ "REFUNDED", "RETURNED" ]

Possible actions

accept (order must be at waiting_acceptance status)

ship (order must be at waiting_shipment status)

Ship action requires "tracking_number" and "carrier" to be specified. For the "carrier", enter either its code or its name (example: "5" or "Fedex").

cancel (order can be waiting_acceptance, waiting_shipment status)

refund (order can be at shipped status)

Refund action requires "refund_price", "refund_shipping_price" to be specified.

Make sure to set partially cancelled order to be refunded status to "Shipped" within 3 weeks. Otherwise order will be automatically cancelled and the customer will be refunded.

September 2021 - Partial cancellation, European VAT & Class images

To sum up

1/3 You have to set partially cancelled order to be refunded status to "Shipped" within 3 weeks. Otherwise order will be automatically cancelled and the customer will be refunded.
2/3 New fields are available to be compliant with new European VAT Directive.
3/3 New fields are available to send technical and Energy class images.

What you have to do in Lengow

Partial cancellation : Automatic refund after 3 weeks
Review your orders management habits on Lengow if you manage orders from Lengow or Lengow plugin, or review your workflow if you are using Lengow API, if you want to avoid automatic cancellation for partial cancellation.
New European VAT Directive and Technical and Energy class imagesFill in attributes listed below at the Attributes Matching step if you are concerned.

Original message

[...]
Partial cancellation : Automatic refund after 3 weeks For a partially cancelled order to be refunded, you have to set its status as Shipped. Unfortunately, we observed that in many cases the order wasn't set as shipped and therefore the customer could not be refunded.
This is why the following rule has been implemented : After a partial cancellation, the seller has 3 weeks to ship the order, otherwise it will be automatically cancelled and the customer refunded of the whole amount of his order.
New European VAT Directive [...] Three new attributes have been created: shipped_from_country shipped_from_region shipped_from_eu_vat_zone. [...]

Technical and Energy class images
Sellers are now able to complete products viewers by adding images that illustrate technical specifications or the Energy class of the product.

This can be done by specifying URLs in those attributes : image_url_energy_class image_url_technical_spec
[...]

Contact Privalia

To register as a new merchant on Privalia IT, please contact Silvia Stevaraglia, Head of Marketplace Italy silvia.stevaraglia@privalia.com
support.marketplace@privalia.com : Use this email address if you face any issues when sending/uploading your product catalogue.
accountmanagement.marketplace@privalia.com : Use this email address for any issues/questions you may have after your product catalogue integration.

Channel's news

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

23 February 2022 - Product descriptions, offers & variations / Disabling CSS <style> tags

To sum up

CSS styles added to HTML tags to format product descriptions, offers and variants are no longer accepted from 23 February 2022. Only simple HTML formatting tags will be accepted.

What you have to do in Lengow

Make sure CSS styles are no longer used within your Privalia feed.
If the CSS styles are from your product catalogue, use the Optimisation feature at the catalogue level.

If you added the CSS styles for this channel only, update your settings in the Attributes Matching and/or Rules.

Original message

[...]

Until now, you could format your product descriptions, offers, and variants using CSS styles added in HTML <style> tags.

Yet recent security audits have indicated that these tags can be used as a loophole for an attack.

So, as a result of new security rules, these tags will no longer be usable as of February 23.

Example :

BEFORE:

<div style=“color:red; »>
<p>A description</p>
</div>

AFTER:

<div>
<p>ADescription</p>
</div>

CSS Tag deleted
In other words, the following previously supported tags will no longer work:

color
opacity
overflow-wrap
text-align
text-indent
font-family
font
font-size
font-weight
font-style
width
height

HTML tag accepted
After shutdown, only simple HTML formatting tags will be accepted.
All CSS <style> tags will be removed before the product is displayed.
[...]

Jusqu’à présent, vous pouviez mettre en forme vos descriptions de produits, vos offres et vos variantes à l’aide de styles CSS ajoutés dans les balises HTML <style>.

Show side navigation

Privalia IT (Pink Connect) / Veepee IT

Clothilde Le Cose

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

Not registered at Privalia yet? Please contact Andrea Carobolante ( andrea.carobolante@privalia.com ).

To distribute your products on Privalia, check that your products catalogue contains the data usually required.

Note: you don't have these values in your products catalogue? Contact the Lengow Support Team to find an alternative.

Pink Connect

Privalia IT now uses Pink Connect technology.

Migration of Privalia to Izberg

If you are using an old version of Privalia (Mirakl), a contact at Privalia has certainly been assigned to you to assist you in migrating your feed.

What does this migration mean to you?

A new Privalia feed to add in Lengow and to configure
New credentials to be completed in the parameters section (PinkConect token) to connect Lengow

Note that before completing your PinkConnect credentials on the new Privalia feed, you must delete the Mirakl credentials entered on the old feed to avoid any duplicate datas.

Add a channel catalogue

Add a Privalia channel catalogue in your Lengow account.

Match Categories

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

Complete Attributes Matching

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.

1. Set up your special offers/sales

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

previous_price: strikethrough price of your product (original price). You shouldn't modify it even during promotions or sales.
retail_price_justification: Statement justifying the origin of the strikethrough price displayed (free text)
price: discounted price of your product. If your product is not discounted, the "price" must be equal to the "previous_price".

In addition, for the sales only, fill in this field:

sales_justification: free text, indicates that the product is on sales (on both child and parent products), its start date and the period of availability. This field must be filled in only during the legal period of sales.

For example: "Sales from xx/xx/2020 until xx/xx/2020".

The "price" attribute is used for sales AND promotions. When setting the sale price in Lengow, remember to use an activation date to avoid overwriting the standard price of your product.

2. Delivery method and costs

The configuration of delivery methods and costs must be set on your Privalia back office.

3. Variation values

Privalia accepts size and/or colour, for product variations.

To manage your variations, fill in the following fields for child lines:

modello: parent identifier (a common identifier for all the variations of a product). This field must remain empty if your product has no variations.
variation_type: Indicate here the type of variation. You can set variations on two attributes maximum. Use the "comma" as separator. Here are the possible values if a product is varied on only one attribute: "color", "size".
is_variation: Informs of the presence of variations or not. Set "true" for child products and "false" for parents and simple products.

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

A distinctive page is automatically created per color. It is then recommended to use only the Size variation.

4. VAT legislation - Get Compliant!

To get compliant with European VAT legislation, fill in these three attributes in the Attributes Matching step:

shipped_from_country
shipped_from_region
shipped_from_eu_vat_zone

5. Other specificities

Images : May contain multiple images. Each image must be separated by a comma.

Please note that the images cannot be sent empty or in 404 error. Remember to set up several Conditions in Lengow for this attribute if you intend to send several images.

Example on your left is a rule for products that have three images and another rule for products that have no image 3

Manage your Exclusions

Privalia has no pre-requisites in terms of exclusions. All types of products can be sent.

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 at the "Preview" step.

Configure your Options

Configure options before sending your products catalogue to Privalia.

Regarding the identifiers you have to fill in:

PinkConnect Token:

Enter your Privalia API Key here. To collect it, go to your Privalia sales area

Here is an example of an API key: bla_bla490:60d040b6f5b7c6a4eb3e9b2083195d745aef706a

Launch the channel catalogue

Then your feed is automatically sent to Privalia by API.

The sent stream contains your :
- Product datas (once a day) : enable the integration and creation of products.
- Offer datas (every hours) : enable the update of prices, stock, etc.

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

Product and offer integration reports are available and downloadable from Lengow: "Channel" tab > select "Privalia" > click on "Activity"

Edit a product file

Edit "product data"

Contact your Privalia 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 Veepee, read our recommendations.

It is not possible to delete an offer from your Privalia back office.

Case of products in error that you cannot correct

Privalia doesn't allow to unpublish products if an attribute is missing.

Manage your Privalia orders

You can manage your orders in the Lengow platform.

1. Order retrieval

Lengow retrieves orders placed on Privalia website every hour.

2. Order processing

Orders go through various statuses in Lengow while being processed.

Here is the list of Lengow statuses corresponding to the marketplace orders statuses:

"waiting_acceptance": [ "WAITING_ACCEPTANCE" ]
"waiting_shipment": [ "PENDING", "PROCESSING" ]
"shipped": [ "SHIPPED" ]
"canceled": [ "CANCELLED" ]
"refunded": [ "REFUNDED", "RETURNED" ]

Possible actions

accept (order must be at waiting_acceptance status)

ship (order must be at waiting_shipment status)

Ship action requires "tracking_number" and "carrier" to be specified. For the "carrier", enter either its code or its name (example: "5" or "Fedex").

cancel (order can be waiting_acceptance, waiting_shipment status)

refund (order can be at shipped status)

Refund action requires "refund_price", "refund_shipping_price" to be specified.

Make sure to set partially cancelled order to be refunded status to "Shipped" within 3 weeks. Otherwise order will be automatically cancelled and the customer will be refunded.

September 2021 - Partial cancellation, European VAT & Class images

To sum up

What you have to do in Lengow

Original message

Contact Privalia

To register as a new merchant on Privalia IT, please contact Silvia Stevaraglia, Head of Marketplace Italy silvia.stevaraglia@privalia.com
support.marketplace@privalia.com : Use this email address if you face any issues when sending/uploading your product catalogue.
accountmanagement.marketplace@privalia.com : Use this email address for any issues/questions you may have after your product catalogue integration.

Channel's news

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

23 February 2022 - Product descriptions, offers & variations / Disabling CSS <style> tags

To sum up

CSS styles added to HTML tags to format product descriptions, offers and variants are no longer accepted from 23 February 2022. Only simple HTML formatting tags will be accepted.

What you have to do in Lengow

Make sure CSS styles are no longer used within your Privalia feed.
If the CSS styles are from your product catalogue, use the Optimisation feature at the catalogue level.

If you added the CSS styles for this channel only, update your settings in the Attributes Matching and/or Rules.

Original message

[...]

Until now, you could format your product descriptions, offers, and variants using CSS styles added in HTML <style> tags.

Yet recent security audits have indicated that these tags can be used as a loophole for an attack.

So, as a result of new security rules, these tags will no longer be usable as of February 23.

Example :

BEFORE:

<div style=“color:red; »>
<p>A description</p>
</div>

AFTER:

<div>
<p>ADescription</p>
</div>

CSS Tag deleted
In other words, the following previously supported tags will no longer work:

color
opacity
overflow-wrap
text-align
text-indent
font-family
font
font-size
font-weight
font-style
width
height

HTML tag accepted
After shutdown, only simple HTML formatting tags will be accepted.
All CSS <style> tags will be removed before the product is displayed.
[...]

Jusqu’à présent, vous pouviez mettre en forme vos descriptions de produits, vos offres et vos variantes à l’aide de styles CSS ajoutés dans les balises HTML <style>.

Have more questions? Submit a request

Pink Connect

Add a channel catalogue

Match Categories

Complete Attributes Matching

1. Set up your special offers/sales

Privalia IT (Pink Connect) / Veepee IT

Pink Connect

Add a channel catalogue

Match Categories

Complete Attributes Matching

1. Set up your special offers/sales

Recently viewed articles

Related articles

Related articles

Add a Privalia channel catalogue

Match your products catalogue fields with the fields requested by the channel

select the suggested values or match with your products catalogue values

as soon as the offer feed is sent out