Etsy Connector FAQs¶
These frequently asked questions cover the most common setup and synchronization topics for the Odoo Etsy Connector. For a full feature list and sync matrix, see Etsy Connector Features.
Getting Started¶
Fully compatible with Odoo Enterprise (On-premise and Odoo.SH) and Odoo Community. Not compatible with Odoo Online (SaaS) — that hosting tier does not allow third-party apps.
Open , click New, pick Etsy, paste the API Keystring (Client ID) and Shared Secret (Client Secret), copy the auto-generated OAuth Callback URL into the Etsy Developer Portal for your app, then click Connect Etsy Account. Etsy returns access and refresh tokens and the connector fetches your Shop ID, currency, and shop name automatically. See Create an Etsy instance in Odoo and Generate Etsy API Credentials and Connect Account.
No. Etsy access tokens are short-lived, but the connector auto-refreshes them before expiry using the stored refresh token, so sync keeps running with no manual action. A reminder activity is created 30 days before the refresh token expires so you can re-authorize at your own pace.
Yes. Create unlimited Etsy instances — each with its own API credentials, access/refresh tokens, pricelist, financial workflow, and scheduled actions. See Multi Store Selling in Etsy Connector Features.
Products & Listings¶
Yes. Etsy listing variations map to Odoo product variants with attributes auto-created. Each variation keeps its own SKU, price, weight, and inventory quantity. The connector also maps Etsy property values (size scales, colors, materials) to Odoo product attribute values. See Product Attribute Mapping.
Yes. From the operations wizard, choose Export Listings, select products, and run it. The connector creates each listing in Etsy with images, pricing, inventory, category, attributes, shipping profile, return policy, readiness state, and tags. Choose Publish In Etsy = Published in the wizard to make it live (Etsy requires at least one image to publish — the connector enforces this). See Export Etsy Listings From Odoo.
No — by design. Run the Update Listings operation (manually or via a scheduled action) to push the latest name, description, weight, SKU, attributes, tags, Who Made, When Made, Is Supply, and readiness state to Etsy. You stay in control of when changes go live.
Orders¶
On a schedule via the Import Order scheduled action (every 15 minutes by default). You can also import manually anytime from the operations wizard by date range, a single receipt ID, or a comma-separated list of receipt IDs. See Import Etsy Orders In Odoo.
When you validate the delivery order in Odoo, the connector reads the carrier and tracking number and posts them to Etsy. The Update Order Status/Tracking Information scheduled action handles this automatically. Etsy then notifies the buyer (unless you turn off Notify Customer? on the instance).
When a buyer or Etsy cancels a receipt, the connector detects the cancelled status on the next order import and automatically cancels the linked Odoo Sale Order (with downstream pickings and invoices handled per Odoo standard), so your records stay aligned without manual cleanup.
Troubleshooting¶
Failed records are flagged in the Queue Manager with the full Etsy error payload while the rest of the queue keeps processing — one bad receipt never blocks the others. Open the line, fix the issue (missing product mapping, missing workflow, etc.), and retry just that record.
Open . Every log line shows the operation, the receipt/listing ID, and the exact error message from the Etsy API. When the error is a missing Etsy Financial Workflow for a payment type, a shortcut opens the right config form so you can add the missing mapping in one click.
The connector uses a two-level fallback: it first looks for a category-level mapping for the product’s Etsy category. If none exists, it falls back to a global-level mapping set on the instance. If neither is found, the attribute is skipped and the listing is exported or imported without that property — no error is raised. To fix it, go to and add either a category-specific or global mapping for the missing Odoo attribute. See Product Attribute Mapping.
The connector auto-refreshes the access token before it expires, so short-lived tokens never interrupt sync. If the refresh token itself has expired (Etsy refresh tokens last about 90 days), all API calls start failing with an authentication error. In that case, open , select the Etsy instance, and click Connect Etsy Account to complete the OAuth flow again. The connector stores the new tokens immediately and sync resumes. A reminder activity is created 30 days before expiry so you can re-authorize before any downtime.
Support & Maintenance¶
We offer free support for the initial 60 days after the purchase date. Beginning from version 13, each app version is sold separately per Odoo policy. After the free period, paid support plans are available. See Etsy Connector Support Policy.
The module depends on Base Marketplace (also by TeqStars, free on Odoo Apps). No additional Python packages or libraries are required beyond a standard Odoo install.
Yes — full source code is provided. The connector follows standard Odoo module conventions, so any Odoo developer can inherit models, extend views, and add custom logic without touching the base module.
Each major Odoo version has its own module release on the App Store. Purchase the new version, install it on your upgraded Odoo instance, and all existing Etsy configurations, queue logs, and linked records carry over through the standard Odoo migration path.