allegro-logo_freelogovectors.net_.png

To distribute your products on allegro, check that your products catalogue contains the data normally required.

Register as a seller to publish and sell your products on allegro.com. Please check Allegro documentation if you are EU company or NON-EU company to register and activate your account. 

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

Allegro now requires that for some categories you have a minimum % of your offers assigned to an existing product on the marketplace.

If you do not meet this condition, you might be unable to list new offers in those categories.
Details of the concerned categories is here!

Productization

Since 2019, Allegro has been grouping all offers pointing to the same product thanks to EAN code or Allegro product ID. 

  • They're calling it "Productization".

The aim is to give customers a better experience to find the right product and the best offer easily. As a result, your offer will be grouped and included in the list of offers presenting the product.Allegro requires, that at least 50% of your offers be assigned to a product in the categories mentioned below

  • Culture and Entertainment,
  • Beauty,
  • Home and Garden,
  • Supermarket
  • Health

That at least 40% of your offers be assigned to a product in the categories mentioned below    

  • Electronics
That at least 30% of your offers be assigned to a product in the categories mentioned below  
  • Sports and Tourism
  • Fashion
  • Child
  • Company and services
That at least 10% of your offers be assigned to a product in this category  mentioned below  
  • Automotive (from 1st of December 2021)

In Lengow, make sure to complete the EAN code attribute if you know it or product ID for these categories.

Review this file to verify which sections of the categories Allegro is requesting 1% of the offers assigned to a product.  

More info on grouping offers in Allegro's documentation.
Allegro wants to enable this offers association with a product in as many categories as possible, but the specificity of the sold items not always allow it.

EAN Matching

If you know that an active offer related to your product exists in Allegro's database then provide : 

  • the EAN number (or product ID)
  • price
  • quantity

An active offer means that the category of your product exists with the same EAN code. Make sure your have matched the correct category in Lengow before completing the attributes above.     

Nevertheless, mandatory product fields still have to be completed in Lengow structure in order to make product feed valid for Lengow.

Add a channel catalogue

Add a allegro channel catalogue in your Lengow account.

All the data in your catalog must be sent in Polish (titles, description, etc.) to display on this marketplace.

Complete Attributes Matching

Match 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 match with your products catalogue values.

Some fields are mandatory and must be completed. Other fields are optional but allegro recommends you to fill them in to improve your products visibility.

1. Set up special offers

It is possible to set promotions prices via Lengow. You can use the "promotion" attributes to indicate your wish to have a "bold" title on your ads, or a highlight etc...

  • promotion-highlight: Complete this attribute to have your offer listed with blue background (see image 1).
  • promotion-bold: Complete this attribute to display your ads with bold title   (see image 2).
  • promotion.Departmentpage: If you select this option, your offer will be featured on the page of a department (e.g. Consumer electronics, Home and Health, etc.) where you are listing your offer. The offer will be displayed in a dedicated gallery of promoted offers. The gallery will present a thumbnail, price and title of your offer. Buyers will be redirected straight to your item page.
It is also possible to send "promotional campaigns" to display badges on your products (see image 3). 
The attributes to be completed in Lengow start with the prefix "badge": 
  • Badge campaign name: Indicate the name of the campaign you created in Allegro 
  • Badge campaign - market price: The price of the product that will be crossed out on the offer. Mandatory for a DISCOUNT campaign
  • Badge campaign - market currency: the currency of the crossed out price 
  • Badge campaign - promotional price: The promotional price of the offer. 
  • Badge campaign - promotional currency: the currency of the promotional price Badge campaign - max items
Example: To set the badge name "NEW" on your products follow this setting
  • Badge campaign name  =  NOWOŚĆ  
