Skip to main content

Shopify Integration Guide

This guide walks through connecting your Shopify store to ECOSIRE so that orders, products, customer records, and inventory stay synchronized automatically.

Introduction​

The ECOSIRE Shopify Connector provides bi-directional sync between Shopify and Odoo 19. When a customer places an order on Shopify, it appears in ECOSIRE within seconds. Product updates made in ECOSIRE push to Shopify automatically.

What syncs:

  • Shopify Orders → ECOSIRE Sales Orders
  • Shopify Products → ECOSIRE Products (inventory tracked)
  • Shopify Customers → ECOSIRE Contacts
  • ECOSIRE Inventory levels → Shopify Stock

Prerequisites​

  • ECOSIRE account with the Shopify Connector license activated
  • Shopify store on any plan (Basic or above)
  • Admin access to your Shopify store
  • ECOSIRE API key (generate at Dashboard → API Keys)

Step 1 — Install the Connector in Odoo​

  1. In your ECOSIRE Odoo instance, navigate to Apps.
  2. Search for ECOSIRE Shopify Connector.
  3. Click Install. The module requires Odoo 19.0+.

After installation, a Shopify menu appears under Sales.

Step 2 — Create a Shopify Custom App​

  1. In your Shopify Admin, go to Settings → Apps and sales channels → Develop apps.
  2. Click Create an app and name it ECOSIRE Sync.
  3. Under Configuration → Admin API scopes, enable:
    • read_orders, write_orders
    • read_products, write_products
    • read_inventory, write_inventory
    • read_customers, write_customers
    • read_fulfillments, write_fulfillments
  4. Click Save then Install app.
  5. Copy the Admin API access token (shown once).

Step 3 — Configure the Connector​

In ECOSIRE, go to Sales → Shopify → Configuration:

FieldValue
Shop URLhttps://your-store.myshopify.com
API Access TokenThe token from Step 2
API Version2024-01 (recommended)
WarehouseSelect your default warehouse
Default PricelistSelect the Shopify pricelist

Click Test Connection. You should see "Connection successful."

Step 4 — Configure Sync Settings​

Under Shopify → Sync Settings:

  • Order sync: Auto (webhook) + scheduled fallback every 15 minutes
  • Product sync direction: ECOSIRE → Shopify (one-way) or Bidirectional
  • Inventory sync: Enable real-time inventory push
  • Customer creation: Auto-create Odoo contact on first Shopify order

Step 5 — Register Shopify Webhooks​

The connector auto-registers webhooks in Shopify. Verify them under Shopify Admin → Settings → Notifications → Webhooks:

TopicEndpoint
orders/createhttps://api.ecosire.com/api/webhooks/shopify/orders
orders/updatedhttps://api.ecosire.com/api/webhooks/shopify/orders
products/createhttps://api.ecosire.com/api/webhooks/shopify/products
products/updatehttps://api.ecosire.com/api/webhooks/shopify/products
inventory_levels/updatehttps://api.ecosire.com/api/webhooks/shopify/inventory

If any webhooks are missing, click Re-register Webhooks in ECOSIRE.

Step 6 — Run Initial Sync​

To import your existing Shopify data:

  1. Go to Shopify → Import.
  2. Select what to import: Products, Customers, Orders (last 90 days recommended).
  3. Click Start Import. Large stores may take 10–30 minutes.
  4. Monitor progress in Shopify → Sync Logs.

Step 7 — Verify the Integration​

  1. Place a test order on your Shopify store.
  2. Within 30 seconds, confirm it appears in ECOSIRE → Sales → Orders.
  3. Check the synced customer in ECOSIRE → Contacts.
  4. Update inventory for a product in ECOSIRE; verify Shopify stock updates.

Troubleshooting​

IssueSolution
Orders not syncingCheck webhook delivery in Shopify Admin → Notifications → Webhooks → Recent deliveries
Connection test failsVerify the API token has not been rotated in Shopify
Duplicate contactsEnable "Match by email" in Connector settings
Inventory mismatchRun Sync → Force inventory push from the connector menu
401 from Shopify APIRegenerate the Custom App token and update in ECOSIRE

Next Steps​

Last updated on