Skip to main content

eBay Store Management

The ECOSIRE eBay Store Management module connects your eBay seller account to Odoo through the modern eBay REST API with OAuth 2.0 authentication. Handle auction and fixed-price listings, reconcile Managed Payments, and manage customer feedback all from within Odoo. The module supports 8 eBay marketplaces (US, UK, DE, AU, CA, FR, IT, ES) with both production and sandbox environments.

Compatibility: Odoo 17 / 18 / 19 Price: $499 (one-time) License: Up to 3 domain activations

Key Features​

  • eBay REST API integration with OAuth 2.0
  • Auction and fixed-price listing support
  • Managed Payments reconciliation
  • Multi-marketplace support (US, UK, DE, AU, CA, FR, IT, ES)
  • Sandbox environment for testing
  • Feedback management and auto-request
  • Best Offer handling
  • Promoted listings tracking
  • Category mapping with eBay taxonomy
  • Variation listings (size, color, etc.)
  • Return management and refund processing
  • Bulk listing tools

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • An eBay seller account with API access enabled
  • eBay Developer Program credentials (App ID + Cert ID)

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-ebay-*.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 "ECOSIRE eBay Store Management" and click Install
  6. Enter your ECOSIRE license key when prompted

Configuration​

Step 1: Obtain eBay API Credentials​

  1. Go to the eBay Developer Program and sign in or create an account
  2. Navigate to My Account > Application Keys
  3. Create a new application keyset for the Production environment
  4. Note your App ID (Client ID) and Cert ID (Client Secret)
  5. Under User Tokens, click Get a Token from eBay via Your Application
  6. Configure the OAuth redirect URI to point to your Odoo instance
  7. Select the following OAuth scopes:
    • https://api.ebay.com/oauth/api_scope/sell.inventory
    • https://api.ebay.com/oauth/api_scope/sell.fulfillment
    • https://api.ebay.com/oauth/api_scope/sell.account
    • https://api.ebay.com/oauth/api_scope/sell.finances
    • https://api.ebay.com/oauth/api_scope/sell.marketing
  8. Complete the OAuth flow to obtain your Refresh Token

Step 2: Connect in Odoo​

  1. Navigate to eBay Store Management > Configuration
  2. Enter your eBay credentials:
    • Client ID (client_id) -- eBay App ID
    • Client Secret (client_secret) -- eBay Cert ID
    • Refresh Token (refresh_token) -- from the OAuth flow
    • Marketplace -- select your eBay site (US, UK, DE, AU, etc.)
    • Sandbox Mode -- toggle for testing
  3. Click Test Connection to verify
  4. Configure your default warehouse and company mapping

Step 3: Configure Sync Settings​

Product Sync​

  • Choose sync direction: eBay to Odoo, Odoo to eBay, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and category mapping
  • Map eBay item specifics to Odoo product attributes

Inventory Sync​

  • Map Odoo warehouses to eBay listing locations
  • Set buffer stock quantities if needed
  • Enable real-time stock updates

Order Sync​

  • Enable automatic order import
  • Map eBay Managed Payments to Odoo payment journals
  • Configure fulfillment sync to push tracking numbers
  • Set up automatic feedback requests

Initial Sync​

  1. Go to eBay 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.ebay.com
Sandbox APIhttps://api.sandbox.ebay.com
Production token URLhttps://api.ebay.com/identity/v1/oauth2/token
Sandbox token URLhttps://api.sandbox.ebay.com/identity/v1/oauth2/token
MarketplacesEBAY_US, EBAY_GB, EBAY_DE, EBAY_AU, EBAY_CA, EBAY_FR, EBAY_IT, EBAY_ES
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
OAuth token expiredRe-authorize via the OAuth flow; refresh tokens expire after 18 months
Sandbox vs production mismatchEnsure Sandbox Mode toggle matches your credentials
Managed Payments reconciliation offMap eBay payment methods to the correct Odoo journals
Listing policy violationReview eBay's listing requirements for required item specifics
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on