Badge list is available on Allegro's official documentation.
Please note that if you modify your prices during a campaign, the badge will be removed.
Summer Sale 2021
Summer sales period on Allegro runs from June 14th to 27th. You can submit your offers from 3 PM (CET) on June 7th. 
To join the campaign you have to offer a 10% discount minimum, and you'll get a unique "lato cen" badge (charged by Allegro).
For more information, contact your Allegro account manager.
Before setting up your promotional campaign information in Lengow to obtain a badge on your products, make sure you are eligible by the marketplace.
Please note that using the promotion and badges attributes may require extra fees from Allegro. Promotion fees have been specified in a relevant table in Appendix no.4 in the Terms and Conditions of Allegro.    

19c02f1b4510874b456b24562d2c.png

 

8104523e4bd08fca5e9af9a2781d.png

 

af736877419599a1bbe687c82955.png

2. Delivery methods & costs

  • Delivery.shippingRates.id: ID of the shipping rates your set in Allegro backoffice. Free shipping option can be set in Allegro in "Free shipping section". More info here.
    It can be difficult to find the ID of values you've created in your Allegro back-office, please read this step to know how to do it.
  • handlingTime: (mandatory) Estimated time for delivery

3. Variations

You can create Multi-variant offers on Allegro by combining multiple offers of the sames product with some different parameters (usually color, size, or weight).

Multiple variant offers enable buyers to choose  their preferred color or sizes without the need to jump between offers or sellers, hens leading to higher customer retention.
These offers are also high on the listing. The number of clicks and purchases of each of the variants gets summed up and increases the overall of popularity.
allegro_variation.png

4. July 2021 VAT legislation

In Lengow complete the "VAT Settingsfield in the Attributes Matching.
This field is available at the Category Attributes level.

5. Other attributes

      • name
      The title can contain a maximum of 50 characters. Focus on creating informative and relevant titles.
      Avoid too many keywords (new, for sale, bonus etc..), or information about your location, invoice .. in the title 
      Note: The title cannot be changed after the first purchase. If you need to change it, you'll have to delete your offer (and loose all historical datas) and create a new one.
      • description
      A good offer description should be in Polish and only describe the item you offer. Make an informative and attractive description by editing the text with HTML (mandatory)
      You can use only the following HTML tags (source allegro): 

      h1 - title 
      h2 - subtitle 
      p - paragraph 
      ul - unordered (bulleted) list 
      ol - ordered list 
      li - list item 
      b - bold 

      Photos can't be added in description using html code.

      Don't add any information related to your policy return, warranties, contact details or shipping prices. Use the dedicated specific attributes to send this information. Also, don't add any links to external websites or suggest that buyers should contact you before making a purchase.

      • images
      For images you can show the item itself with different background, packaging, brand, logotypes, color and pattern identification, certificates and numbers, graphic elements e.g a close-up, cross section, an arrow etc...
      Don't ass any store logos, or text.

6. Where to find id for values created in your allegro backoffice?

        • delivery.shippingRates.id
        • additionalServices.id
        • afterSalesServices.impliedWarranty.id
        • afterSalesServices.returnPolicy.id
        • afterSalesServices.warranty.id
        • contact.id
        • sizeTable.id

        For the  above fields, allegro expect an ID.

        This ID is created by allegro when you create a value in your allegro back-office.

        You cannot find this ID in your allegro account.

        Therefore, Lengow invites to fill in the value you want to assign to your product/s in your Lengow account (in the Attributes Matching or with a Rule). The value which you indicates has to be exactly the same as the one you created in your allegro back-office (same case, same spelling).

        Lengow will then match this value to the ID retrieved from your account via the allegro API, to send the corresponding allegro ID.

         How to know if the matching has been done correctly?

        If the value you've filled in in Lengow doesn't match with one of the value from your backoffice, the product will be in error. Please read the integration report and get back to the Attibutes Matching to change the value if necessary. 

Manage exclusions

There is no offer restrictions for this marketplace. You can send all types of offers.

You need more info at this stage of your setup ? 

Follow usual advices regarding Exclusions.

Preview your data

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

Configure your Options

Make sure your shop and Allegro account are activated and click on "Connect to Allegro", Lengow will do the rest!

2019-06-03_16h44_56.png

Launch the channel catalogue

