Skip to main content

Shopify Integration Setup

This guide walks you through connecting your Shopify store with Odoo using the ECOSIRE Shopify Connector module.

Prerequisites​

  • Odoo 17.0 or 18.0 (Community or Enterprise)
  • A Shopify store with API access (any plan)
  • An active ECOSIRE license for the Shopify Connector

Step 1: Install the Module​

  1. Download the module from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-shopify-connector-*.zip -d /opt/odoo/addons/
  3. Restart Odoo: 
    sudo systemctl restart odoo
  4. Go to Apps > Update Apps List, then search for "ECOSIRE Shopify"
  5. Click Install

Step 2: Create a Shopify Custom App​

  1. In Shopify Admin, go to Settings > Apps and sales channels > Develop apps
  2. Click Create an app and name it "Odoo Integration"
  3. Under Configuration > Admin API access scopes, enable:
    • read_products, write_products
    • read_orders, write_orders
    • read_inventory, write_inventory
    • read_customers, write_customers
    • read_fulfillments, write_fulfillments
  4. Click Install app and copy the Admin API access token

Step 3: Configure in Odoo​

  1. Go to Shopify Connector > Configuration
  2. Enter your store details:
    • Store URL: your-store.myshopify.com
    • API Key: from Shopify app credentials
    • API Secret: from Shopify app credentials
    • Access Token: the token you copied
  3. Click Test Connection — you should see a green success message
  4. Enter your ECOSIRE license key when prompted

Step 4: Configure Sync Settings​

Product Sync​

  • Direction: Choose Shopify → Odoo, Odoo → Shopify, or bidirectional
  • Sync Interval: Real-time (webhook) or scheduled (5/15/60 minutes)
  • Include Images: Enable to sync product images

Inventory Sync​

  • Warehouse Mapping: Map your Odoo warehouse to Shopify locations
  • Sync Mode: Real-time (recommended) or scheduled
  • Buffer Stock: Optional safety stock quantity to withhold from Shopify

Order Sync​

  • Auto-import: Enable to automatically create Odoo sale orders
  • Payment Mapping: Map Shopify payment methods to Odoo payment journals
  • Fulfillment Sync: Enable to push tracking numbers back to Shopify

Step 5: Run Initial Sync​

  1. Go to Shopify Connector > Sync > Initial Import
  2. Select what to import: Products, Customers, Orders
  3. Set the date range for historical orders
  4. Click Start Import

The initial import runs in the background. Monitor progress at Shopify Connector > Sync Log.

Step 6: Register Webhooks​

For real-time sync, register webhooks:

  1. Go to Shopify Connector > Settings > Webhooks
  2. Click Register All Webhooks
  3. Verify all webhooks show "Active" status

Verification​

After setup, verify everything is working:

  • Products appear in both systems
  • Inventory quantities match
  • A test order in Shopify creates a sale order in Odoo
  • Fulfilling in Odoo updates Shopify order status
  • Webhook log shows incoming events

Next Steps​