Skip to main content

Allegro Store Management

Connect your Allegro seller account to Odoo through Allegro's REST API with OAuth 2.0 authentication. Manage offers, fulfill orders, and synchronize inventory on Poland's and Central Europe's largest online marketplace. The module supports both production (api.allegro.pl) and sandbox environments, with automatic token refresh and a real-time OWL 2 dashboard.

Compatibility: Odoo 17 / 18 / 19 Current shipped version: 17.0.2.1.0 / 18.0.2.1.0 / 19.0.2.1.1 Price: $349 USD (one-time) Licence: OPL-1 — no activation key, no licence client; installs and runs standalone

For the full installation and configuration guide, see Allegro Store Management.

Key Features​

  • OAuth 2.0 authentication with rolling refresh-token renewal
  • Bidirectional product and offer synchronization
  • Order import with status tracking and fulfillment updates
  • Scheduled inventory synchronization (every 15 minutes by default)
  • Category tree mapping between Allegro and Odoo
  • Product parameters/attributes and tag synchronization
  • Allegro Smart! (free shipping) support
  • Sandbox environment for testing
  • Multi-market support — Poland, Czech Republic and Slovakia from one Odoo instance
  • Coupons and coupon-usage tracking
  • Returns, refunds and the formal Disputes mediation lifecycle
  • Allegro Pay (BNPL) records and settlement reconciliation with automated journal posting
  • Allegro One Box parcel-locker fulfillment and Allegro Lokalnie local listings
  • PL JPK_FA e-invoicing exports, RODO-compliant masked buyer profiles, and multi-company data isolation (33 record rules)

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An Allegro seller account (allegro.pl)
  • Allegro Developer App credentials (Client ID + Client Secret)

Installation​

  1. Download the module ZIP for your Odoo version from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-allegro-*.zip -d /opt/odoo/addons/
  3. Restart the Odoo service: 
    sudo systemctl restart odoo
  4. Navigate to Apps, click Update Apps List
  5. Search for the module and click Install

There is no activation step and no licence key — the module is usable as soon as it installs.

Configuration​

Step 1: Obtain Allegro API Credentials​

  1. Go to Allegro Developer Portal and sign in
  2. Navigate to My Apps and click Register new application
  3. Set the redirect URI to your Odoo instance URL
  4. Note your Client ID and Client Secret
  5. Complete the OAuth 2.0 authorization flow to receive a Refresh Token
  6. The module automatically exchanges the refresh token for access tokens (12-hour expiry)

Step 2: Connect in Odoo​

  1. Navigate to Allegro Store Management > Configuration
  2. Create a new configuration and enter:
    • Client ID (client_id) -- Allegro application Client ID
    • Client Secret (client_secret) -- Allegro application Client Secret
    • Refresh Token (refresh_token) -- from the OAuth flow
    • Sandbox Mode -- toggle for testing against api.allegro.pl.allegrosandbox.pl
  3. Click Test Connection to verify
  4. Configure your default warehouse and company mapping

Step 3: Configure Sync Settings​

Product Sync​

  • Choose sync direction: Allegro-to-Odoo, Odoo-to-Allegro, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and category mapping

Inventory Sync​

  • Map Odoo warehouses to Allegro offer stock
  • Set buffer stock quantities if needed
  • Enable real-time stock updates on changes

Order Sync​

  • Enable automatic order import
  • Map Allegro payment methods to Odoo payment journals
  • Configure fulfillment sync to push tracking numbers
  • Set up order status filter rules

Initial Sync​

  1. Go to Allegro Store Management > Operations > Initial Import
  2. Select data types to import (Products, Customers, Orders)
  3. Set date range for historical orders
  4. Click Start Import and monitor progress in the sync log

API Details​

FieldValue
Auth methodOAuth 2.0 (refresh_token grant)
Production APIhttps://api.allegro.pl
Sandbox APIhttps://api.allegro.pl.allegrosandbox.pl
Token URL (prod)https://allegro.pl/auth/oauth/token
Token URL (sandbox)https://allegro.pl.allegrosandbox.pl/auth/oauth/token
Content-Typeapplication/vnd.allegro.public.v1+json
Key config fieldsclient_id, client_secret, refresh_token

Dashboard​

The built-in OWL 2 dashboard provides real-time visibility into your integration:

  • 6 KPI cards -- Revenue, Orders, Customers, Products, Avg Order Value, and Sync Health -- each with period-over-period delta indicators
  • Sales Trend chart (Chart.js line chart) with interactive date filtering
  • Order Status breakdown (doughnut chart) showing distribution across statuses
  • Period filters -- Today, 7 days, 30 days, 90 days, Year, or Custom date range
  • Activity feed showing recent sync log entries with type indicators
  • Quick action buttons for Products, Orders, Customers, Queue, Logs, and Settings
  • Status footer with Queue Jobs, Errors, Out of Stock, and Sync Rate
  • Auto-refresh every 60 seconds with dark mode support

Troubleshooting​

IssueSolution
Connection failedVerify API credentials; check network connectivity
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Duplicate productsReview product mapping; ensure SKU matching is configured
Orders not importingVerify order status filters and date range settings
Token refresh failsRe-authorize via OAuth flow to get a new refresh token
Sandbox vs production mismatchVerify Sandbox Mode toggle matches your credentials
Category mapping errorsUse the Allegro category tree importer in Operations menu
Access Error on queue/dispute/JPK_FA actionsThese actions require the allegro Manager user group; ask an administrator to grant it

Support​

Last updated on