How to integrate with BigCommerce

Connect BigCommerce to Starshipit to import orders and write back tracking details when labels are printed.

Use this setup when you want BigCommerce and Starshipit to stay in sync for fulfilment workflows.

What you need before you start

• Admin access to your BigCommerce store
• Admin access to your Starshipit account
• A BigCommerce API account using a V2/V3 API token

1. Create an API account in BigCommerce

Use this step to generate the credentials Starshipit needs to connect.

1. In BigCommerce, create a user API account for BigCommerce.
2. Select V2/V3 API token.
3. Set the OAuth scopes listed below and leave unlisted scopes unchanged.

These permissions allow Starshipit to import orders and update tracking details correctly.

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

After this step, you will have the API credentials needed for Starshipit.

2. Enter your BigCommerce API credentials in Starshipit

Use this step to create and save the integration in Starshipit.

1. In Starshipit, click Settings > Integrations > Add a new integration > BigCommerce.
2. Enter a store name that helps you identify this BigCommerce store.
3. Leave Username empty.
4. Enter API Path, Client ID, and Access Token from BigCommerce.
5. Click Save.

After you save, BigCommerce is connected and ready for import.

3. Choose which BigCommerce order statuses to import

Use these status codes to control which orders are imported into Starshipit.

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

See the full list of BigCommerce order status codes.

After choosing statuses, Starshipit imports only orders that match your selected status values.

4. Import orders from BigCommerce

Use this step when you want to run your first import or manually refresh orders.

1. Click the Shipments tab at the top of the page in Starshipit.
2. Click Import, then select BigCommerce and the number of days to import.
3. Click Import at the bottom right.
4. Review the number of imported orders.
5. Click Close.

After import completes, the Shipments page reloads with your newly imported orders.

Advanced settings

Authority to Leave (ATL)

BigCommerce Authority to Leave is supported.

For ATL to import correctly from BigCommerce:

• The billing form field name must be Delivery Option.
• The field value must contain either authority to leave or signature required.

Product options

Starshipit imports product options when they use these display names:

• Size
• HS Code
• Color or Colour

Pick up in store

Use this option when you want Starshipit to process BigCommerce pickup orders.

1. Open your BigCommerce integration settings in Starshipit.
2. Tick Enable Pickup in Store.
3. Click Save.

When enabled, shipments printed with a pickup in-store carrier are written back as Awaiting Pickup.

Manage multiple storefronts

How it works

When enabled, Import Channel ID as a tag adds each order's Storefront ID as a tag in Starshipit. This helps you manage multiple BigCommerce storefronts in one account.

With this setting, you can:

• Filter orders in the orders grid by specific storefront IDs.
• Create rules using storefront tags, for example: If Tag = [Storefront ID], assign to X account.

Starshipit also supports writeback for multi-storefront setups.

How to enable it

Use this option when you run multiple BigCommerce storefronts and need storefront-specific filtering or rules.

1. Click Settings > Integrations > BigCommerce.
2. Scroll to the bottom of the page.
3. Tick Import Channel ID as a Tag.
4. Click Save.

When ticked, Starshipit imports each order with its storefront ID as a tag. When unticked, storefront ID tags are not added on import.