How to set up an Allegro channel

Allegro is a popular Polish marketplace listing in Poland, Hungary, the Czech Republic, and Slovakia.

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

---

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

• How listings fees and sales commissions work on Allegro

• By default, your Allegro offers are automatically relisted once the existing offer ends. Learn more.

• Visit Allegro’s Help Center to learn about the basics of selling on Allegro:

  • How does the Allegro Marketplace work?

  • Information on Allegro Smart

  • What is Allegro’s One Fulfillment program?

• Product-listing variations: Some product categories on Allegro support product-listing variations (parent/child structures).

  • If a category supports variations: Allegro will automatically create variants based on your product information.

  • If a category doesn't support variations: No variants will be created. There is currently no other way to create variant listings on Allegro for your products in Channable.

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.

2. Click on your first category.

3. Map any attributes marked as Required by marketplace.

4. Go over and map any remaining attributes that are relevant for your business.

5. Click Save.

6. 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. Select Settings in [your Allegro channel] and click Activate API.

2. Click Save.

3. Click Run now to send your product listings to Allegro.

Step 8: Review and fix listing errors

Important: Allegro may not return all errors in one run. Multiple runs may be necessary.

• Go to the Result step and click the Feedback tab. This displays processing errors for your product data at that moment.

Resolving errors:

1. In Description, click the error name to see products with that error.

2. In ID, click the ID number and scroll to find a red highlighted callout where the error occurred. Hover the callout for more info.

   • If it’s a mapping error, click View in build to go to the attribute to map/re-map. The offending attribute is highlighted in blue. For attribute info and accepted values, hover the ? icon.

3. Resolve the error.

Common Errors and Solutions (expandable)

• Use each expandable to view details and solutions for common errors.

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.

• Note: Allegro supports a specific set of HTML features (see Allegro docs). Allegro expects descriptions in HTML; removing HTML will not resolve the issue.

Reference

Channable VALIDATION ERROR

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

Solution:

• Fix the associated data shown in the error message.

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 was 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 Allegro’s allowed values list, including capitalization and spacing.