Channable
Globe icon
English (US) Deutsch Español Français Italiano Nederlands
  1. Help Center - Channable
  2. Channels - Marketplaces
  3. Other channel setups

Articles in this section

See more

How to set up an Allegro channel

Allegro is a popular Polish marketplace that primarily focuses on electronics, garden, lifestyle, and fashion items.

In this article, you'll learn how to set up an Allegro channel to create, update and manage your Allegro listings within Channable.

Contents

Before you start

There are some things you should know before you start:

You’ll need

  • An Allegro seller account 
  • The following policies set up in your Allegro seller account:
    • Warranty
    • Returns
    • Delivery
    • Terms of complaints
  • A project in Channable with your imported products

Good to know

Step 1: Create your Allegro channel

  1. In your Channable account, go to Channels.
  2. Search for and select Allegro.
  3. Set up your channel settings:
    1. For Name, choose a name for your channel.
    2. For Unique ID per item, select the field containing your product IDs. (This is often ‘id’).
    3. For Use master rule group (optional), add a master rule group or leave this empty.
  4. Click Save.

Step 2: Categorize your products

  1. In [your Allegro channel], go to the Categories step.
  2. Our AI will automatically start to categorize your products to corresponding categories on Allegro.
  3. Map (assign) categories for all remaining uncategorized items.

Learn more about categorizing for marketplaces

Step 3: Create rules to enrich, filter, and refine your product data

When your product data is incomplete or doesn’t match the format that Allegro requires, you can use rules to tweak and optimize your product data to meet listing requirements. 

  1. In [your Allegro channel], go to the Rules step.
  2. Click Create rule.
  3. Use rule templates or create a custom rule based on what you would like to adjust. 
  4. Click Save.

For more information on how to set up a rule, or rule combinations, refer to our rules articles.

Step 4: Map shared attributes

Shared attributes are the common fields that apply across your products, such as EAN, prices, and titles. This step ensures uniformity in basic product information across your listings.

  1. In [your Allegro channel], go to the Build step.
  2. Map any attributes marked as Required by marketplace. 
  3. Go over and map any remaining attributes that are relevant for your business.
  4. Click Save.

Tip: Click Auto-map fields and our AI will automatically map attributes according to data from similar setups. 

Step 5: Map category attributes

  1. In the Build step, click on the Attributes per category tab.
  1. Click on your first category.
  2. Map any attributes marked as Required by marketplace. 
  3. Go over and map any remaining attributes that are relevant for your business.
  4. Click Save.
  5. Repeat this process for your remaining categories.

Tip: Click Auto-map fields and our AI will automatically map attributes according to data from similar setups. 

Additional requirements for Allegro

In addition to the previous steps, you need to consider and configure the following information specifically for Allegro.

Good to know

  • Allegro may auto-fill empty fields: Allegro sometimes automatically fills in fields if nothing is provided or mapped.
    • E.g. The Selling mode format attribute is set to BUY_NOW if the submitted field is empty. 
    • E.g. The Publication starts date attribute is set to Offer will be activated immediately if the field is empty.
  • Parent/Child Structure: Allegro manages parent/child structures based on the product information included in your listings. You do not need to set up anything in Channable to create grouped listings.

Build step - Shared attributes

GPSR 

To comply with GPSR for Allegro, you’ll need to provide product safety information, your Producers data and Persons responsible. 

Retrieving your responsible person and producers data

  1. In your Allegro Sales Center, go to Sales Settings.
  2. Click Producers data and provide the information requested. 
  3. Return to the previous page and click Sales Settings again.
  4. Click Persons responsible and provide the information requested. 

Adding it in Channable

  1. In your Allegro channel in Channable, go to the Build step.
  2. In the Shared attributes tab, at the Responsibility and safety (GPSR) section, provide your Producers data and Persons responsible information:
    1. Click the dropdown > Manual and fill in the name.
  3. Click Save. 

Adding Type of safety information:

  1. In the Shared attributes tab in the Build step, scroll to the Responsibility and safety (GPSR) section.
  2. For Type of safety information, select TEXT.
  3. For Safety information description: 
    1. If your product safety information applies to all your products: Click Manual and paste your product safety information in the provided field.
    2. If your product safety information differs per product: Create a new project field, add information to it with a rule, then map the field here (select Project field > [field containing your product safety information]).
  4. Click Save.
  5. Click Run now to update your listings.
Note: You can find more information about GPSR requirements for Allegro in their GPSR article.

Payment and taxes

  • Currency: Check that the currency matches the market you’re targeting (e.g., Poland ⇾ PLN).

