A dedicated BigCommerce User security group controls access to connector menus and configuration actions within Odoo.

Shows the BigCommerce root menu and configuration flow in Odoo, where users can navigate to Instances and manage connector setup from a centralized location.

Displays the instance setup screen with Store Hash, Access Token, and API Base URL, along with the Test Connection action to validate API credentials and confirm connectivity.

Streamline your inventory by bringing BigCommerce products into Odoo exactly how you need them.

• Bulk Product Import: Select your BigCommerce instance and the "Product" operation to sync your entire catalog in one click.
• Targeted ID Import: Use the "Import Product Using BigCommerce ID" toggle to fetch a specific product by its unique identifier, perfect for quick updates or testing.
• Rich Data Mapping: Automatically imports essential details including product names, variants, attributes, and primary images.

Maintain your storefront's organization by mirroring your BigCommerce category tree within Odoo.

• Hierarchy Preservation: Import categories while maintaining parent-child relationships for a consistent browsing experience.
• Instance-Specific Sync: Choose which store instance to pull categories from to keep multi-store environments organized.
• Individual Category Fetch: Directly import a single category using its BigCommerce ID for precise data management.

Ensure your product branding remains consistent across platforms with dedicated brand synchronization.

• Complete Brand Catalog Sync: Import all associated brands from your BigCommerce store to Odoo with a single operation.
• Selective Brand Import: Enable the ID-based import option to sync specific brands without running a full catalog refresh.

Keep your CRM updated by syncing your BigCommerce customer base directly into Odoo.

• Mass Customer Import: Sync all registered customers, including their contact information and basic profiles, from your selected instance.
• Specific Customer Fetch: Quickly pull a single customer record into Odoo using their BigCommerce ID for immediate order processing or support.
• Unified Records: Create a single source of truth for customer interactions across your e-commerce and ERP platforms.

Configure BigCommerce order statuses to match Odoo order stages for accurate order processing, automated invoicing, and seamless shipping workflow management.

Simplify your sales operations with flexible order synchronization between BigCommerce and Odoo, ensuring accurate order tracking and streamlined processing.

• Complete Order Import: Import all orders from your BigCommerce store into Odoo in a single operation for full order synchronization.
• Single Order Import: Use the Order ID-based import option to fetch and sync a specific order quickly without importing the entire order database.
• Date Range Order Import: Import orders within a selected date range to keep your system updated for specific periods and improve data control.

Maintain accurate stock levels across BigCommerce and Odoo with seamless inventory synchronization, reducing manual effort and preventing stock mismatches for smoother order fulfillment.

• Complete Inventory Sync: Sync all product stock quantities from BigCommerce to Odoo in a single operation for full inventory alignment.
• Scheduled Inventory Updates: Automatically update stock levels using cron-based synchronization to ensure real-time inventory accuracy.
• Manual Inventory Sync: Trigger inventory updates manually whenever needed for instant stock reconciliation and better operational control.

A detailed log system that tracks created/updated counts for products, variants, categories, and customers across all instances.

Centralize your e-commerce management with a high-level visual summary that tracks the scale and connectivity of your BigCommerce ecosystem directly within Odoo.

• Live Entity Statistics: Instantly view total counts for Products, Brands, Categories, Customers and Orders synced from each specific BigCommerce instance.
• Instance Connectivity Status: Monitor the "Connected" health of multiple store environments (e.g., "odooBigcommerce" and "SerpentCS") to ensure data pipelines are active.
• Segmented Data Insights: Manage multi-store setups through dedicated instance cards that segregate data totals, preventing cross-store confusion.
• One-Click Navigation: Use the visual counters as a jumping-off point to access filtered lists of records for each specific store instance.

Keep your Odoo backend perfectly in sync with BigCommerce without manual intervention by leveraging robust automated update settings. This feature allows for seamless, background data refreshes based on your specific business requirements.

• Granular Auto-Update Controls: Individually toggle automatic updates for core entities including Products, Brands, Categories, Orders and Customers to control exactly what data syncs automatically.
• Intelligent Cron Scheduling: Once enabled, the module utilizes background scheduled actions (Crons) to fetch the latest changes from BigCommerce at regular intervals.

The connector ensures every imported BigCommerce order is associated with the correct Odoo pricelist and currency, eliminating manual adjustments and preventing pricing or tax miscalculations. It provides:

• Three-Level Auto-Resolution: Resolves the pricelist through a prioritized lookup — first checking for an explicit pricelist override on the payment mapping row, then a currency override that finds the matching pricelist, and finally auto-detecting the currency from the BigCommerce order's default_currency_code field.
• Multi-Currency Store Support: Seamlessly handles stores selling in multiple currencies (USD, EUR, GBP, etc.) by automatically matching the order's currency to the correct Odoo pricelist — no manual intervention required for each order.
• Gateway-Specific Pricing: Allows you to pin a specific pricelist to a payment gateway — for example, routing all Stripe EUR orders to a "EUR Wholesale Pricelist" with gateway-specific discounts applied automatically on import.
• Refund Currency Consistency: Credit notes generated from BigCommerce refunds always inherit the original sale order's currency, ensuring the refund is posted in the same currency as the original transaction and reconciliation remains clean.
• Fallback Safety: If no pricelist is resolved through any level, the order gracefully falls back to the customer's or company's default pricelist, preventing import failures due to missing configuration.

The connector goes beyond order import by fully managing the refund lifecycle — detecting refunds from BigCommerce and automatically creating the corresponding credit notes in Odoo without any manual steps. It handles:

• Reliable Refund Detection: Identifies refunded orders using three independent signals — a non-zero refunded_amount field (most reliable), status text containing "refund", or BigCommerce status IDs for Refunded (4) and Partially Refunded (14) — bypassing BigCommerce's inconsistent payment_status field.
• Full & Partial Refund Support: Classifies each refund as full or partial by comparing the refunded amount against the original order total. Partial refunds generate proportionally scaled credit note lines directly mirroring the original invoice, while full refunds reverse the entire invoice.
• Automatic Credit Note Creation: Fetches refund details from the BigCommerce /orders/{id}/refunds API and creates a posted out_refund credit note in Odoo, linked directly to the originating sale order and payment mapping journal for accurate accounting.
• Duplicate Prevention: Each BigCommerce refund ID is tracked in a dedicated bigcommerce.refund record with a unique constraint, ensuring the same refund is never imported twice even across repeated sync runs.
• Sync Status Tracking & Retry: Every refund record exposes a sync status — Pending, Synced, or Error — along with a detailed message for failed records. Failed refunds can be retried individually from the refund form without re-running a full import.

Create one bank/cash journal per payment gateway used in BigCommerce

Create one pricelist per currency your BC store sells in (even if prices are the same — currency matters)

Add a payment mapping row for each BC payment method (stripe, PayPal, Credit Card, manual, etc.)

Mark exactly one row per instance as Default to handle unknown methods

Enable currencies in Odoo (Accounting → Currencies → activate USD, EUR, GBP as needed)

Test import one paid order and one refunded order from BC before bulk sync