Odoo Allegro Connector: Polish Marketplace Integration

Allegro is Poland's undisputed eCommerce leader with over 21 million registered buyers and 80% market penetration among Polish online shoppers. Any brand or retailer selling to Poland must have an Allegro presence — it's not optional. For operations teams managing Allegro alongside other channels in Odoo 19 Enterprise, the ECOSIRE Allegro Connector automates the entire seller workflow.

This guide covers Allegro API integration, offer management, order automation, Smart! program fulfillment, Polish VAT compliance, and the financial reconciliation specifics of selling on Allegro.

Key Takeaways

• Allegro REST API uses OAuth 2.0; registration at apps.allegro.pl
• Offers (Allegro's term for listings) have structured product data from Allegro's category system
• Order import includes Allegro Order ID, buyer details, and delivery preference
• Allegro Smart! program requires fast dispatch (max 1 business day for Smart! badge)
• Polish VAT (23% standard) is mandatory; reduced rates for books (5%), food (5-8%)
• Allegro Billing exports for VAT reporting import to Odoo automatically
• Allegro's price policy: competitive pricing monitored by the marketplace
• Czech Republic and Slovak Republic markets available via Allegro Lokalnie

---

Allegro Marketplace Overview

Why Allegro dominates Poland:

Allegro is not just a marketplace — it's Poland's primary retail discovery platform. Consumers start product searches on Allegro, not Google, for most product categories.

Allegro vs. Amazon in Poland:

Amazon entered Poland in 2021 but has not dislodged Allegro. Polish consumers trust Allegro's buyer protection, Smart! delivery program, and local seller ecosystem. For most categories, Allegro drives 5-10x more sales volume than Amazon.pl in Poland.

---

Allegro API Setup

Step 1: Register as an Allegro developer

1. Create an application at apps.allegro.pl
2. Choose "Web Application" type (for server-side OAuth)
3. Enter your redirect URI: https://your-odoo.com/allegro/oauth/callback
4. Note your Client ID and Client Secret

Step 2: OAuth 2.0 authorization

Allegro uses authorization code OAuth flow (user-level auth):

1. In Odoo connector settings, click Connect Allegro Account
2. OAuth popup opens on allegro.pl
3. Log in and authorize the connector
4. Access token and refresh token stored automatically
5. Tokens expire after 12 hours; refresh tokens last 30 days (auto-refreshed by connector)

Sandbox environment:

Allegro provides a full sandbox at allegro.pl.allegrosandbox.pl for testing:

• Register a test seller at allegrolokalnie.pl/developer/sandbox
• Sandbox API: https://api.allegro.pl.allegrosandbox.pl
• Test with real-looking offers and mock orders before going live

---

Connector Configuration

Navigate to Sales → Allegro or Inventory → Allegro Marketplace after installation.

Account configuration:

Delivery preferences configuration:

Allegro uses its own delivery services (Allegro Courier, InPost, DPD, DHL, Poczta Polska). Configure which services you offer and your handling times:

---

Offer Management

In Allegro, listings are called "offers." Each offer has a unique Allegro ID and can be listed as:

• Buy Now (fixed price): equivalent to other marketplaces' Buy Now
• Auction: bidding starts at a set price
• Buy Now + Auction: combined format

The connector primarily manages Buy Now offers (most common for business sellers).

Creating offers from Odoo products:

1. Open product → Allegro tab → Create Offer
2. Configure offer fields:
   • Offer Title: up to 50 characters (concise, keyword-rich)
   • Category: browse Allegro's taxonomy
   • Parameters: category-specific required attributes
   • Description: HTML allowed, Polish language primary
   • Images: up to 8 images, minimum 600×600 pixels
   • Price: PLN (inclusive of VAT)
   • Quantity: available stock
   • Condition: New, Used (with sub-condition)
   • Delivery Settings: which delivery methods offered, free/paid
   • Payment: Allegro Pay, bank transfer
   • Returns: 14-day return right (legal minimum in Poland) or extended

Allegro category parameters:

Every Allegro category has specific required parameters. The connector downloads available parameters per category and creates a guided configuration form. Example for "Laptops":

Required Parameters:
- Processor Brand (Intel, AMD)
- Processor Model (Core i7-13700H, etc.)
- RAM (GB)
- Storage (GB)
- Screen Size (inches)
- Operating System
- Graphics Card

Optional Parameters:
- Battery Life (hours)
- Weight (kg)
- Bluetooth version
- USB ports count

Map Odoo product attributes to Allegro parameters in the connector's parameter mapping table.

---

Allegro Smart! Program

Allegro Smart! is a subscription program (similar to Amazon Prime) offering free delivery on eligible offers. Smart! items display a prominent badge and rank higher in search results.

Smart! eligibility requirements:

• Maximum dispatch time: 1 business day
• Delivery via Smart!-eligible carrier (Allegro Courier, InPost, DPD, DHL)
• Minimum positive feedback score
• No active sanctions on your account

Configuring Smart! in the connector:

1. Enable Smart! in marketplace settings
2. Set dispatch time to "Same Day" or "Next Day" on eligible offers
3. Configure Smart!-eligible delivery methods
4. The connector automatically marks eligible offers with Smart! badge

Smart! operational impact:

With Smart! enabled:

• Orders placed before your cut-off time (e.g., 14:00) must ship same day
• Orders placed after cut-off ship next business day
• The connector applies dispatch date calculation based on cut-off time and order placement time
• Late dispatch triggers Smart! penalty (loss of badge for repeat violations)

---

Order Management

Order import and processing:

1. Buyer completes purchase on Allegro
2. Connector polls Allegro Orders API every 15 minutes
3. Order imported to Odoo with all required details
4. Sale order created and confirmed automatically
5. Delivery order created in Odoo inventory
6. Warehouse fulfills order using Smart!-eligible carrier
7. Tracking number entered in Odoo → connector sends to Allegro
8. Allegro notifies buyer with tracking link

Order data mapping:

Allegro InPost Parcel Locker fulfillment:

InPost is extremely popular in Poland (13,000+ parcel lockers nationwide). For InPost orders:

1. Generate InPost label via the connector's label API integration
2. Print and attach to package
3. Drop package at nearest InPost parcel locker or courier pickup point
4. InPost tracking automatically uploaded to Allegro

---

Polish VAT Compliance

VAT rates in Poland:

Allegro VAT invoice requirements:

In Poland, sellers must issue VAT invoices (faktury VAT) to business buyers. The connector handles:

1. Detecting when a buyer provides a NIP (Polish tax number) — business buyer
2. Generating a VAT invoice with seller and buyer NIP, invoice number, tax breakdown
3. Posting the invoice in Odoo's accounting module
4. Making the invoice available for the buyer (via Odoo portal or email)

JPK_V7M reporting:

Poland requires monthly JPK_V7M VAT reports. Odoo's Polish fiscal localization generates this report from your posted invoices and purchase invoices. The connector ensures Allegro sales are correctly tagged for JPK inclusion.

OSS (One Stop Shop) for cross-EU sales:

If you're a Polish seller shipping to EU buyers outside Poland:

• Sales below €10,000 annual threshold: report through Polish VAT (standard)
• Sales above threshold: register for EU OSS and report in each buyer's country
• The connector marks cross-EU sales with appropriate fiscal positions for OSS tracking

---

Allegro Finance and Reconciliation

Allegro Pay:

Since 2021, Allegro has operated its own payment platform (Allegro Pay). Sellers receive:

• Payments from Allegro Pay collected from buyers
• Remittance from Allegro (minus fees) weekly

Allegro fee structure:

Reconciliation workflow:

1. Download Allegro billing CSV from Seller Zone → Billing
2. Import via Allegro → Finance → Import Billing
3. Connector creates Odoo journal entries:
   • Debit: Allegro Receivable / Credit: Sales Revenue
   • Debit: Allegro Commission Expense / Credit: Allegro Payable
4. When weekly transfer arrives in bank: reconcile against Allegro Pay journal
5. Month-end: generate Allegro sales report for VAT declaration

---

Allegro Localnie (Czech Republic and Slovakia)

Allegro expanded to Czech Republic and Slovakia as part of CEE (Central and Eastern Europe) expansion. The connector supports these additional markets:

• Allegro.cz: Czech market, CZK currency, Czech VAT (21%)
• Allegro.sk: Slovak market, EUR currency, Slovak VAT (20%)

Configure additional marketplaces in the connector with separate API credentials (Czech and Slovak Allegro accounts require separate seller registration).

---

Frequently Asked Questions

Is it possible to sell on Allegro as a foreign (non-Polish) company?

Yes. Allegro accepts sellers from EU countries. Non-Polish EU sellers must have an EU VAT number and comply with Polish VAT obligations (either register for Polish VAT or use OSS above the threshold). Non-EU sellers face additional requirements including a Polish fiscal representative. The connector handles VAT for both Polish-registered and foreign sellers with appropriate fiscal position configuration.

How does Allegro's dispute resolution affect my Odoo integration?

Allegro's buyer protection allows disputes within 20 days of purchase. If a buyer opens a dispute, Allegro mediates. The connector imports dispute cases as Odoo support tickets, linked to the relevant sale order. Operations staff respond through Odoo; resolution is confirmed via the Allegro seller portal. Resolved disputes (refund or seller wins) update the Odoo order status accordingly.

What are Allegro's listing duration and renewal rules?

Buy Now offers can run indefinitely (Good Till Cancelled equivalent). Auction offers run for 3, 5, 7, or 10 days. The connector manages offer renewal automatically for Buy Now offers — if an offer ends due to zero stock, it restarts when inventory is replenished. Offer renewal for auctions requires manual action or automatic relisting configuration.

Can I use Allegro's One Fulfillment program (similar to FBA) through the connector?

One Fulfillment is Allegro's warehousing and fulfillment service (launched in 2023). The connector supports One Fulfillment inbound shipments, inventory tracking in Odoo's virtual "Allegro One Fulfillment" location, and auto-validation of fulfilled orders. One Fulfillment enrollment is managed directly in Seller Zone; the connector handles the operational integration.

How does the connector handle Allegro's promotional campaigns (Super Week, Black Friday)?

Allegro runs major promotional events where participating sellers see 3-10x traffic spikes. The connector's promotional campaign feature lets you pre-configure price reductions for specific campaigns with start/end dates. Enable "Campaign Mode" before major events to increase sync frequency to every 5 minutes and activate extra inventory buffers.

---

Next Steps

Allegro's dominance in Poland makes it a non-negotiable sales channel for any brand targeting Central European consumers. But operational excellence on Allegro — Smart! compliance, VAT accuracy, Polish customer service — requires systems purpose-built for the market.

Get the ECOSIRE Allegro Connector for Odoo 19 →

Our implementation team includes Polish market specialists with direct Allegro seller experience. We'll configure your connector, set up Polish VAT correctly, and train your operations team on Smart! fulfillment workflows. Contact us to start your Allegro integration.