Delivery and Shipping 

  • Handling Time: Allegro uses specific formats for handling time. Check that you’re using the correct format:
Format Handling Time
PT0S Immediately
PT24H 24 hours
PT2D 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

You can manually fill in a fixed handling time for all your products in the Build step.

Note: If you have different handling times, set up a rule to dynamically insert the correct handling time for each item.

Example rule:

If stock is greater than "2"

Then take handling time and set to value "PT24H"

Else

Take handling time and set to value "P7D

Images and description

Descriptions: Allegro requires descriptions to use HTML. To avoid errors, format your description in HTML.

  • To quickly convert your description to HTML, create a rule to next your descriptions between <p></p>:

Rule example:

If all

Then take descriptionand combine value "<p>" "description" "<p>"

  • To create well-formatted descriptions using HTML, use the following tags to format your descriptions:
HTML Tag Usage
<h1> Title
<h2> Subtitle
<p> Paragraph
<ul> Bullet Points
<ol> Numbered List
<li> List Items
<b> Bold Text

Relisting offers

Important: By default, your offers automatically republish as soon as they expire. This means even if your listing is unpublished due to no stock, it will be instantly relisted if Publication should republish is set to true.

If you don't want to have your offers automatically republished, you can change your publication settings in the Build step.

  1. In the Build step, go to the Shared attributes tab.
  2. In the Item section, set Publication should republish to false.

Note: Interested in manually relisting your products for Allegro? Contact our Support team to let us know. Your inputs helps us prioritize future features.

Selling Policies

At After sales services you can submit your selling policies by mapping fields containing your policy information. Allegro will link your products to the policies set up in your Allegro seller account using the policy names. 

To ensure each product is linked to the correct policy, fill in the names of each policy in their appropriate fields:

  1. Click the dropdown, select Manual value and type the name of the corresponding policy in the text box. 

If you use multiple selling policies, add new fields in your import mapping and fill in the policy names using dynamic rules. 

Step 6: Connect to Allegro

To send your listings to Allegro, you need to connect your channel to your Allegro seller account.

Important: Nothing will change in your Allegro account - any existing listings stay exactly the same until you activate.
  1. Log in to your Allegro seller account.
  2. In [your Allegro channel], go to Settings.
  3. At Linked seller account, click Select seller account. 
  4. Select an existing seller account, or click + Add new connection to add a new seller account.
    1. If adding a new seller account:
      1. For Label: Name your seller account connection.
      2. Click Connect with Allegro. 
  5. We'll redirect you to Allegro to log in with your credentials and accept permissions.

Step 7: Activate your channel

  1. Go to the Settings step of [your Allegro channel].
  2. Click Activate API.
  3. Click Save.
  4. Click Run now to send your product listings to Allegro.

To see which product listings are now active on Allegro, go to the Preview step.

Step 8: Review and fix listing errors

Important: Allegro may not return all errors in one go, so multiple runs might be necessary to get all your products up and running.

Go to the Result step and click on the Errors tab. This page displays all possible processing errors your product data has at a given moment.

Resolving errors:

  1. In Description, click on the error name. This takes you to an overview of the products with that error.
  2. In ID, click the ID number and scroll. You should see a red highlighted callout in the section where the error occurred. You can hover over the callout for more information.
    1. If the error is a mapping error, click View in build to be directed to the attribute you need to map/re-map. The offending attribute is highlighted in blue. For more information about the attribute and its accepted values, hover over the ? icon.
  3. Resolve the error.

Common Errors and Solutions

VALIDATION ERROR

Generated by Allegro to prevent repeated exporter runs for preventable errors (e.g., empty price fields or wrong HTML tags).

Solution:

Fix the associated data shown in the error message to resolve this issue.

Allegro has a specific set of HTML features that it supports, as described here. Allegro expects the description to be in HTML format, so removing all HTML will not resolve the issue.

Channable VALIDATION ERROR

Generated by Channable to prevent repeated exporter runs for preventable errors.

Solution:

Fix the associated data shown in the error message to resolve this issue.

PARAMETER_MISMATCH

Occurs when the EAN-/GTIN-code is already known on Allegro, but an attribute submitted does not match Allegro's expected value.

Solution:

Change the attribute value to the suggested value shown in the error message.

CATEGORY_MISMATCH

Allegro expects an item in a specific category, but a different category is submitted.

Solution:

Change your category setup to match the correct value shown in the error message.

Attribute Value Error

Channable tries to create a new allowed value for an attribute, but Allegro indicates the value is already known with different capitalization or spacing.

Solution:

Modify the attribute value to match the values in Allegro's “allowed values” list, including capitalization and spacing.