The Allegro product feed is used to upload product data to the Allegro marketplace. The API integration offers instant synchronization.
Register on Allegro
Sign up for an account on Allegro. For more information, please check:
Create Allegro feed
Add the Allegro product feed to your profile grid. For more details, please check the manual below:
Allegro Category Mapping
Please map your store categories to Allegro categories.
Attribute Mapping Setup - Mandatory attributes
Please double-check that the Allegro mandatory attributes below are duly mapped to your store attributes.
external_id
External product id, Allegro's reference number. This attribute is used as an order pairing identifier.
stock_unit
Stock unit
Options are:
UNIT
PAIR
SET
stock_available
Quantity of this offer available for sale - how many times this offer can be sold. Offer can be activated only with stock being greater then 0. Setting this quantity to 0 for 'ACTIVE' or 'ACTIVATING' offer will trigger changing its status to 'ENDED'.
product_category_id
Category in which the offer is listed for sale. You can indicate a category from the product's 'similar categories' to set the offer's category.
product_name
Product name
product_description
Product description. Allegro requires an HTML style for the Description attribute. Koongo automatically adds HTML 'p' tags if there is no HTML in the Description. Allegro enforces strict rules for product description formatting, allowing only certain HTML tags such as <h1>, <h2>, <p>, <ul>, and <ol>. Using disallowed tags, such as <h3>, will result in validation errors and prevent your listings from being published.
sellingMode_price_currency
Currency.
sellingMode_price_amount
The buy now or advertisement price (depending on the offer's format).
delivery_handlingTime
Publication duration, ISO 8601 duration format. This field must be set to one of the following: PT0S for immediately
Options are:
PT0S - immediately
PT24H - 24 hours
P2D - 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
tax_rate
The tax rate for PL, CZ, SK or HU.
Possible values:
PL - 23.00
CZ - 21.00
SK - 20.00
HU - 27.00
GPSR Responsible Person Name
Please use the 'Proper name' value from the Persons responsible for the product compliance form defined on your Allegro account.
GPSR Responsible Producer Name
Please use the 'Proper name' value from the Producers data form defined on your Allegro account.
GPSR Safety Information Description
Safety warnings and instructions for the product in plain text form, if the information cannot be provided through attachments. Text can't be longer than 5000 characters.
product_idType
Type of id. This field is optional. It helps in finding products more accurately. If an idType is not set, a given id is understood as a product's id. GTIN - restricts the search filtering to GTINs (Global Trade Item Number), e.g. EAN, ISBN, UPC. MPN - restricts the search filtering to MPNs (Manufacturer Part Number). For products in categories requiring a Global Trade Item Number (GTIN), Allegro mandates valid EAN-13 values, which must be exactly 13 digits long. Missing or malformed EANs will result in listing rejections.
Set up your Allegro Connection
Connect the Allegro feed to your Allegro account by clicking the Connect Allegro Account button.
Download Allegro's additional (custom) attributes
Once you map your store categories to Allegro categories and set up API connection, you can download additional mandatory Allegro attributes via API using the "Get Allegro Attributes" button.
Common Issues and Solutions for Integrating Shopify with Allegro
Integrating Shopify with Allegro can streamline your e-commerce operations, but it requires adherence to Allegro's specific requirements. This section outlines common issues encountered during the integration process and provides actionable solutions to ensure a smooth experience.
Formatting Product Descriptions
Allegro enforces strict rules for product description formatting, particularly regarding HTML tags. Only certain HTML tags are permitted, such as <h1>, <h2>, <p>, <ul>, and <ol>. Using disallowed tags, such as <h3>, will result in validation errors and prevent your listings from being published.
Solution:
Remove Disallowed HTML Tags: Ensure that your product descriptions do not include any HTML tags outside of Allegro's allowed set.
Sanitize Descriptions: A reliable approach is to strip all HTML tags from your descriptions to avoid formatting issues entirely.
Test Before Submission: Validate your descriptions against Allegro's requirements to identify and correct any errors before submission.
Validating EAN-13 Values
For products in categories that require a Global Trade Item Number (GTIN), Allegro mandates the use of valid EAN-13 values. These values must be exactly 13 digits long. Missing or malformed EANs will result in listing rejections.
Solution:
Preprocess EAN Data: Implement a preprocessing step to validate and correct EAN-13 values in your product data.
Normalize formatting by removing non-numeric characters.
Reject or flag values that are not exactly 13 digits long.
Automate Validation: Use rule-based tools or scripts to ensure all EAN-13 values meet Allegro's standards before submission.
Best Practices for Compliance
To minimize errors and ensure successful integration:
Stay Updated: Regularly review Allegro's documentation for updates to their requirements.
Automate Checks: Use tools or scripts to automate the validation of product descriptions and EAN-13 values.
Test Listings: Before submitting your listings, test them in a sandbox environment to identify and resolve potential issues.
By following these guidelines, you can avoid common pitfalls and ensure a seamless integration between Shopify and Allegro.
Channel setup assistance
Do you need help with a channel setup? Please feel free to reach us at support@koongo.com.
We'll be happy to help you with your integration.