Skip to main content

eBay Store Management

The ECOSIRE eBay Store Management module connects your eBay seller account to Odoo through eBay's Sell REST APIs with OAuth 2.0. It imports orders, products, customers and stock into Odoo, publishes fixed-price listings through the Inventory and Offer APIs, withdraws and re-publishes listings as stock runs out and returns, and pushes tracking numbers back to eBay. One configuration per seller account; each configuration picks one of 25 eBay marketplaces and the production or sandbox host.

Compatibility: Odoo 17 / 18 / 19 / 20 (Community or Enterprise; self-hosted or Odoo.sh) Current shipped version: 17.0.2.9.3 on Odoo 17, 18.0.2.9.3 on Odoo 18, 19.0.2.9.3 on Odoo 19, 20.0.2.9.3 on Odoo 20 Price: $499 (one-time) Licence: OPL-1 (no licence key or activation)

Key Features​

  • OAuth 2.0 (client ID, client secret and refresh token per configuration), with the seven user-consentable scopes eBay grants on a production keyset
  • 25 eBay marketplaces, each call carrying the matching X-EBAY-C-MARKETPLACE-ID and content language
  • Incremental order import (eBay creationdate filter), keyed by eBay Order ID and company, with shipping on its own line
  • Optional auto-confirmation of orders eBay reports as PAID (off by default; invoicing stays manual)
  • Product import from Inventory API items, matched on eBay SKU, then internal reference, then name
  • Fixed-price listing publish (inventory item, offer, publish), with item specifics filled from attributes, the brand field and configuration defaults. Auction listings are not supported
  • Stock-driven delist / relist of the same offer (opt-in per configuration)
  • On the Odoo 19 and 20 builds: a per-account Sync Frequency for the scheduled imports, a Sync Log that names every refused product with eBay's error, and protection against deleting or archiving a product that is still listed on eBay
  • Tracking push as an eBay shipping fulfilment, and fulfilment status pulled back to the order
  • Promoted Listings campaigns and campaign reports (Marketing API)
  • Best Offer: offer-eligible listings and counter-offers to interested buyers (Negotiation API)
  • Marketplace account-deletion endpoint that answers eBay's challenge handshake
  • Multi-company: configurations are company-scoped with record rules
  • Further eBay operations (feedback, returns, cancellations, catalog and more) are catalogued in the module and callable from Odoo server code; they have no dedicated screens, each needs its own OAuth scope on your keyset, and the returns and cancellations calls are not yet verified against a live account

Prerequisites​

  • Odoo 17, 18, 19 or 20 (Community or Enterprise). Odoo Online cannot install third-party modules
  • Python packages requests and cryptography in Odoo's interpreter
  • An eBay seller account and an eBay Developer Program application (App ID + Cert ID) with a user refresh token
  • A verification token for the marketplace account-deletion endpoint eBay requires before it enables production keys

Installation​

  1. Get the module from the Odoo Apps Store, or from your ecosire.com account downloads if you bought it on ecosire.com
  2. Extract it into your Odoo addons directory (for Odoo.sh, add it to your repository)
  3. Restart Odoo, then in Apps click Update Apps List
  4. Search for "eBay Store Management" and click Install

Configuration​

Step 1: Obtain eBay API credentials​

  1. Sign in at the eBay Developer Program and create a Production keyset
  2. Note the App ID (Client ID) and Cert ID (Client Secret)
  3. Generate a user token for your seller account with these scopes:
    • https://api.ebay.com/oauth/api_scope
    • 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.marketing
    • 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/commerce.identity.readonly
  4. Keep the resulting Refresh Token

Step 2: Connect in Odoo​

  1. Open eBay > Configuration > Settings and create a configuration
  2. Enter Client ID, Client Secret and Refresh Token, pick the Marketplace, and tick Sandbox only for sandbox keys
  3. Click Test Connection
  4. Use the buttons to fetch your business policies, merchant locations and programme enrolments, then choose the ones listings should use

Step 3: Sync settings​

  • Orders: imported every 30 minutes; enable Auto-Confirm Paid Orders if wanted
  • Products: imported hourly; publish from Odoo with the export wizard
  • Sync Frequency (Odoo 19 and 20 builds): set how often the scheduled Products, Orders and Customers imports run for the account; Standard keeps the timings above
  • Inventory: eBay availability written to stock in the configuration company's warehouse every 15 minutes
  • Delist / relist: enable Auto Delist / Relist by Stock and set the Relist Stock Threshold (default 1)
  • Item specifics: set Default Item Specifics (JSON) for aspects your products cannot supply
  • Tracking: validate the outgoing delivery with a carrier tracking reference, then push it to eBay from the order

