In this article, we will explain how to set up an Allegro API in Channable, we will do this by following the steps below:

• Before starting the setup
• Step 1: Add a new Allegro connection in Channable
• Step 2: Add a new Allegro API in Channable
• Step 3: Create your product listings
• Step 4: Send your products to Allegro
• Step 5: Check your product listings for errors

Before starting the setup

As with any other marketplace, selling on Allegro requires you to have an Allegro Seller Account. You can sign up for a Seller Account on this page. 

Before setting up the Allegro-API we highly recommend you to read through Allegro’s Help Center for International Sellers. Here you will find the basics about selling on Allegro, how to request and set up your account, and how to navigate through your seller account. You will also find information on listing fees and sales commissions. 

Other articles we recommend: 

• How does the Allegro Marketplace work? 
• Information on Allegro Smart
• What is Allegro’s One Fulfillment program? 

If you have an Allegro Seller account, make sure you have set up the following in the account before starting the setup in Channable: 

1. A warranty policy
2. A return policy
3. Delivery settings
4. Terms of Complaints policy

You can find this under Sales Settings in your Allegro account, where you’ll be asked to name each of these policies. You will need these names during the setup process.

With your Allegro Seller account set up, it is time to set up the exporter in Channable. 

Setting up the API

Step 1: Add a new Allegro connection in Channable

To create a new Allegro connection, click on "[Your company name at the top right] > Connections > "+Add a new connection". You will see the screen below, where you can select Allegro:

After clicking the "Connect with Allegro" button you will be redirected to the Allegro seller environment, where you can log in using your Allegro login credentials.

Step 2: Add a new Allegro API in Channable

Now go to the API's overview, in your project. Click on Add new API, Select the Allegro connection you just made, and give your new API a name.

Select the field you want to use for the Unique ID per item (we recommend the 'id' field). You can also add a master rule group here if you want. Click on "Continue" to finish creating the new Allegro API.

Step 3: Create your product listings

1. Categories
   Add categories to your products by using the generate categories feature or create new categories from scratch. If Allegro already knows the EAN code of your products and you submit a different category than is known on Allegro, you will see a ‘Category_Mismatch’ error in the result. To avoid these errors, we recommend cross-checking the correct category for your items on the Allegro.pl storefront.
   
   
2. Rules
   Create different rules to optimize your product data. Visit our article on common rules if you want to see an example. Be sure to include the following rules to avoid errors:
   

   You can create a detailed description using these HTML tags. Alternatively, you can encapsulate your entire description in one paragraph by creating this rule: 
   
   

   • Filling in your handling time
     Allegro uses specific formats for handling time. See below for a list of accepted values: 
     1. PT0S: Immediately
     2. PT24H: 24 hours
     3. PT2D: 2 days
     4. P3D: 3 days
     5. P4D: 4 days
     6. P5D: 5 days
     7. P7D: 7 days
     8. P10D: 10 days
     9. P14D: 14 days
     10. P21D: 21 days
     11. P30D: 30 days
     12. P60D: 60 days

   You can manually fill in a fixed handling time for all your products in the Build-step. If you maintain different handling times, set up a rule to dynamically insert different handling times per item.

   
   
   • Formatting descriptions:
     Allegro expects descriptions to make use of HTML. In order to prevent any errors, adjust your descriptions accordingly. The following HTML tags are allowed on Allegro: 
     1. <h1> </h1> for a title
     2. <h2> </h2 for a subtitle
     3. <p> </p> for a paragraph
     4. <st> </st> for bullet points
     5. <ol> </ol> for a numbered list
     6. <li> </li> for an item in the list
     7. <b> </b> for bold font
        
        
3. Build
   You can fill in the information in the template by clicking on the field and selecting an imported field or manually typing a value. For example, you can map your imported field title to the "Title" field of the template.
   
   Selling policies
   The build-step is where you can submit the earlier-mentioned policies. Allegro will link your products to the selling policies you have set up in your Allegro seller account using the names of these policies. To ensure each product is linked to the correct selling policy, fill in the names of each of these policies 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 names of policies using dynamic rules. 
   
   
   Leaving fields empty
   A final good to know: Allegro will fill in a specific set of fields themselves in case these fields are empty. For example: the field ‘Selling mode format’ will be set to “BUY_NOW” if the submitted field is empty. Or when you leave the "Publication start date" empty, Allegro will read this as "Offer will be activated immediately".
   
   Creating a parent/child structure on Allegro
   Allegro manages this differently from other platforms. Rather than having sellers tell Allegro what the children are, Allegro determines this themselves based on the product information that is included in your listings. This means that you do not have to set up anything in Channable to create grouped listings.
   
   
4. Attributes
   In the "Attributes" section, select the category you want to optimize first. For each attribute, you can fill in a static value or use a field.  A more detailed explanation can be found in our Attributes support article.
   

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

After you have sent your product listings to Allegro, go to the Results tab of your Allegro API. Click in the tabs on 'error'. Now you can see which product listings have errors and are not placed. Click on a specific error to see more information on what is causing the error.

Below you can find the most common errors and how to solve them:

• VALIDATION ERROR
  This is an error generated by Channable. To prevent you from having to run the exporter over and over until these errors are fixed for errors that can be prevented during setup, we have inserted validation on our side. This means that this error will appear for data that we know will error out - think of empty price fields or wrong HTML tags in your description. You can solve this by fixing the associated data shown in the error message.  
  
  
• PARAMETER_MISMATCH
  This error appears when the EAN-/GTIN-code is already known on Allegro and you have submitted an attribute that does not match what Allegro expects.
  Channable tries to update the product but is unable to do so due to this error. The product will still be online if the listing was already created but with unchanged stock/price values. You can solve this error by changing the value in the attribute to the suggested value of Allegro. This suggested value is shown in the error message. 
  
  
• CATEGORY_MISMATCH
  This error is similar to the earlier mentioned Parameter Mismatch but for categories. Allegro expects an item to fit in a specific category, but you have submitted a different category. You can fix this by changing your category setup. The correct value is shown in the error message.
  
  
• Attribute value in possible values
  Channable tries to create a new allowed value for a specific attribute, but Allegro indicates that the value is already known in their allowed values. There may be a difference in capital letters, lower letters, or whitespaces, which causes the error.
  In order to fix this you will need to modify the value you currently set in the attributes to the values displayed in the “allowed values” list, including capitalization, lower letters, whitespaces, and accents. You can find this list of allowed values in the Attributes step.  For example, if you have set up “Channable” as an attribute and Allegro shows “channable” as an allowed value, you will have to set this value to “channable” in the rules.