Logo

How to integrate with BigCommerce

Learn how to integrate Starshipit with BigCommerce to import your orders and ensure tracking information is written back when you print a label.

4 min readUpdated February 18, 2025

How to set up BigCommerce in Starshipit

1. Create an API user in BigCommerce

  1. Before you can integrate with BigCommerce, create a user API account for BigCommerce. Ensure you select V2/V3 API token when creating the API account.
  2. Set the OAuth scopes.
    Note: You only need to define the scopes listed below while leaving any other unlisted settings unchanged.
Name Scope
Content modify
Checkout Content modify
Customers modify
Customers Login login
Information & Settings modify
Marketing modify
Orders modify
Order Transactions modify
Create Payments create
Get Payment Methods read-only
Products modify
Themes modify
Carts modify
Checkouts modify
Sites & Routes modify
Channel Settings modify
Channel Listings modify
Storefront API Tokens manage
Storefront API Customer Impersonation Tokens Manage
Note

Take note of the API Path, Client ID and Access Token supplied by BigCommerce as you will not be able to view your credentials again.

2. Copy the API information into Starshipit

Once you have generated the API credentials from BigCommerce, you need to enter your credentials in the Starshipit settings pages.

  1. In Starshipit, go to Settings > Integrations > Add a new integration > BigCommerce
  2. Choose a name that will help you to differentiate this store from your other BigCommerce stores
  3. Leave the Username field empty; it is not used by the integration that you are performing
  4. Complete API Path, Client ID, Access Token with the information from BigCommerce.
  5. Click on Save

MicrosoftTeams-image__46_.png

3. Status to Update

You can select the status of the orders you wish to import using the following BigCommerce order status codes:

  • Status 9 = Awaiting Shipment
  • Status 11 = Awaiting Fulfillment
  • Status 2 = Shipped [For Update Order]
  • Status 10 = Completed [For Update Order]

See the entire list of order status codes.

4. Import your orders

  1. Click the Shipments tab at the top of the page in Starshipit.
  2. Once you are on the Shipments page, click the Import button, and select BigCommerce and the number of days you wish to import.
  3. Click Import at the bottom right.
  4. After a brief load time, the number of imported orders will be displayed.
  5. Click Close and your shipping page will reload with the newly imported orders.

Advanced settings and information

  • Product Options: Starshipit will import the product options with the following display names:
    • Size
    • HS Code
    • Color or Colour
  • Pick up in Store: If you would like to use Starshipit for Pickup in Store orders select "Enable Pickup in Store". This setting enables any shipments printed with a Pickup In-Store carrier to have it's status updated to "Awaiting Pickup" upon Writeback

Manage multiple storefronts

How it works

When enabled, the Import Channel ID as a tag setting automatically tags the order with the Storefront ID when they are imported into Starshipit. This allows you to use Starshipit to manage multiple storefronts in BigCommerce seamlessly.

With this setting, you can:

  • Filter orders
    Use the orders grid to filter by specific store IDs
  • Create rules
    Automate workflows using tags, e.g. "If Tag = [Storefront ID], assign to X account" or "Set carrier to X".

This rounds out our BigCommerce storefront offering, as we also support writeback for multi-storefront setups.

How to enable it

  1. Navigate to Settings > Integrations > BigCommerce.
  2. Scroll to the bottom of the page.
  3. Tick the checkbox for Import Channel ID as a Tag.

Was this article helpful?

Related Articles