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 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

"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 compatibility table
  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?