Setting up a Allegro API

To start selling your products on the Allegro marketplace, you will need to have an Allegro seller account. If you don't have an Allegro seller account yet, you can sign up for a Seller Account on this page. Once you have established an Allegro seller account, you can connect with Channable.

Table of contents

1. Preparation
2. Create a new connection
3. Create the API
4. Create your product listings
5. Send your product listings to Allegro
6. Check your product listings for errors

Preparation

• Set up sales policies: Make sure you have established the policies, which can be found under sales settings in your allegro account.  You will need the names of these policies during setup in Channable: 
  • A warranty policy
  • A return policy
  • Delivery settings
  • Terms of Complaints policy
• Understand fees and commissions: gain insights on listing fees and sales commissions in order to better manage your sales strategy. Information on listing fees and sales commissions can be found here.
• Visit allegro's help center for international sellers: Before proceeding with the API setup, read through the basics about selling on allegro, account setup requests, and navigation tips here. Additionally, we recommend the following articles:
  
  • How does the Allegro Marketplace work? 
  • Information on Allegro Smart
  • What is Allegro’s One Fulfillment program? 

Step 1: Create a new connection

To create a new Allegro connection, follow the steps below:

1. Start by navigating to the API page within your project and click on the “+Add new API” button. This action will redirect you to your company's connections page.
   
2. On the connections page, select “+Add a new connection”.
3. Search for the 'Allegro' connection by clicking through the pages, after finding the 'Allegro' connection, provide a label for this new connection.
   
4. Click on “Connect with Allegro” You will be redirected to Allegro for the next step. Once redirected, log in using Allegro credentials.

After successfully logging in, the connection with Allegro is established and available for use! You will be brought back to the API setup.

Step 2: Create the API

Upon returning, you must select your new connection with Allegro and continue setting up your API.

1. Configure API settings:
   • Name your API
   • Select the language of your API
   • Choose the unique ID per item. (we recommend the 'id' field)
     
     
2. Create API: Click on “Continue” to create the new Allegro API.

Step 3: Create your product listings

To set up your API, follow the steps outlined below. Click on each step to expand and view the detailed instructions, which will guide you through the entire process.

1. Categorization

2. Rules

3. Build step

The Build step in Channable allows you to configure all necessary attributes for your items, ensuring your product data aligns with marketplace requirements. This step is crucial for successful product listings and avoiding errors.

3.1 Overview

1. Access the Build step: Start by accessing the centralized interface of the Build step. This is where you will manage and map all product attributes.
2. Identify mandatory and optional Fields: Mandatory fields are highlighted in pink, indicating they are essential for listing your products. Optional fields are marked in orange and can be filled based on specific needs.

3.2 Populate Shared Attributes

1. Fill Shared Attributes: Enter common details that apply to all 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: Directly input values that remain constant, like brand name or manufacturer.
     • Dynamic Values: Utilize fields that automatically update based on linked data, ideal for variables like stock levels or prices.

After you have filled in the desired values for the Shared attributes, continue to the Category specific attributes below.

3.3 Specify Category-Specific Attributes

1. Select product category: Choose the relevant category for your product, such as clothing or furniture.
2. Input Category - specific attributes: Fill in attributes that are specific to the selected category, such as size for clothing or dimensions for furniture. This step helps in fine-tuning your listings according to category requirements. Here you can again use static or dynamic values.

Click here to read more about the Build step.

4. Quality step

The quality step provides instant feedback on setup quality, highlighting mandatory and optional errors to ensure your product data meets the marketplaces' standards.

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, directing to the settings step.

Click here to read more about the Quality step.

5. Preview step

The preview step displays mapped attributes for multiple items, highlighting errors before exporting to the marketplace.

Features

• Search & filter: Find specific products or filter by error message/category.
• Item overview: Shows all items to be exported; it can filter to show only items with errors.
• Detailed product preview: Displays missing information and dynamic actions to correct errors.

Checklist for finalizing attributes

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

Click here to read more about the Preview step.

6. Result step

Additional Requirements for Allegro

The following information is specific to Allegro, we discuss per tab what you should look out for.

Item Tab

• Currency: Ensure the currency matches the market you are targeting (e.g., Poland ⇾ PLN).

Delivery and Shipping tab

• Handling Time: Allegro uses specific formats for handling time. Accepted values are:
  You can manually fill in a fixed handling time for all your products in the Build-step.
  

  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

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

Images and Descriptions

• Formatting descriptions: Allegro requires descriptions to use HTML. To avoid errors, ensure your descriptions include the following HTML tags:

  HTML Tag	Usage
  <h1>	Title
  <h2>	Subtitle
  <p>	Paragraph
  <ul>	Bullet Points
  <ol>	Numbered List
  <li>	List Items
  <b>	Bold Text

  You can create detailed descriptions using these tags, or encapsulate your entire dynamic description field in one go by creating a rule like the one below:
  

Additional Options

• Selling Policies: In the 'After sales services' tab, you can submit your selling policies. 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 by creating a manual value. If you use multiple selling policies, add new fields in your import mapping and fill in the policy names using dynamic rules. 

Additional information

• Leaving fields empty: Allegro will automatically fill in a specific set of fields if they are left empty. For example, the field 'Selling mode format' will be set to “BUY_NOW” if the submitted field is empty. Similarly, if the 'Publication starts date' is left blank, Allegro will interpret this as “Offer will be activated immediately”. 

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

Following these guidelines will help you make sure your Allegro listings are set up correctly and in line with their requirements.

Step 4: Send your products to Allegro

Almost there, your product listings are ready to be sent. If you have not activated your project, go to Settings> Project settings on the left-hand side of the screen and click 'activate project'. After, go back to the APIs overview and go to “Your Allegro API Name” > Settings, where you activate the API by selecting “Activate API”. After you have completed this step, navigate back to the APIs overview and select the blue “Run now” button to send your product listings to Allegro.

Step 5: Check your product listings for errors

To check for errors, navigate to the Result page of the API > Errors tab, where you see which product listings have errors. By clicking on the specific, it will display more information on what is causing the error.

Common Errors and Solutions

To help you efficiently handle common errors when using Channable with Allegro, we’ve detailed some typical errors and their solutions below. This table provides clear, actionable steps to resolve these issues.

By following these guidelines and using the table above, you can ensure that your Allegro listings are properly configured and free of errors, leading to a smoother integration process with Channable.