Skip to main content

BigCommerce Store Management

Connect your BigCommerce store to Odoo using the BigCommerce REST API (v3 catalog, customers and inventory; v2 orders). The module authenticates with your API token in the X-Auth-Token header, imports orders automatically every hour, and gives you wizard-driven import and export for products, customers and stock levels — all monitored from an OWL dashboard.

Compatibility: Odoo 17 / 18 / 19 Price: $499 (one-time) Current version: 19.0.2.2.0 on Odoo 19 License: OPL-1 — installs and runs standalone, no activation key

Key Features​

  • API Token authentication against https://api.bigcommerce.com/stores/{store_hash}
  • Automatic hourly order import with on-demand Sync Orders button
  • Idempotent imports — re-running refreshes records instead of duplicating them
  • Catalog import: BigCommerce products become Odoo product templates (matched on BigCommerce id, then SKU)
  • Catalog export: push Odoo products to BigCommerce, optionally with new variants and the product image
  • Customer import (matched on BigCommerce id, then email) and batch customer export
  • Inventory: pull store stock levels into the mapped Odoo warehouse, or push Odoo's on-hand back to the store as an absolute set
  • Fault-tolerant sync runs — one rejected record is logged and skipped, never aborting the batch
  • Connection test wizard plus a daily connection-test scheduled action
  • Sync logs, queue with retry/cancel, and mapping wizards under Operations
  • OWL dashboard with live KPIs, sales trend, order status breakdown and activity feed
  • Multi-company safe — every connection is bound to an Odoo company with record rules

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • A BigCommerce store with an active plan
  • BigCommerce API credentials (Store Hash + API Token)

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard or your Odoo App Store purchase
  2. Extract to your Odoo addons directory: 
    unzip ecosire-bigcommerce-*.zip -d /opt/odoo/addons/
  3. Restart the Odoo service: 
    sudo systemctl restart odoo
  4. Navigate to Apps, click Update Apps List
  5. Search for the module and click Install

There is no separate licence module and no activation step — the connector runs standalone once installed.

Configuration​

Step 1: Obtain BigCommerce API Credentials​

  1. Log in to your BigCommerce admin panel
  2. Navigate to Advanced Settings > API Accounts > Create API Account
  3. Select V2/V3 API Token
  4. Grant the token at least modify access to Products, Orders and Customers, and read access to Inventory
  5. Click Save and note your Store Hash and API Token
  6. The Store Hash is the alphanumeric segment in your API path (e.g., abc123 from store-abc123.mybigcommerce.com)

Step 2: Connect in Odoo​

  1. Navigate to BigCommerce Store Management > Configuration
  2. Create a new configuration and enter:
    • Store Hash (store_hash) -- your BigCommerce store identifier
    • API Token (api_token) -- the V2/V3 API token, sent as X-Auth-Token
    • Client ID (client_id) -- optional, sent as X-Auth-Client
    • Company -- the Odoo company this connection belongs to
  3. Run Test Connection (Operations menu, or the button on the configuration) to verify API access
  4. Enable Sync Orders on the connection to turn on the hourly order import

Step 3: Import your data​

  1. Go to BigCommerce Store Management > Operations > Import Wizard
  2. Select data types to import (Products, Customers, Orders, Inventory)
  3. Set an import limit per type and whether missing records may be created
  4. Click Start Import and review the result counters and the sync log

Use the Export Wizard next to it to push Odoo products (optionally with variants and images), contacts and stock levels back to BigCommerce.

API Details​

FieldValue
Auth methodAPI Token via X-Auth-Token header
Base URLhttps://api.bigcommerce.com/stores/{store_hash}
API versionv3 (catalog, customers, inventory) / v2 (orders)
Content-Typeapplication/json
Key config fieldsstore_hash, api_token, client_id

Dashboard​

The built-in OWL 2 dashboard (BigCommerce > Dashboard) reads straight from your synced records:

  • KPI cards -- Sales, Orders (with period-over-period delta), Customers, Products, Average Order Value and Sync Success Rate, plus an out-of-stock counter
  • Sales Trend chart (Chart.js line chart) built from your imported orders
  • Order Status breakdown (doughnut chart)
  • Top products by revenue and a recent-activity feed from the sync log
  • Period filters -- Today, 7 days, 30 days, 90 days, Year, or a custom date range
  • Status footer with queue jobs, errors, out-of-stock count and sync rate

If no configuration exists yet, the dashboard says so instead of showing empty numbers.

Troubleshooting​

IssueSolution
Connection failedVerify Store Hash and API Token; run Test Connection and read the platform error text
Orders not importingEnable Sync Orders on the connection and check Odoo's scheduled actions are running
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Some records failBy design the run continues; check the Logs under Operations for the failing record
Duplicate productsImports match on BigCommerce id then SKU; link hand-created records via the Mapping Wizard
403 Forbidden from the APIVerify the API Token has the right OAuth scopes for the resource
Store Hash incorrectCheck the alphanumeric segment from your admin URL

Support​

Last updated on