Allegro Integration: REST API, Smart!, Allegro Pay & Unified Store Management

About Allegro: History, Ownership and Market Position

Foundation and Timeline (1999 – Today)

Allegro was launched in December 1999 in Poznań by Dutch entrepreneur Arjan Bakker as an online auction platform — Poland's eBay equivalent. By the mid-2000s it had become the country's default marketplace. In 2008 it was acquired by South African media conglomerate Naspers, which operated it as part of its global classifieds and e-commerce portfolio for nearly a decade.

In October 2016, a private-equity consortium of Permira, Cinven and Mid Europa Partners announced the acquisition of Allegro for approximately $3.25 billion — at the time the largest leveraged buyout ever recorded in Central and Eastern Europe. On 12 October 2020 the company debuted on the Warsaw Stock Exchange under the ticker WSE:ALE at a valuation of approximately €11 billion, making it the largest IPO in Polish history. Today Allegro Group operates the core marketplace, Allegro Smart! subscription, Allegro Pay BNPL, One Fulfillment, Allegro Lokalnie (C2C) and Allegro Ceneo (price comparison) — a vertically integrated commerce ecosystem headquartered in Poznań with major offices in Warsaw.

Allegro Ownership Structure (2025)

• Free float (WSE:ALE) — Majority of shares trade publicly on the Warsaw Stock Exchange since the 2020 IPO
• Cinven, Permira, Mid Europa Partners — Original PE sponsors, gradual exit through secondary placements 2021–2024
• Institutional investors — Polish pension funds (OFE), BlackRock, Vanguard, Norges Bank
• Allegro.eu S.A. — Luxembourg-incorporated parent holding company
• Management & employees — Long-term incentive plan (LTI) stock

Position in Polish E-Commerce

As of 2024, Allegro commands roughly 45–50% of Poland's online retail spend — well ahead of Amazon.pl, Empik and emerging Chinese platforms. An estimated 80% of Polish online shoppers have an Allegro account, and the Allegro mobile app is consistently Poland's #1 shopping app on Google Play and the App Store.

Allegro Sales Volume and Scale (2024–2025 Data)

Allegro has compounded steadily since its 2020 IPO, scaling GMV faster than Polish e-commerce as a whole. International expansion into the Czech Republic, Slovakia and Hungary (via the 2022 Mall Group acquisition) added a second growth engine on top of the dominant Polish core.

Year	Poland GMV (EUR)	Orders	Active Buyers	Active 3P Sellers
2020	~€8 billion	350 million	13M	90K
2022	~€12 billion	540 million	18M	110K
2024	~€15 billion	~680 million	22M+	130K+
2025 (forecast)	~€17 billion	~750 million	24M	150K

Growth has been driven by the maturity of Allegro Smart! (now exceeding 7 million paying subscribers), the rapid scale-up of One Fulfillment, and Poland's unmatched InPost parcel-locker network — over 25,000 lockers nationwide, the densest in Europe. Selling on Allegro is the fastest path to Polish online consumers and a natural launchpad into the broader CEE region.

Opening an Allegro Seller Account (2026 Requirements)

1. Legal and Tax Prerequisites

To sell on Allegro you need an active EU business entity. A Polish sp. z o.o., spółka akcyjna, sole proprietorship (jednoosobowa działalność gospodarcza) or any EU VAT-registered company are all eligible. From February 2026, structured invoicing through KSeF (National e-Invoice System) becomes mandatory for B2B and B2G transactions — non-compliance carries significant penalties.

• NIP (Polish VAT number) or EU VAT ID with OSS registration
• REGON / KRS (company registry extract for Polish entities)
• Bank account in PLN or EUR — payouts settle here
• KSeF-compatible e-invoicing integrator (Comarch, Symfonia, Asseco WAPRO, inFakt, etc.)
• BDO waste register entry (packaging, WEEE/ZSEE for electronics)
• Trademark documentation for protected categories (cosmetics, food, toys, branded goods)
• RODO/GDPR processor agreement with Allegro

2. Applying to the Allegro Seller Panel

