How to Install and Configure the Odoo Shopify Connector

What Shopify Already Handles Before You Add a Connector

Before installing any third-party connector, it is worth reviewing the native tools Shopify provides for managing the data you plan to sync. Shopify already gives you quite a bit out of the box:

• Product management: Bulk CSV import/export, the GraphQL Admin API for scripted updates, and detailed product reports in Shopify Analytics all let you stage and validate your catalog before any external system touches it.
• Customer data: Shopify's customer admin supports segmentation, tagging, B2B company profiles (on Shopify Plus), and customer export/import.
• Order workflows: Built-in order review workflows, Shopify Flow automations, and draft order capabilities cover a wide range of order processing needs natively.

‍

The Odoo Shopify Connector is most valuable when you need continuous, automated synchronization between Odoo as your back-office ERP and Shopify as your storefront. If you are only doing occasional manual updates, native Shopify tools might be enough on their own. For a broader look at ERP integration approaches, see our Shopify ERP Integration Guide.

‍

What the Odoo Shopify Connector Actually Syncs

The app we are covering here is Odoo Integration, Odoo ERP by TechMarbles, available in the Shopify App Store. It provides bidirectional, real-time synchronization and covers a broad set of data types:

• Orders (Shopify to Odoo, including discounts and fulfillment tracking)
• Products and variants (bidirectional)
• Customers (Shopify to Odoo)
• Inventory (two-way stock sync with multi-location support)
• Taxes (automated tax mapping)
• Pricing (automated price updates from Odoo to Shopify)
• Invoices and payments (automatic invoice and payment synchronization)
• Refunds (refund processing synced between systems)
• Abandoned carts (exported to Odoo CRM as leads)

‍

A few things that set this connector apart: it supports bidirectional stock management (inventory changes in either system update the other), bulk historical data import (so you can backfill existing orders and customers into Odoo), and abandoned cart integration that creates CRM leads in Odoo automatically. It also handles cash flow accounting integration with Odoo's accounting module.

‍

If you have already set up product syncing separately (for example, through an Odoo-side module), this connector complements that workflow. For a detailed walkthrough of product-specific sync, check out How to Sync Odoo Products to Shopify.

‍

The connector handles tax and pricing sync automatically, but you will still want to configure and verify these key mapping areas before going live:

1. Payment mapping (Shopify payment method to Odoo payment journal)
2. Tax mapping (Shopify tax calculation to Odoo tax rules)
3. Currency mapping (manual setup)

Each of these is covered in detail below.

‍

Confirm Compatibility Before You Start

The Odoo Integration app by TechMarbles supports Odoo Online and Odoo.sh instances, and integrates with Odoo's Sales, Product, Inventory, and Accounting modules. Before proceeding with installation:

• Verify your Odoo version and hosting. Log into your Odoo instance and confirm you are on a supported version. The app works with Odoo Online and Odoo.sh environments. If you are self-hosting or running a legacy Odoo version, you may need to look at alternative modules or a custom integration approach (such as using n8n to bridge the two systems).
• Check your Shopify plan. The app offers pricing tiers aligned to each Shopify plan (Basic through Plus), so it works regardless of your plan level. If you are using Shopify Plus with B2B features like company profiles, customer-specific pricing, or payment terms, confirm that the connector handles those objects or plan to supplement with additional tooling.
• Review API access. You will need credentials to authenticate with your Odoo instance. Make sure you have admin-level access to both Shopify and Odoo before starting.

‍

Install the Connector from the Shopify App Store

Installation happens from within your Shopify admin:

1. Log into your Shopify admin panel.
2. Navigate to Apps in the left sidebar.
3. Click Shopify App Store (or search within Apps).
4. Search for "Odoo Integration" or "Odoo ERP" in the App Store search bar.
5. Select the Odoo Integration, Odoo ERP app by TechMarbles.
6. Click Install and authorize the app to access your Shopify store data.

The app offers a 30-day free trial across all pricing tiers, so you have a full month to test the integration before committing. Pricing scales with your Shopify plan:

• Basic: $35/month ($350/year)
• Grow: $45/month ($450/year)
• Advanced: $55/month ($550/year)
• Plus: $65/month ($650/year)

Annual billing saves roughly 17%.

‍

After installation, the app will appear in your Apps list within Shopify admin. The app's onboarding flow will prompt you to connect it to your Odoo instance.

‍

Connect the App to Your Odoo Instance

Once the app is installed in Shopify, you need to establish the connection to your Odoo backend:

