eBay Connector FAQs¶
These frequently asked questions cover the most common setup and synchronization topics for the Odoo eBay Connector. For a full feature list and sync matrix, see eBay Connector Features.
Getting Started¶
Yes. Fully compatible with Odoo Enterprise (On-premise and Odoo.SH) and Odoo Community. Not compatible with Odoo Online (SaaS) as it does not support third-party apps.
Create an eBay instance in Odoo by navigating to , click CREATE, select eBay as the marketplace, and fill in your eBay API credentials. Then use the Connect eBay Account button to authorize Odoo via eBay’s secure login. See Create an eBay instance in Odoo and Generate eBay API Credentials and Connect Account for detailed steps.
You need an eBay Developer Account with the following credentials: Client ID (App ID), Client Secret (Cert ID), Dev ID, and RuName (OAuth Redirect URL). These are generated in the eBay Developer Portal. See Generate eBay API Credentials and Connect Account for a step-by-step guide.
Yes. The connector supports multiple instances (one per eBay account or site) so you can centralize listings, orders, inventory, and customers in one Odoo database. For example, you can connect both eBay US and eBay UK to the same Odoo. See Multi Store Selling in eBay Connector Features.
Open your eBay instance record and click the Test Connection button. If the connection is successful, you will see a confirmation message. This verifies that your API credentials and access token are valid.
Products & Listings¶
Yes. First add the product to eBay listings using the Add to Listings action from the product list. Then configure the eBay-specific details (category, policies, item specifics) on the listing and use the Export Listings operation. See Export Products From Odoo for detailed steps.
Products are matched by SKU. When importing from eBay, the connector searches for an existing Odoo product with the same SKU. If no match is found and Create Odoo Products? is enabled, a new product is automatically created in Odoo.
You can add up to 24 images per listing and up to 12 images per variant. Images are uploaded to eBay when you export or update the listing.
The connector supports the following listing durations: 3 Days, 5 Days, 7 Days, 10 Days, 30 Days (Fixed Price only), and Good ‘Til Cancelled (GTC) (Fixed Price only). GTC listings automatically renew every 30 days until you end them. The default duration is GTC.
For fixed-duration listings (not GTC), a countdown timer is displayed on the listing form. When the timer reaches zero and the listing end time has passed, the product is automatically marked as Ended in Odoo. GTC listings do not expire; they renew every 30 days.
Yes. Select ended listings from the listing tree view and use the Relist action. You can update the price, quantity, and images during relisting. The listing will become active again on eBay. See Relist Products.
Out of Stock Control is an eBay seller program that keeps your listings active even when your inventory reaches zero. When enabled, zero-stock listings become hidden from buyers but are not ended, preserving your sales history and search ranking. When disabled, listings with zero stock across all variants are automatically ended on eBay.
You can enable or disable this option from the eBay instance in Odoo. The connector automatically detects your current eBay setting the first time you confirm the instance.
eBay requires Payment, Fulfillment, and Return policies on every listing. Import them via the Import Policies operation and assign them to your listings before exporting. Policies are read-only in Odoo — manage them on eBay and re-import when changes are made. See Seller Policy Management.
Item specifics (also called category attributes) are key-value pairs that describe your listing, such as Brand, MPN, Color, and Size. These vary by category and some are required by eBay. Missing required item specifics can cause your listing export to fail. Fetch item specifics for your categories before exporting products using the Fetch Attributes button on the category form. See Category Management.
The connector automatically records all fees returned by eBay for listing operations (Create, Update, Relist, End). View current fees and full fee history on the listing form under the eBay Fees tab. See Product Fees.
Orders¶
Orders are imported from eBay either automatically via a scheduled action (default every 15 minutes) or manually using the Import operation from the Operations popup. See Import eBay Orders In Odoo.
Yes. You can restrict imports by date using the Import Order After setting on the instance — only orders created after this date will be imported. You can also filter by fulfillment status using the Fulfillment Status Filter. See Orders Configurations for configuration details.
When you validate a delivery in Odoo, the tracking number and carrier information can be sent to eBay. This can happen automatically via the scheduled Export Order Status action, or you can trigger it manually from the delivery order. Make sure your delivery carriers have the eBay Carrier Code configured. See eBay Update Order Status from Odoo.
Yes. When a buyer selects In-Store Pickup on eBay, the connector imports the order as a pickup order in Odoo. Once the buyer collects the item from your store, click Mark as Picked Up on the delivery order in Odoo to notify eBay that the order is fulfilled. If the buyer has already picked up the item before the order is imported into Odoo, the pickup status is automatically updated. See eBay In-Store Pickup Orders.
Order processing (auto-confirm, auto-invoice, auto-validate) is controlled by Financial Workflow Configuration. Workflows are defined per payment method and order financial status (e.g., Paid, Pending). If a matching workflow is not found for an incoming order, the import will show an error with a Configure Workflow shortcut. See Workflow Configurations and Configure Marketplace Order Workflow.
Yes. For paid orders, the connector automatically creates a payment entry in Odoo and reconciles it with the invoice. The eBay payment reference is stored for traceability.
Inventory & Pricing¶
Inventory is synchronized from Odoo to eBay through scheduled and manual export processes. Stock levels are calculated based on your Stock Based On setting and the Odoo locations mapped to your eBay locations. See Export Inventory.
eBay Locations represent the physical locations from which you ship items. Use the Import Locations operation from your eBay instance to import them. Then map each eBay location to an Odoo warehouse and enable the Import/Export Stock option for the locations you want to use for inventory sync. Only enabled locations are used for stock updates. See Location Management.
Prices are read from the pricelist configured on your eBay instance and sent to eBay using the Update operation. You can enable the Export Product Sale Price option to use the product’s sale price from Odoo. Price sync can be automated via a scheduled action (default daily) or triggered manually. See Export Price.
Each eBay site has its own currency. The connector uses the pricelist on your eBay instance to handle currency conversion. If you enable Use Marketplace Currency, orders are imported in the eBay site’s currency. Prices are automatically converted when exporting to eBay or importing from eBay.
Feedback¶
Yes. The connector imports buyer feedback from eBay, including the rating (Positive, Neutral, Negative), comment text, and Detailed Seller Ratings (DSR) for categories such as Item as Described, Communication, Shipping Time, and more. Feedback import can be automated via a scheduled action (default daily). See Import eBay Feedback In Odoo.
Account & Security¶
The connector uses OAuth 2.0 for secure authentication. When you click Connect eBay Account, you are redirected to eBay’s login page to authorize Odoo. Access tokens are automatically refreshed in the background — no manual intervention is needed.
Access tokens are refreshed automatically. However, the long-lived refresh token expires after approximately 18 months. The connector will warn you 30 days before expiry by creating a reminder on the instance. If the refresh token expires, you will need to re-authorize by clicking Connect eBay Account again.
The connector includes a webhook endpoint for eBay’s Account Deletion Notifications. When a buyer deletes their eBay account, the connector automatically anonymizes their personal data in Odoo (removes name, email, phone, and address) and deactivates their portal access. This helps comply with data protection regulations.
Troubleshooting¶
Verify that your API credentials are correct and the connection is active (use Test Connection).
Confirm the eBay Site is correctly configured on the instance.
Ensure seller policies are imported and assigned to your listings.
Check that eBay categories have required item specifics filled.
For inventory issues, confirm eBay Locations are imported and mapped to Odoo warehouses.
Review the logs at for detailed error messages.
For order import failures, use the Configure Workflow button from the log entry to set up missing workflows.