After the first launch, two separate feeds will automatically be sent to allegro by API:

  • Products: it allows the integration and creation of products. It is sent every 4 hours.
  • Offers: it allows the update of prices, stock ... It is sent every hours.

Read Integration Reports

These reports list only items which were rejected by Allegro. For each product in error, Allegro specifies the reason for the rejection.

Integration reports are available and downloadable from Lengow in: "Channel" tab > select "Allegro" > click on "Activity"

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

Stop advertising / Delete a product

To stop advertising an offer on allegro, read general recommendations.

Manage your orders

You can manage your orders in the Lengow platform.

Lengow retrieves orders placed on allegro website every hour.

1. Order processing

Orders go through various statuses in Lengow while being processed.

2. Statuses of allegro orders

READY_FOR_PROCESSING ("waiting_shipment"): order is awaiting for shipment. At this status you can:

  • Confirm shipment, enter the carrier and the parcel tracking number/URL.
    or
  • Cancel or refund the order (specify the reason for the refund).

SHIPPED: Order has been sent and shipment is in progress.

CANCELLED: order cancelled by merchant or customer.

REFUNDING : order is being refunded

REFUNDED: order has been refunded by merchant  

Contact 

Channel's news

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

20th January 2022 - Categories deleted

  • To sum up

The 20th of January, allegro will delete some categories from its taxonomy.

  • What you have to do in Lengow

In your Lengow account, go to the Category Matching from your allegro feed. Make sure all of your categories are matched with allegro taxonomy. Match the categories which would be unlinked.

  • Original message

According to our previous announcement, we would like to inform you that from January 20th, 2022, we will start merging next category duplicates on the seller side.

How to track category merging?
Use the category events journal - GET /sale/category-events. The "CATEGORY_DELETED" event indicates that the category has been removed, and in the "redirectCategory" field you will find the ID of the category with which the deleted category was merged.

How does merging categories affect offers and products?
We will make the parameters consistent in all merged categories, so offers and products will contain the latest data - sellers will not have to make any changes. Due to the fact that the change affects merging categories only on the seller’s side, buyers will be able to see offers in two different categories.[...]

 

October 2021 - 0 is no longer valid as product parameter

  • To sum up
Allegro is no longer accepting 0 (zero) as a valid value for some attributes. You now have to send 0,01 or 1 (depending of the product category/attribute).
The marketplace will no longer update your products for which 0 (zero) will be sent. 
Therefore, you have to adapt your values.
  • What you have to do in Lengow
Make sure you are not sending the "0" value for concerned allegro attributes. Have a look to the "Preview" step.
Use Rules to adapt values if needed.
  • Original message

Product parameters affect the quality of the seller's offers and make it easier to search for goods on Allegro. 

Therefore, to make them more readable, we have introduced changes to the numerical parameters. 
 
What change have we made?
In the selected parameters you can only provide a value greater than 0. 
 
The lower threshold varies depends on the type of parameter and it is: 
 
1 - for the parameters with integers (e.g. 5, 21, 100), 
0,01 - for the parameters of the so-called floating point (e.g. 0.5 or 2.95). 
 
How will this affect active offers? 
Offers without the correct mandatory parameter values will not be automatically renewed. You will find more information about this change on the sellers page

October 2021 - Productization for Automotive category

Starting from 1st of December 2021, at least 10% of offers from Automotive category must be assigned to a product. 
Read this step.

October 2021 - Delivery methods names update

  • To sum up
Allegro changes its delivery methods name. The 4th of October 2021.
This change will be replicated in Lengow API week 41.
  • What you have to do in Lengow
Nothing. Only labels are updated. Consequently there is no change to apply on your side.
  • Original message 
On October 4th, 2021, we will update the names of the delivery methods listed below, to be consistent with the other methods [...]
We will also make the notation of COD delivery methods more consistent: "pobranie" will always be written at the end of the method name, with a lowercase letter. The identifiers will remain the same. You will find more information about this change on the seller’s page.  

Allegro

