# How to set up an Allegro channel
{% hint style="warning" %}
Allegro is a popular Polish marketplace and Channable supports Allegro for **Poland only**.
{% endhint %}
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](https://allegro.pl/rejestracja/konto-firmowe/nowe-konto?affiliation=onboardingIS)
* 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](https://allegro.pl/regulamin/zalacznik/4)
* By default, your Allegro offers are automatically relisted once the existing offer ends. Learn more.
* Visit [Allegro’s Help Center](https://allegro.pl/articles/international-sellers) to learn about the basics of selling on Allegro:
* [How does the Allegro Marketplace work?](https://allegro.pl/articles/international-sellers/how-does-the-marketplace-buy-and-sell-work-WvKkxx6jAf9#how-to-sell-on-allegro-)
* [Information on Allegro Smart](https://allegro.pl/smart/international-sellers)
* [What is Allegro’s One Fulfillment program?](https://allegro.pl/campaign/fulfillment?srsltid=AfmBOoqJ__K3-TBaMj8noBZSuKi17ZZCjRdB2e6m6iNoz44CQBAmP3e0)
* **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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-categorization-step)
### **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](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) to tweak and optimize your product data to meet listing requirements.[ ](https://helpcenter.channable.com/hc/en-us/articles/360011132679)
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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step).
### **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**.
{% hint style="success" %}
**Tip:** Click **Auto-map fields** and our AI will automatically map attributes according to data from similar setups.
{% endhint %}
### **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.
{% hint style="success" %}
**Tip:** Click **Auto-map fields** and our AI will automatically map attributes according to data from similar setups.
{% endhint %}
### **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](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields), add information to it with a [rule](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules), 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.
{% hint style="info" %}
**Note:** You can find more information about GPSR requirements for Allegro in their [GPSR article](https://help.allegro.com/sell/en/a/what-obligations-the-gpsr-imposes-on-you-b25l85Xz6ib).
{% endhint %}
**Payment and taxes**
* **Currency:** Check that the currency matches 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 \\
:
**Rule example:**
**If** `all`
**Then** take `description`and `combine value` "``" "`description`" "`
`"
* To create well-formatted descriptions using HTML, use the following tags to format your descriptions:
| **HTML Tag** | **Usage** |
| ------------ | ------------- |
| \
| Title |
| \ | Subtitle |
| \
| Paragraph |
| \
| Bullet Points |
| \ | Numbered List |
| \- | List Items |
| \ | 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`.
{% hint style="info" %}
**Note:** Interested in manually relisting your products for Allegro? [Contact our Support team](https://www.channable.com/contact) to let us know. Your inputs helps us prioritize future features.
{% endhint %}
**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](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) 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.
{% hint style="warning" %}
**Important:** Nothing will change in your Allegro account - any existing listings stay exactly the same until you activate.
{% endhint %}
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
{% hint style="warning" %}
**Important:** Allegro may not return all errors in one run. Multiple runs may be necessary.
{% endhint %}
* 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](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA#own-images-and-description)
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.