All Collections
How the BigCommerce integration works
How the BigCommerce integration works
Joe Clover avatar
Written by Joe Clover
Updated over a week ago


With the BigCommerce integration, you can:

  • Make your Heartland Retail inventory across all locations available to sell online (or you can filter so that only certain locations populate inventory online)

  • Pull down all of your BigCommerce item catalog information into Heartland Retail so you can get up and running quickly

  • Process and fulfill web orders from BigCommerce in your Heartland Retail account

  • See your ecommerce and store sales all within Heartland Retail

Connecting your accounts

If you have existing product quantities on BigCommerce before connecting your account, make sure that you've imported that information into Heartland Retail. As it will be the master record holder of inventory quantities and will sync that information up to BigCommerce once connected.

In your Heartland Retail account, navigate to Settings > Integrations > BigCommerce.

Next, click the "Add a BigCommerce website" button and the link on the next page.

You will be redirected to your BigCommerce account and you will be asked to login to it if you have not already done so. Upon logging in, you will see this page:

Next, click the "Install" button.

Next, click the "Confirm" button. Once the connection is complete, you will see a link that will redirect you back to your Heartland Retail account.

Configuring the integration

To configure the integration in Heartland Retail, navigate to Settings > Integration > BigCommerce.

Click the "Manage" button. This will take you to the main configuration page, where you will see four tabs: Items Information, Inventory, Order Fulfillment and Errors.

Items Information

This tab allows you to configure whether or not you will sync item catalog information between BigCommerce and Heartland Retail.

Manage information for BigCommerce manually
By default, the "Manage information for BigCommerce connection manually" option is checked. When this option is checked, item catalog information will not sync automatically between the two systems. Instead, you need to create items in both systems. When using the manual sync, you need to ensure that the Item # in Heartland Retail and the SKU # in BigCommerce are the same for the items -- this is how the system links the items between the two systems for the purposes of inventory availability on your BigCommerce store.

Pushing items from Heartland Retail to BigCommerce

We recommend that you push items from Heartland Retail to BigCommerce. For more information about how to do that, read this article.

Pulling items from BigCommerce into Heartland Retail

If you are new to Heartland Retail and have an existing BigCommerce account, you also have the option to "Pull item information down from BigCommerce":

When this option is selected, and when the "Trigger Full Sync" button is clicked, we will automatically pull down all item catalog information from BigCommerce. Any custom fields that are needed in Heartland Retail to support data that you are tracking in BigCommerce will be automatically created as part of the full sync.

Over time, as you create new items in BigCommerce, those items will sync automatically to Heartland Retail.


This tab allows you to configure which of your Heartland Retail locations contribute to your BigCommerce inventory availability.

If you don't want all of your locations' inventory to contribute to your BigCommerce inventory availability, you can add individual locations using the "Add Location" button. Or, if you want all locations to contribute, you can just flip the switch on:

Once you have selected locations or flipped the switch on, you can click the "Start Sync" button, which will trigger a full inventory sync between Heartland Retail and BigCommerce.

On an ongoing basis, any inventory changes in Heartland Retail will automatically sync so that your BigCommerce inventory stays up to date in real time.

Order Fulfillment

When a new BigCommerce order is created, it will sync into Heartland Retail as an open, undistributed sales order.

Only BigCommerce orders with the following status will sync to Heartland Retail: 'Awaiting Fulfillment', 'Cancelled', 'Declined', 'Shipped'. We do not sync orders, as an example, that are in the status 'Refunded' or 'Awaiting Pickup'.  If you change the status, in BigCommerce, on an order to one of the 4 status that will sync, they should push thru with the next sync. 

We do not support partial refunds on sales orders in BC. Orders that have been partially refunded in BC will not sync down to Heartland Retail and will need to be closed and recreated in the POS.

In order to use Heartland Retail for fulfillment, you'll need to select a location to run orders through. Although it is not required, we highly recommend that you create a new location in Heartland Retail called "Website" so that you can track your website and store sales separately.

Also, if you will only be fulfilling BigCommerce orders from a single location in your account, you can choose to auto-distribute orders to that location:

If you have multiple store locations that you will fulfill orders from, you should not use the auto-distribute feature. Instead, you'll receive an alert on your dashboard that you have an order that is ready to be distributed.

To learn more about how order distribution works, check out this article.

Once the order has been distributed, you can then fulfill the order and send the item(s) to the customer. Check out this article to learn more about how order fulfillment works in Heartland Retail.

Fulfillment outside of Heartland Retail

If you decide to use a another service for order fulfillment you will be restricted to one location to distribute and fulfill orders from. BigCommerce sales orders will need to be marked as shipped with attached item shipments before a closed invoice can sync down to Heartland Retail. 

What we don't support

Currently, the Heartland Retail to BigCommerce integration does not support the add on product Gift Wrapping. Gift Wrapping as a add on product at the time of the purchase on the website should be turned off in BC. You can still add Gift Wrapping as an individual item with a SKU (Heartland Retail Item #) in BC and on Heartland Retail though. It would need to be added onto tickets just like any other item on your store.

The current Heartland Retail to BigCommerce integration also does not allow for products with customizations on BC. We do not support embroidery or monogramming products which are customized by website customers during the checkout process. 

Payment processing in BigCommerce

Although you'll use Heartland Retail's order fulfillment system to complete the customer's order, Heartland Retail will not handle customer payments. BigCommerce will handle all customer payments and these payments will be reflected in Heartland Retail as "BigCommerce External payments" during the order fulfillment process.

Important: Make sure that you have your BigCommerce payment gateway set up to "Authorize and Capture" at the time the order is placed. If you do not capture payment in BigCommerce when the order is placed, you will encounter problems if you attempt to process multiple shipments against a single order in Heartland Retail.

Did this answer your question?