Overview

This document will cover how to connect BigCommerce as a channel and what integrations we support with BigCommerce.

How to Connect

OAuth2 Connection

Enter your channel integration page

1. Click Add Connection

2. Click New Connection

3. Click BigCommerce

4. Fill in the connection requirements

• Connection Requirements: Connection Name, Store Hash

Locating Store Hash:

Copy the Alpha-numeric Code from the Bigcommerce Admin URL.

Your store URL might be: https://store-123456789.mybigcommerce.com/

In this case, "123456789" is your store hash.

Important:

• Once you click continue you will be redirected to login to BigCommerce and must confirm this connection for the integration to work 

**Please note - You can use the same connection for each type of integration. You do not need to create a new connection every time. 

API Key Connection

Enter your BigCommerce storefront

1. Click Settings

2. Click Store-level API accounts under the API section

3. Click Create API account

4. Select the below fields and click save

5. Copy your credentials

Enter Flx's channel integration page

1. Click Add Connection

2. Click New Connection

3. Click BigCommerce

4. Fill in the connection requirements

• Connection Requirements: Connection Name, Store Hash, Client ID, Access Token

Locating Store Hash:

Copy the Alpha-numeric Code from the Bigcommerce Admin URL.

Your store URL might be: https://store-123456789.mybigcommerce.com/

In this case, "123456789" is your store hash.

Supported Operations

Import Listings SUPPORTED

Publish Listings SUPPORTED

Sync Listings SUPPORTED

Get Orders SUPPORTED

Sync Orders SUPPORTED

Operation Breakdowns

Import Listings SUPPORTED

Set Your Master SKU

• Select if your Master SKU will be from the UPC, SKU, or MPN

Set New Listings to Paused

• When listings are imported, they can be set to paused, meaning no pricing or quantity information will be synced to the BigCommerce from FLX. This allows for time to link to your inventory and validate pricing and quantity information before you enable syncing back to BigCommerce.

Advanced Settings

• Create Only: BigCommerce listings will be imported and linked to existing FLX listings based on SKU. If there is not a SKU match to an existing FLX listing, a new listing will be created.
• Create & Overwrite Existing: BigCommerce listings will be imported and linked to existing FLX listings based on SKU. For all SKU matches, the listing data in FLX will be overwritten by the imported Shopify listing data. If there is not a SKU match to an existing FLX  listing, a new listing will be created.
  • If Create & Overwrite Existing is selected, you will need to choose from the option above it if you would like to update product data

If Set New Listing to Paused

• Pausing Listings will need to be unpaused, so they can go through the workflow
• Unpause the listings by going to Products ---> Select Listings --> Actions --> Change Listing Status --> Unpause Listings

Publish Listings SUPPORTED

The Publish Listings operation, creates new listings of your products on your BigCommerce store.

Override Product Names: Selecting "Yes" will allow FLX to override/replace the product name that is shown on BigCommerce with the product name in FLX and selecting "No" will keep the existing product name

Attribute Length: Attribute Fields can not exceed 250 characters. If one or more of your listings has an Attribute Name or Value over 250 characters, please consider using the "Truncate to 250 characters" configuration in our tool, or renaming the Attribute Names and Values.

Three Options:

• Truncate To 250 Characters
  • This will take up to 250 Characters
• Skip Customs Fields
  • This will just leave them blank
• Fail Product
  • Will not create the product

Sync Listings SUPPORTED

The Sync operation syncs any changes that have been made to listings since the last time the sync process was performed.

Delisting

SUPPORTED How delisting works with Bigcommerce

Delisting permanently removes the product from your Bigcommerce channel listing, can only be brought back to listed status again after running the sync/publish job is made to run. Must Delist all variants if multiple exist.

Hide

SUPPORTED Hiding the product for Bigcommerce channel listing

How to hide products within Bigcommerce

1. Click Settings

2. Scroll down until you find the Products Section

3. Click Inventory

4. Click "When a product is out of stock" to get the dropdown

Important options

• Hide the product
  • This removes the product from the product listing page
• Hide the product, but leave the product page accessible
  • This removes the product from the product listing page, however it still allows the products page to be accessed via a specific URL or a search engine
• Redirect to category page
  • This removes the product from the product listing page and redirects anyone trying to access the product via a specific URL to the products' category page
• Do nothing
  • leaves the product page up on the product listing page

Hiding Within FLX 

You'll need to hide the FLX Listing Parent because you must hide all variants if multiple exist. This translates to the BigCommerce availability setting being disabled. _Hiding the listing temporarily sets the product to a state where it appears as _Out of stock on your BigCommerce channel, making sure there are no unwanted orders for the variant.

Unhide

SUPPORTED Unhiding the product for BigCommerce channel listing

Unhiding can only be used for the product variants that are already in a hidden status to bring the product back live for BigCommerce sales channel. Must Unhide all variants if multiple exist.

Get Orders SUPPORTED

The Get orders operation retrieves any new Orders from the BigCommerce that have not yet been imported and will send back Acknowledgements for those Orders if needed.

Order Pull Status

Pending or Incomplete — Customer started the checkout process but did not complete it. Incomplete orders are assigned a "Pending" status and can be found under the More tab in the View Orders screen.

Awaiting Payment — Customer has completed the checkout process, but payment has yet to be confirmed. Authorize only transactions that are not yet captured have this status.

Awaiting Pickup — Order has been packaged and is awaiting customer pickup from a seller-specified location.

Awaiting Shipment — Order has been pulled and packaged and is awaiting collection from a shipping provider.

Awaiting Fulfillment — Customer has completed the checkout process and payment has been confirmed.

Partially Refunded — Seller has partially refunded the order Specifically, this will sync back components like tracking information, shipping information and carrier information

Advanced Settings

Personal Identifying Information Retention

• Determine how long you would like to keep personal identifying information on orders

Get Orders Created Within The Last X Days

•  If left blank FLX will pull all orders no matter when they were created

My orders are not importing. What should I do?
1. The order status on your store may not match the order status Flxpoint is looking for based on your configuration. Please double-check the order status and integration configuration.

2.The order may be "too old" for Flxpoint to import. Under Configure Settings, you can select the date range of orders to import. Please verify that the missing imported order's creation date is within the date range selected in Configure Settings.

Sync Orders SUPPORTED

Sync Orders will sync any changes that have been made to Orders since the last time sync was performed to BigCommerce channel Specifically, this will sync back components like Order Shipments

Specifically, this will sync back components like tracking information, shipping information and carrier information