On this page, you will find all the necessary information about how to list and maintain offers between Plentymarkets and Allegro.
After creating a catalogue format using the assistant (see section), you can proceed with data mapping and variation setup.
Before starting #
Before beginning the catalogue mappings, there are several topics you need to complete:
How to include variations in the catalogue? #
For every Allegro catalogue you create on plentymarkets, there will be a list of filters that define which variations should be included in each respective catalogue format.
In order to include variation in the Catalogue, variation must:
- The variation should be active.
- Ensure that the variation property “Allegro Catalogue” is associated with the selected catalogue format.
- Include the “Allegro” referrer under Variation Availabilities.
Sales price profile setup #
Allegro requires prices in PLN currency, so please ensure that you have created a sales price profile that can be used for your plentymarkets variation. Information on how to create a sales price profile can be found here.
Allegro Sales settings #
To create offers on Allegro, you must provide the sales settings for each item. However, before doing that, you need to create these settings on Allegro.
Allegro offers the following as sales settings:
- Return Policies
- Shipping rates
- Implied warranties
- Warranties
You can set them up on Allegro here:
Your created sales setting rules will be available to select on the catalogue. In case you created them after the Catalogue format was generated, you must to update existing catalogues, how to do this you can find here:
Name Length #
You can provide the offer name in English or Polish language, but the name should not exceed 50 characters. Make sure to shorten the name before starting, otherwise, you may encounter validation errors.
Catalogue structure and types #
Each category on Allegro has a different number of attributes and attribute values, resulting in a varied catalogue structure on plentymarkets. However, most of the fields are global across all catalogues, so you can use the same values for mapping.
The Allegro plugin supports two listing methods: one involves listing offers based on their EAN, while the other entails creating an offer from scratch.
In the first scenario, you only need to supply a name, price, and stock information. All other details, such as properties, texts, descriptions, and more, will be automatically populated from the existing offers on Allegro. This approach is particularly advantageous for resellers, as it enables them to quickly list offers with high-quality content.
The second method is ideal for manufacturers and is suitable when products need to be created entirely from the ground up. This approach necessitates the provision of all required fields and properties.
Catalogue fields. #
In this section, you will discover an explanation of the fields that repeat consistently across all catalogues and are not contingent on the Allegro Category.
Product section #
In this section, you will find 5 fields, 3 of which have assigned default values required for internal plugin logic to work.
ID #
This field is optional and primarily relevant for users capable of working with Allegro product IDs. If you intend to list an offer with a specific Allegro product, you will need to furnish the Allegro Product ID in this field. Further details can be found here
GTIN #
Within this field, please input a 13-digit EAN code, which we will utilize to attempt a search for existing products on Allegro. It is recommended to use the Barcode with GTIN-13 format as the value. Once this value is assigned, our plugin will endeavour to list offers based on the provided EAN. In the case that the EAN does not exist on Allegro, you will be required to create the offer from scratch by providing all the necessary fields. However, if you prefer to always create offers from scratch, you can leave this field empty.
Offer Section #
In this section, you can provide primary information for the offer.
Name #
The “Name” field is mandatory, and it serves as the visible representation of your offer on Allegro. The name should be in Polish and must not exceed 50 characters in length. Further details on validation and restrictions can be found here.
Images #
This field is optional if you are listing offers using EANs and prefer to use the default images found on Allegro. However, if you wish to override existing images or are creating an offer from scratch, you will need to specify the mapping for this value in the field.
Since plentymarkets allow for marketplaces to have various images, we only consider images that have the “Allegro” reference in their availability. Therefore, please ensure that the “Allegro” referrer is added to the images you intend to use for Allegro.
Description #
Within this field, you have the opportunity to describe your offer on Allegro. Allegro supports description sections with two types: “TEXT” and “IMAGE,” allowing for visually appealing offer presentations. However, it’s important to note that our plugin is exclusively compatible only with the “TEXT” type.
If you are utilizing the EAN matching approach, we recommend leaving this field empty. This will result in the default Allegro description with all its sections being used. Nevertheless, if you wish to customize or create an item from scratch, you can input your description in this field. Please keep in mind that the only permitted HTML tags are <p>, <b>, <ul>, <ol>, <li>. Any other tags will be disregarded.
In order to generate multiple sections within the description, you should allocate multiple values in the catalogue, as illustrated, and delimit them using a custom separator.
External Section #
ID #
In this section, you can input details about external IDs, which will be visible on the Allegro offers in the admin. We recommend providing either the variation ID or the Variation Number. This way, when checking offers on Allegro, you can quickly identify which variation corresponds to plentymarkets.
Selling Mode section. #
In this section, you can provide all information about the pricing of your offer.
SellingMode (format) #
Within this section, you have the option to choose the sales format for your offer, with three available choices:
- BUY_NOW – This format is standard and enables buyers to make an immediate purchase of an offer.
- AUCTION – With this format, the pricing is based on bids, and customers have the flexibility to submit their own price offers.
- ADVERTISEMENT – Kindly get in touch with Allegro support for inquiries related to this selling mode format.
In this section, you will also encounter these fields.
Price amount #
In this field, you should input the price for your offer. Typically, you should select the plentymarkets sales price profile here, which will automatically populate the price amount.
Price currency #
Prices should be specified in zlotys (zł). Therefore, for this field, please enter “PLN” as the value, as it requires the currency to be provided as a 3-letter code following the ISO 4217 standard (https://en.wikipedia.org/wiki/ISO_4217).
Minimal Price and Starting Price #
These fields should be configured only if you are using “AUCTION” as your selling mode:
- The starting Price indicates the amount from which the auction will commence.
- Minimal Price signifies the minimum price for offers in the auction format.
Location section #
Within this section, you are able to provide information about the warehouse location for offers with a delivery method; this location serves as a parcel dispatch point. For offers with a personal pick-up option, this location functions as a pick-up point.
City #
City name, with a maximum of 50 characters.
Country code #
The 2-letter country code as defined in ISO 3166. For example DE, PL.
Postal Code #
The postal code of the location should be provided. The format of the postal code depends on the ‘countryCode.’ If the countryCode is ‘PL’, the expected format is ‘XX-XXX,’ while for other countries, the format is less restrictive, allowing for 12 characters or less.
Province #
This field is mandatory if countryCode is set to “PL”, for other values, currently, it is ignored. For countryCode equalling “PL”, this field must be set to one of the following:
- DOLNOSLASKIE
- KUJAWSKO_POMORSKIE
- LUBELSKIE
- LUBUSKIE
- LODZKIE
- MALOPOLSKIE
- MAZOWIECKIE
- OPOLSKIE
- PODKARPACKIE
- PODLASKIE
- POMORSKIE
- SLASKIE
- SWIETOKRZYSKIE
- WARMINSKO_MAZURSKIE
- WIELKOPOLSKIE
- ZACHODNIOPOMORSKIE.
Stock Section #
Available #
In this section, you should specify the available stock for your offers. Please choose the warehouse from which the stock should be sourced. If you intend to combine stock from multiple warehouses, utilize the “Formula” selection in the catalogue mappings and provide the sum of the warehouse quantities. Additionally, since stock updates occur every 15 minutes through a scheduled task, ensure that you have configured the same warehouses to prevent discrepancies in stock levels.
Unit #
To provide stock information, you should also specify the units of your stock. The available options include:
- UNIT
- PAIR
- SET
Delivery section #
Within this section, it’s essential to furnish details concerning delivery times and shipping rates.
Handling Time #
This field specifies the duration for the delivery of your offers. To list an offer with a specific handling time, you should set the value in ISO 8601 format. The supported values are:
- PT0S (immediately)
- PT24H (24 hours)
- P2D (2 days)
- P3D (3 days)
- P4D (4 days)
- P5D (5 days)
- P7D (7 days)
- P10D (10 days)
- P14D (14 days)
- P21D (21 days)
- P30D (30 days)
- P60D (60 days)
Duration can be also provided in hours, e.g. PT72H (3 days).
Shipping rates #
In this field, you are required to input the shipping rates identifier. It’s important to note that shipping rates must be created beforehand on your Allegro account. Please refer to the relevant section for more details on this process.
Tax settings section #
In this section, you are required to furnish details concerning VAT rates. You should choose the tax rate corresponding to the country and map its value from plentymarkets.
After sales section #
Within this section, you should provide the definitions for the three distinct after-sales services associated with the offer.
- Implied Warranty
- Return Policy
- Warranty
These after-sales services should also be established within your Allegro account. For further details, please consult the relevant section.
Parameters section #
Each Allegro category comes with its own set of parameters, which can vary in terms of quantity and type. As a result, each catalogue template will include distinct parameters. In this section, you will discover detailed guidance on how to handle these parameters effectively.
Free text parameters #
On Allegro, there may be parameters where you have the freedom to input free text values. For such parameters, simply assign a meaningful text value.
Parameters with selection values #
Allegro also includes parameters that require predefined values. In such cases, you can choose an Allegro value from a list and match it with the selected value from Plentymarkets.
Parameters with multi-selection #
For certain Allegro properties, it is possible to select and provide multiple values. These properties are indicated with the label “[Multiple values allowed].”
Creating offers using EAN matching. #
As stated before using this method you can list offers on Allegro easily, by providing just information for name, price and stock.
In certain situations, you may wish to replace the default Allegro values with your own preferences. For instance, if you want to use your custom images instead of Allegro’s, you can easily achieve this by mapping your image values to the catalog. Your images will then take precedence over the existing ones.
The same principle applies to properties. If you wish to include or replace properties for offers listed by EAN, we’ve introduced a prefix for each properties section: “Overwrite for GTIN only.” This indicates that the mapping data will only be applied to offers listed by EAN and won’t impact offers created from the beginning.
Creating offers from scratch #
In cases when offers are not found by EAN or you want to create them from scratch, you must to provide all required data.
Required data is marked with the star symbol ( * )
