Skip to main content

Common Issues

License Activation​

"License key invalid" error​

Cause: The license key format is incorrect or has already been revoked.

Solution:

  1. Verify the key format: ECO-XXXX-XXXX-XXXX
  2. Check your Dashboard > Licenses to confirm the key is active
  3. Ensure you haven't exceeded the activation limit for your plan

"Maximum activations reached"​

Cause: Your license has been activated on the maximum number of domains.

Solution:

  • Deactivate an existing domain from your Dashboard
  • Or upgrade your plan for additional activations

"License is not valid for Odoo version: 17.0 (licensed for version 17)"​

Cause: Older versions of ecosire_license_client (≤ 17.0.2.1.0 / 18.0.2.1.0) compared the licensed Odoo version using strict string equality, so a key issued for '17' was rejected when the Odoo client sent '17.0'. Fixed on the licence server on 2026-05-08.

Solution:

  1. Upgrade ecosire_license_client to 17.0.2.1.1 / 18.0.2.1.1 / 19.0.2.1.1 or newer (the latest version of any module shipped in or after 2026-05-09 already includes it as a dependency).
  2. Restart Odoo and re-activate the licence — both '17' and '17.0' are now accepted as the same Odoo major version.
  3. Cross-version mismatches are still rejected (e.g. a v17 key on an Odoo 18 server) — that is intentional.

License not validating after domain change​

Cause: The domain registered with your license doesn't match your current domain.

Solution:

  1. Go to Dashboard > Licenses
  2. Find the license and click "Manage Activations"
  3. Remove the old domain
  4. Activate on the new domain

Odoo Module Issues​

Module not appearing in Odoo Apps list​

Solution:

  1. Extract the module ZIP to your Odoo addons directory
  2. Restart the Odoo service
  3. Go to Apps > Update Apps List
  4. Search for the module name

Install fails with ValueError: Wrong value for ir.actions.act_window.view.view_mode: 'list'​

Affects: Odoo 17 only.

Cause: A v18→v17 backport that left view_mode='list' inside an ir.actions.act_window view_ids eval block. Odoo 17 only accepts 'tree' for that Selection.

Solution:

  1. Download the latest module version from your Dashboard > Downloads. All ECOSIRE modules from 2026-05-10 onward have been audited for this pattern and republished with the patch.
  2. If you cannot upgrade immediately, edit the offending XML by hand: in any views/*.xml file, replace 'view_mode':'list' with 'view_mode':'tree' inside view_ids eval expressions, then run Apps → Update Apps List → Upgrade.
  3. If the issue persists after upgrade, please email [email protected] with the full traceback — we run a fleet-wide audit against this exact pattern, but custom forks may still carry it.

"ImportError" when installing module​

Cause: Missing Python dependencies.

Solution:

pip install -r /path/to/module/requirements.txt
sudo systemctl restart odoo

Sync not working after Odoo upgrade​

Solution:

  1. Check module compatibility with your Odoo version in the modules overview
  2. Download the latest module version from your Dashboard
  3. Replace the module files and restart Odoo
  4. Run module upgrade: Settings > Apps > Upgrades

Shopify Integration​

Orders not syncing from Shopify​

Possible causes:

  • Webhook registration failed
  • API credentials expired
  • Rate limiting

Solution:

  1. Check the sync log in Odoo: Shopify Connector > Sync Log
  2. Verify API credentials: Settings > Shopify > Test Connection
  3. Re-register webhooks: Settings > Shopify > Webhooks > Re-register

Duplicate products after sync​

Cause: SKU mapping mismatch between Shopify and Odoo.

Solution:

  1. Ensure every Shopify product has a unique SKU
  2. In Odoo, map Shopify products via Internal Reference (SKU)
  3. Run a deduplication: Shopify Connector > Tools > Deduplicate Products

Inventory counts don't match​

Solution:

  1. Force a full inventory sync: Shopify Connector > Sync > Full Inventory Sync
  2. Check for warehouse mapping: ensure the correct Odoo warehouse maps to your Shopify location
  3. Verify there are no pending stock moves in Odoo

API Issues​

401 Unauthorized on API calls​

Solution:

  1. Verify your API key is active in Dashboard > API Keys
  2. Check the Authorization header format: Bearer eco_live_...
  3. Ensure the API key hasn't expired

429 Too Many Requests​

Cause: Rate limit exceeded (60 requests per minute).

Solution:

  • Implement exponential backoff in your integration
  • Cache responses where possible
  • Contact support if you need a higher rate limit

Still Need Help?​

Last updated on