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

Contents

  1. Create an Allegro connection
  2. Set up your channel
  3. Create product listings
  4. Activate your channel
  5. Review and fix listing errors

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 an Allegro connection

  1. In your Channable account, create a new project or select an existing project to add your Allegro channel to.
  2. In the sidebar, go to Channels > + Create channel, search for Allegro and click + Add a new connection.
  3. Select Allegro. For Label, give your Allegro channel a descriptive name.
    Note: This name is only used in Channable to help you distinguish between channels.
  4. Click Connect with Allegro. We’ll redirect you to Allegro to log in and authenticate your connection.

After you log in, you’ll automatically be directed back to continue setting up your channel.

 

Step 2: Set up your channel

  1. Select your new Amazon channel.
    • For Name, choose a name for your channel.
    • For Unique ID per item, select the field containing your product IDs. (This is often ‘id’).
    • For Use master rule group (optional), add a master rule group or leave this empty.
  2. Click Continue.

 

Step 3: Create product listings

Note: We're gradually rolling out Marketplaces V2. If you're still using Marketplaces V1 your steps might look a little different.

Follow these steps to set up your channel:

1. Categorize your products

To set up your product data, assign categories to your products.

  • Smart Categorization: Automatically assigns product categories through our algorithm.
  • Manual Categorization: Manually assign product categories with custom rules. You can create detailed filters to map each product to the correct category.
  • Uncategorized Items: Products that still need to be reviewed and categorized

Learn more about categorizing for marketplaces

2. Set up rules

Rules help you quickly optimize your product data for the marketplace you want to sell on.

  • Rule templates: Commonly used rules you can adjust for your use case.
  • Rules setup: Set up rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.

Read more about using rules for marketplaces

3. Build your listings

The Build step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.

Mandatory and optional fields: 

  • Mandatory fields : Required to list your products on this marketplace
  • Recommended : Recommended to avoid errors
  • Optional : Not required to list

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.

  • Use static or dynamic Values:
    • Static values: Fixed values that don’t change (e.g. brand name, manufacturer)
    • Dynamic values: Fields that automatically change based on the linked data (e.g. stock, prices)

Category-specific attributes

Category-specific attributes fields that specifically apply to the category for your products .This step helps in fine-tune your listings to meet category requirements for your marketplace.

Fill in attributes that are specific to the selected category (e.g. such size for clothing or dimensions for furniture.) 

Tip: Click Auto-map fields to automatically map categories with information previously provided in the same channel. Learn more.

Learn more about the Build step for marketplaces

 

4. Check the quality of your set up

The Quality step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.

  1. Solve errors, prioritizing mandatory errors first.

Actions

  • View items: See products with specific issues.
  • View in build: Redirects to the Build step to map missing information.
  • Set categories: Directs to the Categories step to categorize items.
  • Show source: Available for ID fields. Directs to the Settings step.

Learn more about the Quality step for marketplaces

5. Preview before activating

The Preview step displays the attributes you mapped in the Build step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.

Filtering:

  • Filter by error: Click the All dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
  • Filter by category: Click the All categories dropdown and select the category you want to filter by.

Before you continue:

  • Review Shared attributes: Ensure all mandatory shared attributes are filled.
  • Review Category-specific attributes: Ensure all mandatory category-specific attributes are filled.
  • Check for errors: Correct any red-marked fields.

Learn more about the Preview step for marketplaces

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 information on your Producers data and Persons responsible. You can find this information in your Allegro Sales Center. 

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. 

In Channable

  1. In the Build step, go to the Shared attributes tab.
  2. 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. For Type of safety information:
  • If you have containing labels and certifications to add to your listings, click the dropdown and select TEXT.
  • If your products were placed on the EU market before GPSR became mandatory (13/12/24), select the value NO_SAFETY_INFORMATION. 
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

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 5: Activate your channel

  1. Select the Settings step in [your Allegro channel] and click Activate API.
  2. Click Save.
  3. Click X to return to the Channel overview page. 
  4. Click Run now to send your product listings to Allegro.

 

Step 6: 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.