allegro-logo_freelogovectors.net_.png

To distribute your products on allegro, check that your products catalogue contains the data normally required.

Register as a seller to publish and sell your products on allegro.com. Please check Allegro documentation if you are EU company or NON-EU company to register and activate your account. 

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

Allegro now requires that for some categories you have a minimum % of your offers assigned to an existing product on the marketplace.

If you do not meet this condition, you might be unable to list new offers in those categories.
Details of the concerned categories is here!

Productization

Since 2019, Allegro has been grouping all offers pointing to the same product thanks to EAN code or Allegro product ID. 

  • They're calling it "Productization".

The aim is to give customers a better experience to find the right product and the best offer easily. As a result, your offer will be grouped and included in the list of offers presenting the product.Allegro requires, that at least 50% of your offers be assigned to a product in the categories mentioned below

  • Culture and Entertainment,
  • Beauty,
  • Home and Garden,
  • Supermarket
  • Health

That at least 40% of your offers be assigned to a product in the categories mentioned below    

  • Electronics
That at least 30% of your offers be assigned to a product in the categories mentioned below  
  • Sports and Tourism
  • Fashion
  • Child
  • Company and services
That at least 10% of your offers be assigned to a product in this category  mentioned below  
  • Automotive (from 1st of December 2021)

In Lengow, make sure to complete the EAN code attribute if you know it or product ID for these categories.

Review this file to verify which sections of the categories Allegro is requesting 1% of the offers assigned to a product.  

More info on grouping offers in Allegro's documentation.
Allegro wants to enable this offers association with a product in as many categories as possible, but the specificity of the sold items not always allow it.

EAN Matching

If you know that an active offer related to your product exists in Allegro's database then provide : 

  • the EAN number (or product ID)
  • price
  • quantity

An active offer means that the category of your product exists with the same EAN code. Make sure your have matched the correct category in Lengow before completing the attributes above.     

Nevertheless, mandatory product fields still have to be completed in Lengow structure in order to make product feed valid for Lengow.

Add a channel catalogue

Add a allegro channel catalogue in your Lengow account.

All the data in your catalog must be sent in Polish (titles, description, etc.) to display on this marketplace.

Complete Attributes Matching

Match 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 match with your products catalogue values.

Some fields are mandatory and must be completed. Other fields are optional but allegro recommends you to fill them in to improve your products visibility.

1. Set up special offers

It is possible to set promotions prices via Lengow. You can use the "promotion" attributes to indicate your wish to have a "bold" title on your ads, or a highlight etc...

  • promotion-highlight: Complete this attribute to have your offer listed with blue background (see image 1).
  • promotion-bold: Complete this attribute to display your ads with bold title   (see image 2).
  • promotion.Departmentpage: If you select this option, your offer will be featured on the page of a department (e.g. Consumer electronics, Home and Health, etc.) where you are listing your offer. The offer will be displayed in a dedicated gallery of promoted offers. The gallery will present a thumbnail, price and title of your offer. Buyers will be redirected straight to your item page.
It is also possible to send "promotional campaigns" to display badges on your products (see image 3). 
The attributes to be completed in Lengow start with the prefix "badge": 
  • Badge campaign name: Indicate the name of the campaign you created in Allegro 
  • Badge campaign - market price: The price of the product that will be crossed out on the offer. Mandatory for a DISCOUNT campaign
  • Badge campaign - market currency: the currency of the crossed out price 
  • Badge campaign - promotional price: The promotional price of the offer. 
  • Badge campaign - promotional currency: the currency of the promotional price Badge campaign - max items
Example: To set the badge name "NEW" on your products follow this setting
  • Badge campaign name  =  NOWOŚĆ  
