BigCommerce Connector

Overview

The BigCommerce connector allows you to import products directly from a BigCommerce store into your WooCommerce store. This enables real-time synchronization of product data, including prices, inventory, descriptions, images, variants, and orders.

The connector uses BigCommerce's Storefront API (v3) to fetch product data. You'll need to create a Store-level API account in your BigCommerce admin and obtain an access token.

Prerequisites

Setting Up BigCommerce Credentials

Step 1: Find Your Store Hash

Your store hash can be found in several ways:

1. From your store URL: If your store URL is store-abc123.mybigcommerce.com, your store hash is abc123
2. From API path: In any API documentation, look for stores/{hash}/v3/...
3. From BigCommerce Admin: Go to Settings → Store-level API Accounts

Step 2: Create a Store-level API Account

1. Log in to your BigCommerce admin panel
2. Navigate to Settings → Store-level API Accounts
3. Click Create API Account
4. Fill in the account details:
   • Account Name: Enter a descriptive name (e.g., "PrimeLink Import")
   • OAuth Scopes: Select the required permissions (see below)

Step 3: Configure OAuth Scopes

Select the required OAuth scopes for your API account:

Step 4: Generate Access Token

1. After configuring scopes, click Save
2. BigCommerce will generate an Access Token
3. Copy the access token immediately

Step 5: Alternative - Using Account UUID

If you have an Account UUID instead of Store Hash:

• You can use Account UUID as an alternative to Store Hash
• PrimeLink will attempt to resolve the Store Hash from the Account UUID
• If resolution fails, you'll need to provide the Store Hash directly

Configuring PrimeLink

Step 1: Start a New Import

1. Navigate to PrimeLink → Imports → New Import
2. Select the import type (e.g., Products, Orders, Customers)
3. Click Next to proceed to Step 2

Step 2: Select Platform Source

1. In Step 2, select Import from Platform (Real-time)
2. Choose BigCommerce from the platform dropdown

Step 3: Enter Credentials

Fill in the BigCommerce connection form:

Step 4: Test Connection

1. Click the Test Connection button
2. PrimeLink will attempt to connect to your BigCommerce store
3. If successful, you'll see a confirmation message
4. If it fails, verify your credentials and store hash

Step 5: Continue with Import

After a successful connection test:

1. Click Next to proceed
2. PrimeLink will fetch data from BigCommerce
3. Continue with the rest of the import wizard (mapping, options, etc.)

How BigCommerce Import Works

Product Fetching

PrimeLink uses BigCommerce's Storefront API (v3) to fetch products:

• Products are fetched in batches (up to 250 per request)
• Uses pagination with page parameter
• Fetches all product variants, images, and metadata
• Supports filtering by product status and visibility

Data Mapping

BigCommerce product data is automatically mapped to WooCommerce fields:

• Title: Product name
• Description: Product description (HTML)
• Price: Product price
• SKU: Product SKU
• Inventory: Stock quantity and status
• Images: Product images (primary and gallery)
• Variants: Product variants and options
• Attributes: Product custom fields

Order and Customer Import

BigCommerce connector also supports importing orders and customers:

• Orders: Full order data including line items, billing, and shipping addresses
• Customers: Customer accounts with contact information
• Requires appropriate OAuth scopes (Orders: Read, Customers: Read)

Incremental Updates

For scheduled imports, PrimeLink tracks the last imported page and only fetches new or updated items, making subsequent imports faster.

Troubleshooting

Best Practices

Next Steps