1. Open the Odoo Connector app from your Shopify admin Apps list.
2. Enter your Odoo instance URL (for example, https://yourcompany.odoo.com or your self-hosted domain).
3. Provide API credentials. Depending on the connector version, this may be an API key, database name, username, and password, or an OAuth-based connection.
4. Test the connection. Most connectors include a "Test Connection" button. Use it. If the test fails, double-check your Odoo URL, credentials, and that your Odoo instance is accessible from the internet (self-hosted instances behind firewalls may need additional configuration).
5. Select default settings. The onboarding wizard typically asks you to set:
   
   1. The default Odoo warehouse for incoming orders
   2. The default price list
   3. Whether synced products should auto-publish or remain in draft
   4. Which Shopify locations map to which Odoo warehouses

Set Up Payment Mapping

Payment mapping tells the connector how to translate Shopify payment methods into Odoo payment journals. This is critical for keeping your accounting accurate.

‍

Why it matters: Shopify processes payments through its own gateway or third-party providers (Shopify Payments, PayPal, manual payments, etc.), and each of these needs to land in the correct Odoo payment journal so your books reconcile.

‍

What to configure:

• List your active Shopify payment methods. Go to Settings > Payments in your Shopify admin to see what is currently enabled.
• Match each to an Odoo payment journal. In the connector's payment mapping section, pair each Shopify payment type with the corresponding Odoo journal entry (for example, "Shopify Payments" maps to your "Bank" journal, "Cash on Delivery" maps to your "Cash" journal).
• Handle edge cases. If you offer B2B payment terms like Net 30 or Net 60 through Shopify, confirm how the connector records those, whether as pending payments, draft invoices, or receivables in Odoo.

‍

Set Up Tax Mapping

Tax mapping aligns Shopify's tax calculations with Odoo's tax rules so that order totals, tax amounts, and line item breakdowns match across both systems.

‍

What to configure:

• Review Shopify's tax settings. In your Shopify admin under Settings > Taxes and duties, note whether you use Shopify Tax, a third-party tax service, or manual tax rates.
• Map tax rates to Odoo fiscal positions. The connector should allow you to associate Shopify tax lines with specific Odoo tax codes. For example, if Shopify charges 8.25% sales tax for Texas, map that to the equivalent Odoo tax record.
• Decide who is the tax authority. In most setups, Shopify handles customer-facing tax calculation at checkout, and Odoo receives the tax amounts as reported. Make sure you are not double-calculating tax by having both systems try to compute it independently.
• Test with a sample order. Place a test order in Shopify, let it sync to Odoo, and verify that the tax line items, rates, and totals match. Discrepancies here cause reconciliation headaches later.

‍

Set Up Currency Mapping

Currency mapping is described as a manual process in the Odoo Connector. If you sell in multiple currencies (common for manufacturers and B2B sellers using Shopify Markets), this step needs careful attention.

‍

What to configure:

• Identify which currencies are active in Shopify. Check Settings > Markets in your Shopify admin to see enabled currencies.
• Ensure matching currencies exist in Odoo. In Odoo, go to Accounting > Configuration > Currencies and activate any currencies that Shopify uses.
• Map each Shopify currency to its Odoo counterpart in the connector's currency mapping section. Since this is manual, you will need to explicitly pair them (for example, USD to USD, EUR to EUR).
• Decide on exchange rate handling. Determine whether Odoo's automatic exchange rate updates will govern conversion or whether you are using fixed rates. Mismatched exchange rates between the two systems can create small but persistent accounting variances.

‍

Plan Your Data Flow Direction

Before going live, make deliberate decisions about how data moves between the two systems. The connector's default behavior may not match your operational needs.

‍

Key questions to answer:

• Orders: Do orders flow from Shopify into Odoo (most common), or do you also create orders in Odoo that need to appear in Shopify?
• Products: Are products mastered in Odoo and pushed to Shopify, or does Shopify serve as the product authority? If you have already configured Odoo-to-Shopify product sync, make sure this connector's product sync does not create conflicts or duplicates.
• Customers: Should new Shopify customers automatically create customer records in Odoo, or do you want to review and approve them first?
• Inventory: Which system is the source of truth for stock levels? For guidance on sync frequency and approach, see How Often Should Shopify Sync Inventory?

Sync scheduling:

• Configure how often the connector pulls or pushes data. Most connectors allow you to set cron-based intervals (every 15 minutes, hourly, etc.).
• For more sophisticated scheduling or conditional sync logic, consider using n8n as an orchestration layer to trigger syncs based on specific events rather than fixed intervals.

‍

Test, Validate, and Go Live

Do not skip validation. A connector that appears to work during setup can produce silent data mismatches that compound over time.

‍

Validation steps:

1. Run a small batch first. Sync a handful of orders, a few customers, and a limited product set. Check every field in Odoo against Shopify to confirm accuracy.
2. Verify payment recording. Confirm that test orders land in the correct Odoo payment journals with accurate amounts.
3. Check tax totals. Compare line-item tax on the Shopify order with the corresponding Odoo invoice. They should match exactly.
4. Validate currency conversion. If you are processing multi-currency orders, verify the converted amounts in Odoo align with Shopify's recorded values.
5. Monitor the sync queue. Most connectors expose a job queue or sync log. Watch it during the first few days for failed records, and investigate any errors before they accumulate.
6. Confirm fulfillment data. If the connector syncs fulfillment status back to Shopify, place a test order, fulfill it in Odoo, and verify the tracking information appears correctly in Shopify.

Once validation passes, gradually expand the sync scope to your full catalog and customer base.

‍