Sellers apply via allegro.pl/sprzedawaj/zostan-sprzedawca. Approval typically takes 3–7 business days. Once approved, you can register an OAuth 2.0 application at developer.allegro.pl and receive your client_id and client_secret — both are required for the REST API integration.

3. Offer Listing and Content Rules

Allegro enforces strict listing quality standards that directly impact search ranking and Smart! eligibility:

• Title: up to 75 characters, brand + product name + key attribute, no ALL CAPS or promotional language
• Images: white background, minimum 1200×1200px, up to 16 images, no watermarks or seller logos
• Description: structured content blocks (text/image/heading), minimum 200 characters
• Category mapping: precise Allegro category ID + parameters (color, size, EAN, brand)
• EAN/GTIN: mandatory in most categories — drives catalog matching and price comparison
• Compliance documents: CE, REACH, ZSEE/WEEE declarations for regulated categories

Allegro Commission Rates (2026)

Allegro commission rates for 2026 range from approximately 5% to 22% depending on category, plus a small base category fee starting at 1% and per-listing fees in selected verticals. Polish VAT (PTU) at 23% is applied on top of fees. Building a price without modeling commission + VAT + fulfillment is the most common mistake new sellers make. The three core tiers:

Net margin formula: Sale price − Commission − Category/listing fees − VAT (PTU 23%) − Shipping cost − Cost of goods = Net profit. The Zunapro pricing module runs this calculation per SKU and per category, preventing offers from going live below your minimum profit threshold.

Allegro REST API Integration — Technical Details

The Allegro REST API is a modern RESTful interface that lets sellers programmatically manage offers, stock, prices, orders, shipments and returns. Base URL: https://api.allegro.pl/ — documentation at developer.allegro.pl.

OAuth 2.0 Authorization

The Allegro REST API uses OAuth 2.0. After registering an application at apps.developer.allegro.pl, you exchange the client_id and client_secret for a bearer access token via the Authorization Code flow (for seller-facing apps) or Client Credentials flow (for server-to-server tasks). Access tokens are short-lived (12 hours); refresh tokens last several months and rotate on each use.

Main Endpoint Categories

• Offers API — create, update, activate/deactivate offers, manage variants and parameters
• Sale endpoints — stock and price updates (bulk operations supported)
• Orders API — list checkout-forms (orders), update fulfillment status, manage shipments
• Shipping management — courier accounts, parcel labels, InPost integration
• Returns & disputes — Allegro Protect claims, refund issuance
• Billing API — fees, invoices, settlement reconciliation
• Allegro Pay — BNPL payment status, payout tracking
• Webhooks / Event Stream — near-real-time order, return and offer events

Rate Limits and Error Handling

Default Allegro REST API rate limits are around 9,000 requests per minute per application, with per-endpoint sub-limits. Exceeding the limit returns 429 Too Many Requests with a Retry-After header. Common errors: 400 (validation), 401 (expired token), 403 (insufficient OAuth scope), 404 (offer/category not found), 422 (business rule violation), 5xx (Allegro infrastructure). The Zunapro connector implements exponential backoff retry, idempotency keys and a dead-letter queue so transient failures never block your store.

Allegro Bulk Offer Import — Supplier Feeds & XML

Allegro bulk offer import lets you load thousands of SKUs from a supplier feed, ERP export or your storefront catalog directly into Allegro without manual data entry. While Allegro itself favors structured REST payloads over legacy XML feeds, Zunapro normalizes XML, CSV, JSON and direct database feeds from any source into Allegro-compatible offer objects.

Allegro Offer Schema (Key Fields)

Each Allegro offer maps to the following core fields:

• name — offer title (≤75 chars)
• category.id — Allegro category ID
• parameters — required attributes (brand, color, EAN, condition)
• product.id / ean — catalog matching
• sellingMode.price — PLN price, format 1 247,50 zł
• stock.available — quantity
• delivery.shippingRates.id — shipping rate set
• images (1–16 URLs), description.sections (structured content blocks)
• compatibilityList — for auto parts

