Troubleshooting & Best Practices

Connection Problems

Cannot connect to Odoo

1. Verify the Odoo URL is correct and reachable (must include https://).
2. Check the database name and credentials (an API key often works better than a password).
3. Ensure Odoo is version 16.0 or later.
4. Confirm the API user has the required read/write permissions.
5. The app distinguishes “Invalid Odoo Host Url” (URL/host issue) from “Invalid Odoo account credentials.” (login issue) — fix the one indicated.

Sync Failures

1. Check the Logs for the specific error message.
2. Confirm the relevant sync is enabled and saved.
3. Verify location/warehouse mapping and SKU/Barcode (or Variant ID) mapping.
4. Check the Duplicate SKUs tabs — duplicate identifiers are a common cause of wrong/failed product mapping.
5. Be mindful of API rate limits — use category/tag/collection filters for large catalogs.

Inventory Discrepancies

1. Verify location mapping (or “Skip location mapping” if intended).
2. Check sync frequency / real-time settings.
3. Confirm the quantity type (Available vs On Hand vs Forecasted) and the Shopify Target Type (which Shopify field is written).
4. If you use “Combine Odoo available + Shopify committed” or “Sync Odoo Incoming Qty”, remember they change what the Shopify numbers represent.
5. Review recent inventory logs.

Getting Help

• Email: [email protected]
• Logs: review for error details
• 🚀 Schedule a Call: Book a meeting with our experts

---

Common Errors & Solutions

“No valid user with order sync enabled”

Order sync is disabled or the user isn’t configured. Enable Order Sync, verify configuration, and check the Odoo connection.

“Unable to populate Company list options”

Cannot retrieve Odoo company data. Verify connection credentials, user permissions, and that companies exist in Odoo.

“Failed to Get Inventory data”

Cannot retrieve inventory/location data. Check Shopify API permissions and Odoo warehouse setup, then use Refresh to reload locations.

“Product sync is already running”

Another sync is in progress. Wait for it to finish (or use Cancel export & reset for a Shopify → Odoo export), then retry.

“Please enable Stock Sync or inventory location mapping”

Inventory requirements aren’t met. Enable stock sync and configure location mapping (or enable Skip location mapping).

“Order data not found”

The Shopify order can’t be retrieved. Verify it exists and isn’t deleted/archived, and check API permissions.

“Unable to populate Tax Type list options”

Cannot retrieve tax configuration. Check Odoo tax setup and user permissions; remember Tax Type only appears when Enable Fixed Tax Mapping is on.

“The field ‘x_…’ does not exist in Odoo…” (Variant ID / Field Mapping)

For the Shopify Variant ID field or a custom field mapping, ensure the technical name is valid and starts with x_ for auto-creation, or that the field already exists on the correct model.

“Failed to sync images”

Image sync failed. Check image formats/sizes and that URLs are accessible; for All Images, clean up duplicates first.

Wrong product / variant mapped

Usually caused by duplicate SKUs/barcodes. Check the Duplicate SKUs tabs in Logs and resolve duplicates, or switch matching to Shopify Variant ID in Configuration.

---

Best Practices

Product Management

1. Use consistent SKUs/barcodes (or Variant ID mapping) for accurate matching and to avoid duplicates.
2. Complete product data in the source system before syncing.
3. For large catalogs, sync by category/tag/collection to stay within API limits, and use the date-range filter on manual syncs to re-sync only what changed.
4. Use the Duplicate SKUs tabs periodically to catch data-quality issues early, and the Product Sync Status tab to verify mappings and push individual products.
5. Use Market Catalog mapping for multi-market pricing and Odoo price lists for flexible pricing.

Inventory Management

1. Map all locations before enabling stock sync; test with a small set first.
2. Pick a frequency (or real-time) matched to your order volume.
3. Use Combine available + committed during high-traffic sales to avoid premature out-of-stock.
4. Decide on zero-stock handling based on whether you want out-of-stock items visible.

Order Processing

1. Monitor the dashboard (including the Failed Orders and Sync Success Rate cards) and address Failed orders promptly (use bulk resync).
2. Configure invoicing/payments to match your accounting workflow before going live — and use Invoice Sync Only if you only need invoices in Odoo, keeping its inventory/delivery caveats in mind.
3. Test status sync (and real-time webhooks, if used) with sample orders, including refunds if you enable refund status sync.
4. Use tag-based customer/company/warehouse mapping for structured routing.
5. Check the Duplicate Orders – Odoo tab in Logs occasionally to catch doubled orders early.

Customer & CRM

1. Start with Only update existing customers to prevent duplicates.
2. Use tag filtering to sync the right segments.
3. Use the CRM Lead tab to capture abandoned checkouts and draft orders.

System & Security

1. Review Logs regularly and keep configuration current.
2. Use API keys and HTTPS; grant the Odoo user only the permissions it needs.
3. Test configuration changes on small datasets first.
4. Keep both the Odoo and Shopify apps updated.