Badge list is available on Allegro's official documentation.
Please note that if you modify your prices during a campaign, the badge will be removed.
Summer Sale 2021
Summer sales period on Allegro runs from June 14th to 27th. You can submit your offers from 3 PM (CET) on June 7th. 
To join the campaign you have to offer a 10% discount minimum, and you'll get a unique "lato cen" badge (charged by Allegro).
For more information, contact your Allegro account manager.
Before setting up your promotional campaign information in Lengow to obtain a badge on your products, make sure you are eligible by the marketplace.
Please note that using the promotion and badges attributes may require extra fees from Allegro. Promotion fees have been specified in a relevant table in Appendix no.4 in the Terms and Conditions of Allegro.    

19c02f1b4510874b456b24562d2c.png

 

8104523e4bd08fca5e9af9a2781d.png

 

af736877419599a1bbe687c82955.png

2. Delivery methods & costs

  • Delivery.shippingRates.id: ID of the shipping rates your set in Allegro backoffice. Free shipping option can be set in Allegro in "Free shipping section". More info here.
    It can be difficult to find the ID of values you've created in your Allegro back-office, please read this step to know how to do it.
  • handlingTime: (mandatory) Estimated time for delivery

3. Variations

You can create Multi-variant offers on Allegro by combining multiple offers of the sames product with some different parameters (usually color, size, or weight).

Multiple variant offers enable buyers to choose  their preferred color or sizes without the need to jump between offers or sellers, hens leading to higher customer retention.
These offers are also high on the listing. The number of clicks and purchases of each of the variants gets summed up and increases the overall of popularity.
allegro_variation.png

4. July 2021 VAT legislation

In Lengow complete the "VAT Settingsfield in the Attributes Matching.
This field is available at the Category Attributes level.

5. Other attributes

      • name
      The title can contain a maximum of 50 characters. Focus on creating informative and relevant titles.
      Avoid too many keywords (new, for sale, bonus etc..), or information about your location, invoice .. in the title 
      Note: The title cannot be changed after the first purchase. If you need to change it, you'll have to delete your offer (and loose all historical datas) and create a new one.
      • description
      A good offer description should be in Polish and only describe the item you offer. Make an informative and attractive description by editing the text with HTML (mandatory)
      You can use only the following HTML tags (source allegro): 

      h1 - title 
      h2 - subtitle 
      p - paragraph 
      ul - unordered (bulleted) list 
      ol - ordered list 
      li - list item 
      b - bold 

      Photos can't be added in description using html code.

      Don't add any information related to your policy return, warranties, contact details or shipping prices. Use the dedicated specific attributes to send this information. Also, don't add any links to external websites or suggest that buyers should contact you before making a purchase.

      • images
      For images you can show the item itself with different background, packaging, brand, logotypes, color and pattern identification, certificates and numbers, graphic elements e.g a close-up, cross section, an arrow etc...
      Don't ass any store logos, or text.

6. Where to find id for values created in your allegro backoffice?

        • delivery.shippingRates.id
        • additionalServices.id
        • afterSalesServices.impliedWarranty.id
        • afterSalesServices.returnPolicy.id
        • afterSalesServices.warranty.id
        • contact.id
        • sizeTable.id

        For the  above fields, allegro expect an ID.

        This ID is created by allegro when you create a value in your allegro back-office.

        You cannot find this ID in your allegro account.

        Therefore, Lengow invites to fill in the value you want to assign to your product/s in your Lengow account (in the Attributes Matching or with a Rule). The value which you indicates has to be exactly the same as the one you created in your allegro back-office (same case, same spelling).

        Lengow will then match this value to the ID retrieved from your account via the allegro API, to send the corresponding allegro ID.

         How to know if the matching has been done correctly?

        If the value you've filled in in Lengow doesn't match with one of the value from your backoffice, the product will be in error. Please read the integration report and get back to the Attibutes Matching to change the value if necessary. 

Manage exclusions

There is no offer restrictions for this marketplace. You can send all types of offers.

You need more info at this stage of your setup ? 

Follow usual advices regarding Exclusions.

Preview your data

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

Configure your Options

Make sure your shop and Allegro account are activated and click on "Connect to Allegro", Lengow will do the rest!

2019-06-03_16h44_56.png

Launch the channel catalogue