Distributor Feed → Allegro Pipeline

Many Polish wholesalers (and pan-European distributors serving the Polish market — ABC Data, Action, AB SA, TIM SA and others) expose product catalogs as XML or REST feeds. The Zunapro distributor module:

1. Polls the supplier feed on an hourly or daily schedule
2. Learns category mapping (manual first pass, AI-assisted afterward)
3. Normalizes brand, material and size parameters to Allegro's controlled vocabularies
4. Applies margin + commission markup per category
5. Tracks stock and price changes — out-of-stock SKUs are deactivated automatically
6. Pushes offers to Allegro via REST API with full validation

One Fulfillment (Fulfillment by Allegro) — The FBA Equivalent

One Fulfillment is Allegro's own end-to-end fulfillment service, the closest equivalent to Amazon FBA in the Polish market. Sellers ship inventory to Allegro warehouses near Warsaw and Łódź; Allegro then handles storage, picking, packing, last-mile delivery (predominantly via InPost parcel lockers) and customer returns. The service has expanded rapidly since 2023 and is now a core lever for Smart! eligibility.

One Fulfillment Benefits

• Same-day / next-day delivery — automatic Allegro Smart! badge with priority cut-off times
• Higher Buy Box win rate — One Fulfillment offers rank materially higher in search
• Allegro handles customer service — returns, exchanges and dispute mediation
• "Order today, get it tomorrow" badge — proven to lift conversion 15–25%
• Zero operational overhead — no in-house picking, packing or label printing
• Native InPost integration — drops directly into Poland's #1 logistics network

One Fulfillment Costs (2025 approximate)

• Storage: ~12–25 zł per m³ per month
• Order handling: 4–9 zł per unit picked
• Return handling: 6–12 zł per returned item
• Commission: standard Allegro category commission + ~1–2% One Fulfillment surcharge

One Fulfillment becomes cost-effective for sellers with 500+ orders per month. Lower-volume sellers should ship from their own warehouse through InPost or a courier integration until volumes scale.

Allegro Smart! and Allegro Pay — Conversion Multipliers

Allegro Smart! Subscription

Allegro Smart! is Allegro's paid loyalty program — Poland's equivalent of Amazon Prime. For an annual fee of roughly 59 zł, subscribers get free delivery (to InPost lockers, courier or Allegro One Box) and free returns on eligible offers above a minimum cart value. With 7+ million paying subscribers — close to half of all active buyers — the Smart! badge is one of the strongest conversion drivers on the platform. Offers that qualify (via free shipping, eligible category and seller rating) win drastically more Buy Box impressions.

Allegro Pay — BNPL at Checkout

Allegro Pay is Allegro's in-house Buy Now, Pay Later service. Buyers can defer payment for 30 days or split into installments at checkout, with Allegro carrying the credit risk. From the seller side, Allegro Pay payouts are settled identically to standard orders — there is no extra fee for accepting Allegro Pay, and BNPL availability typically lifts AOV by 20–35% for electronics, fashion and furniture verticals.

Allegro Seller Rating, Super Seller Status and Cancellation Limits

Allegro grades sellers continuously and surfaces the "Super Seller" (Super Sprzedawca) badge to those who consistently meet quality thresholds. The badge is one of the top signals in search ranking and Smart! eligibility. Key levers:

• Cancellation rate — out-of-stock cancellations are the single biggest penalty; above 2% triggers warnings, above 5% risks account suspension
• Late shipment — orders not dispatched within the declared handling time
• Return rate — outsized return volume versus category benchmarks (fashion 25%+ is normal)
• Customer ratings — must stay above 98% positive over 12 months for Super Seller
• Response time — messages answered within 24 hours, ideally under 12

Zunapro automatic stock synchronization reduces cancellation risk by approximately 90% — the moment a unit sells on your storefront, in your warehouse or on another marketplace, the corresponding Allegro offer is updated within seconds.

Allegro Ads, Promotions and Smart Repricing

Allegro Advertising Surfaces