Scheduled jobs​

JobInterval
Sync Products1 hour
Sync Orders30 minutes
Sync Inventory15 minutes
Auto Delist / Relist by Stock15 minutes (no-op until enabled)
Sync Customers6 hours
Test Connectiondaily
Cleanup Old Logsdaily

On the Odoo 19 and 20 builds the Sync Products, Sync Orders and Sync Customers jobs check every 15 minutes and run each account at its Sync Frequency (the default, Standard, is the timing in the table), and the builds add Export Product Changes (every 30 minutes, no-op until Auto Push Product Edits to eBay is enabled).

API Details​

FieldValue
Auth methodOAuth 2.0 (refresh-token grant; application-token fallback)
Production APIhttps://api.ebay.com
Sandbox APIhttps://api.sandbox.ebay.com
Token URLhttps://api.ebay.com/identity/v1/oauth2/token (sandbox: api.sandbox.ebay.com)
Marketplaces25: EBAY_US, EBAY_GB, EBAY_DE, EBAY_AU, EBAY_CA, EBAY_FR, EBAY_IT, EBAY_ES, EBAY_NL, EBAY_BE, EBAY_PL, EBAY_AT, EBAY_CH, EBAY_IE, EBAY_HK, EBAY_SG, EBAY_MY, EBAY_PH, EBAY_TW, EBAY_IN, EBAY_RU, EBAY_MX, EBAY_FRBE, EBAY_FRCA, EBAY_MOTORS_US
Rate limitsHTTP 429 honours Retry-After (capped at 60 s), up to three retries
Webhooks/ebay/webhook rejects every delivery (HTTP 403); sync runs on the scheduled jobs

Dashboard​

The eBay > Dashboard screen shows sales, order status, top products and recent sync runs for a chosen period (today, 7, 30, 90 or 365 days, or a custom range), using a chart library bundled with the module, and refreshes every 60 seconds.

Troubleshooting​

IssueSolution
Connection failedRe-check the three credentials and that Sandbox matches the keyset
Sync not runningCheck the scheduled jobs are active and Odoo's cron workers are running
Duplicate productsMake sure the eBay SKU or the product's internal reference matches
Listing rejected for item specificsFill the missing aspect on the product or in Default Item Specifics (JSON)
OAuth token expiredGenerate a new refresh token for the seller account and paste it in
Push Prices & Stock skips a SKU (Odoo 19 and 20)The SKU has no eBay offer yet: publish it first with Publish to eBay

What's new in 2.9.3​

A fix release on every build (Odoo 17, 18, 19 and 20); nothing in it changes what is sent to eBay. When Test Connection fails, the eBay account no longer goes on reading Connected: the failed status is now saved even though the test stops with an error, so the record shows that it is not connected and you can correct the credentials and connect again. Details are on the installation and configuration guide.

What's new in 2.9.2​

Dashboard and list fixes; nothing in it changes what is sent to eBay. On every build (Odoo 17, 18, 19 and 20): the dashboard follows Odoo's dark mode; Order Status says when there are no orders in the period; a long store name stays on one line on a phone; with no eBay account connected, the setup message and Connect eBay come first; Sync Logs opens on every log, not only errors; Recent Activity reads as a sentence with a relative time; and the Products figure counts products shared across companies. On Odoo 20 the dashboard opens again (it stopped with "Oops! Something went wrong") and its icons display. The Odoo 17 and 18 builds also keep the store that imported each order (for tracking and status pushes with several eBay accounts), lets eBay users without Sales rights open eBay Orders, and opens the eBay lists for products, orders and customers. Details are on the installation and configuration guide.

What's new in 2.9.1​

A fix release; nothing in it changes what is sent to eBay for a product that already publishes correctly. On the Odoo 19 and 20 builds: a refused product export is listed on the Sync Log with eBay's error number, message and field; a new listing with no stock is stopped before it is sent; Push Prices & Stock names each SKU's eBay offer (and Export Inventory runs the same push); Sync Frequency drives the scheduled imports; Auto Sync with its Sync switch off writes one warning; every order page is imported and import logs name each failed or skipped record; the Mapping Wizard creates every mapping type; and a product with a live eBay listing cannot be deleted or archived until End eBay Listing. On every build: Import Campaigns stays within its own eBay account. Details are on the installation and configuration guide.

Support​