After the first launch, two separate feeds will automatically be sent to allegro by API:

  • Products: it allows the integration and creation of products. It is sent every 4 hours.
  • Offers: it allows the update of prices, stock ... It is sent every hours.

Read Integration Reports

These reports list only items which were rejected by Allegro. For each product in error, Allegro specifies the reason for the rejection.

Integration reports are available and downloadable from Lengow in: "Channel" tab > select "Allegro" > click on "Activity"

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

Stop advertising / Delete a product

To stop advertising an offer on allegro, read general recommendations.

Manage your orders

You can manage your orders in the Lengow platform.

Lengow retrieves orders placed on allegro website every hour.

1. Order processing

Orders go through various statuses in Lengow while being processed.

2. Statuses of allegro orders

READY_FOR_PROCESSING ("waiting_shipment"): order is awaiting for shipment. At this status you can:

  • Confirm shipment, enter the carrier and the parcel tracking number/URL.
    or
  • Cancel or refund the order (specify the reason for the refund).

SHIPPED: Order has been sent and shipment is in progress.

CANCELLED: order cancelled by merchant or customer.

REFUNDING : order is being refunded

REFUNDED: order has been refunded by merchant  

Contact 

Channel's news

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

20th January 2022 - Categories deleted

  • To sum up

The 20th of January, allegro will delete some categories from its taxonomy.

  • What you have to do in Lengow

In your Lengow account, go to the Category Matching from your allegro feed. Make sure all of your categories are matched with allegro taxonomy. Match the categories which would be unlinked.

  • Original message

According to our previous announcement, we would like to inform you that from January 20th, 2022, we will start merging next category duplicates on the seller side.

How to track category merging?
Use the category events journal - GET /sale/category-events. The "CATEGORY_DELETED" event indicates that the category has been removed, and in the "redirectCategory" field you will find the ID of the category with which the deleted category was merged.

How does merging categories affect offers and products?
We will make the parameters consistent in all merged categories, so offers and products will contain the latest data - sellers will not have to make any changes. Due to the fact that the change affects merging categories only on the seller’s side, buyers will be able to see offers in two different categories.[...]

 

October 2021 - 0 is no longer valid as product parameter

  • To sum up
Allegro is no longer accepting 0 (zero) as a valid value for some attributes. You now have to send 0,01 or 1 (depending of the product category/attribute).
The marketplace will no longer update your products for which 0 (zero) will be sent. 
Therefore, you have to adapt your values.
  • What you have to do in Lengow
Make sure you are not sending the "0" value for concerned allegro attributes. Have a look to the "Preview" step.
Use Rules to adapt values if needed.
  • Original message

Product parameters affect the quality of the seller's offers and make it easier to search for goods on Allegro. 

Therefore, to make them more readable, we have introduced changes to the numerical parameters. 
 
What change have we made?
In the selected parameters you can only provide a value greater than 0. 
 
The lower threshold varies depends on the type of parameter and it is: 
 
1 - for the parameters with integers (e.g. 5, 21, 100), 
0,01 - for the parameters of the so-called floating point (e.g. 0.5 or 2.95). 
 
How will this affect active offers? 
Offers without the correct mandatory parameter values will not be automatically renewed. You will find more information about this change on the sellers page

October 2021 - Productization for Automotive category

Starting from 1st of December 2021, at least 10% of offers from Automotive category must be assigned to a product. 
Read this step.

October 2021 - Delivery methods names update

  • To sum up
Allegro changes its delivery methods name. The 4th of October 2021.
This change will be replicated in Lengow API week 41.
  • What you have to do in Lengow
Nothing. Only labels are updated. Consequently there is no change to apply on your side.
  • Original message 
On October 4th, 2021, we will update the names of the delivery methods listed below, to be consistent with the other methods [...]
We will also make the notation of COD delivery methods more consistent: "pobranie" will always be written at the end of the method name, with a lowercase letter. The identifiers will remain the same. You will find more information about this change on the seller’s page.  
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request