Skip to main content

BigCommerce Store Management

Connect your BigCommerce store to Odoo using the BigCommerce REST API v3. This module uses API Token authentication with the X-Auth-Token header to synchronize products, variants, orders, customers, and inventory between your BigCommerce storefront and Odoo ERP. Manage your entire e-commerce catalog, process orders, and track fulfillment from a unified OWL 2 dashboard.

Compatibility: Odoo 17 / 18 / 19 Price: $349 (one-time) License: Up to 3 domain activations

Key Features​

  • BigCommerce REST API v3 integration with API Token auth
  • Bidirectional product and variant synchronization
  • Automatic order import with customer creation
  • Real-time inventory sync across warehouses
  • Category and brand mapping
  • Product image synchronization
  • Multi-storefront support
  • Webhook-based real-time updates
  • Coupon and discount code sync
  • Shipping method mapping
  • Customer group management
  • Tax class configuration

Prerequisites​

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

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  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
  6. Enter your ECOSIRE license key when prompted

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. Set the required OAuth scopes:
    • Products: modify
    • Orders: modify
    • Customers: modify
    • Content: read-only
  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
    • Client ID (client_id) -- optional, sent as X-Auth-Client header
  3. Click Test Connection to verify API access
  4. Configure your default warehouse and company mapping

Step 3: Configure Sync Settings​

Product Sync​

  • Choose sync direction: BigCommerce-to-Odoo, Odoo-to-BigCommerce, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and category mapping
  • Map BigCommerce product identifiers (SKU, ID) to Odoo products

Inventory Sync​

  • Map Odoo warehouses to BigCommerce inventory locations
  • Set buffer stock quantities if needed
  • Enable real-time stock updates on changes

Order Sync​

  • Enable automatic order import
  • Map BigCommerce payment methods to Odoo payment journals
  • Configure fulfillment sync to push tracking numbers
  • Set up order status filter rules

Initial Sync​

  1. Go to BigCommerce Store Management > Operations > Initial Import
  2. Select data types to import (Products, Customers, Orders)
  3. Set date range for historical orders
  4. Click Start Import and monitor progress in the sync log

API Details​

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

Dashboard​

The built-in OWL 2 dashboard provides real-time visibility into your integration:

  • 6 KPI cards -- Revenue, Orders, Customers, Products, Avg Order Value, and Sync Health -- each with period-over-period delta indicators
  • Sales Trend chart (Chart.js line chart) with interactive date filtering
  • Order Status breakdown (doughnut chart) showing distribution across statuses
  • Period filters -- Today, 7 days, 30 days, 90 days, Year, or Custom date range
  • Activity feed showing recent sync log entries with type indicators
  • Quick action buttons for Products, Orders, Customers, Queue, Logs, and Settings
  • Status footer with Queue Jobs, Errors, Out of Stock, and Sync Rate
  • Auto-refresh every 60 seconds with dark mode support

Troubleshooting​

IssueSolution
Connection failedVerify API credentials; check network connectivity
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Duplicate productsReview product mapping; ensure SKU matching is configured
Orders not importingVerify order status filters and date range settings
403 ForbiddenVerify API Token has correct OAuth scopes for the resource
Store Hash incorrectCheck the alphanumeric segment from your admin URL
Webhook not firingEnsure your Odoo instance has a publicly accessible URL
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on