• Allegro Ads (Sponsored Offers) — CPC-based placements in search results and category pages
• Allegro Ads — Display — banners and rich media across Allegro properties and Ceneo
• Brand Zone — official brand stores with custom branding (manufacturers/brand owners)
• Smart! promotions — featured slots in the Smart! ecosystem and Allegro Days campaigns

Smart Repricing

Buy Box competition on Allegro is intense, especially in catalog-matched categories like electronics, books and groceries where dozens of sellers list the same EAN. The lowest landed price (with a strong seller rating) wins. The Zunapro repricer module rebalances offer prices in seconds against named competitors — never crossing the minimum margin floor you define per category.

KSeF E-Invoicing for Allegro Orders (Polish Compliance)

Poland's National e-Invoice System (KSeF / Krajowy System e-Faktur) becomes mandatory for B2B and B2G transactions in February 2026, administered by KAS (Krajowa Administracja Skarbowa). Every invoice must be issued as a structured XML (FA(2) schema), transmitted to KSeF, and assigned an official receipt (UPO). Manual invoicing is impossible at any meaningful sales volume — and B2C orders still require proper VAT documentation plus monthly JPK_VAT reporting.

The Zunapro KSeF module:

• Automatic structured invoice generation the moment an Allegro order is received
• Direct KSeF transmission via certified integrators (Comarch, Asseco WAPRO, Symfonia, inFakt, fakturownia)
• Automatic credit notes (faktura korygująca) on returns and refunds
• Monthly JPK_VAT and JPK_FA file generation
• PDF invoice auto-delivered to buyers via email + buyer panel
• Full GDPR (RODO) compliance and UODO data-processing register entries

Allegro Shipping Integration — InPost + Couriers

Polish e-commerce logistics is dominated by InPost parcel lockers (Paczkomat) — the most-used delivery method on Allegro by a wide margin and the backbone of Smart! Sellers can also offer DPD Polska, DHL Polska, GLS Polska, Poczta Polska and Allegro Kurier (Allegro's own courier service). Cross-border shipping into Czechia, Slovakia and Hungary is supported through the integrated Allegro international network.

Zunapro's multi-courier module auto-selects the optimal carrier per order based on weight, destination, declared SLA and the buyer's preferred delivery method (Smart! locker selection included); it prints labels, captures tracking numbers and pushes them back to Allegro automatically.

Allegro Returns and Customer Service Management

Polish consumer law mandates a 14-day right of withdrawal for B2C purchases, and Allegro enforces a strict 2-year warranty (rękojmia). Return rates vary by category: fashion typically 25–35%, electronics 5–10%, home & living 8–15%. Sellers who mishandle returns see their rating drop quickly.

Standard Allegro Return Flow:

1. Buyer opens a return in the Allegro panel within 14 days of delivery
2. Free InPost locker drop-off or courier pickup is generated automatically
3. Item arrives at seller (or Allegro warehouse for One Fulfillment)
4. Seller approves or rejects the return within 14 days
5. Refund is issued to buyer's Allegro Pay balance or original payment method

The Zunapro returns module tracks every step, sends panel notifications, generates the corresponding credit note (faktura korygująca) in KSeF and updates stock automatically.

Allegro Integration with Zunapro — 4-Step Setup (10 Minutes)

1. Enter Your Allegro Credentials — Inside the Zunapro panel, go to Marketplace → Allegro and paste your OAuth 2.0 client_id and client_secret, then authorize the seller account.
2. Connect Your Storefront — Prebuilt connectors for Shopify, WooCommerce, Magento, PrestaShop, BaseLinker exports and custom REST APIs. Enter the URL and access key.
3. Category Mapping Wizard — Drag-and-drop your store categories onto Allegro's category tree. AI suggestions complete the mapping in minutes; EAN matching aligns with Allegro's catalog automatically.
4. First Synchronization — Products, stock, prices, orders, shipping, KSeF invoicing — every sync starts automatically. Within 10 minutes your Allegro store is fully managed from the Zunapro panel.

Allegro Integration Frequently Asked Questions (FAQ)