Articles in this section

Install the BigCommerce - NetSuite integration app

Saikumar Rachamalla
Updated

Installing the BigCommerce - NetSuite integration app connects your NetSuite account and your BigCommerce store through integrator.io so the integration app's flows can sync orders, customers, fulfillments, inventory, and items. You enable the required NetSuite features, install two Celigo bundles in NetSuite, install the integration app from Marketplace, and then configure its NetSuite and BigCommerce connections. This article is for integrator.io administrators with NetSuite administrator access and access to the BigCommerce store's control panel.

Prerequisites: Make sure that the NetSuite account you use for the connection has owner access and can access all subsidiaries.

Choose a dedicated or shared user license

The integration app signs in to NetSuite and BigCommerce with a user login for each application. Celigo recommends a dedicated license for each application, which the integration app uses alone, instead of a license that you share with a person.

  • Dedicated license: Avoids login conflicts. For example, NetSuite allows one session per login, so if someone signs in with the same credentials that the integration app or a Celigo resource is using, the other session is signed out. A dedicated license also makes auditing clearer, because you can tell changes made by the integration app apart from changes made by people.
  • Shared license: Costs less in applications that charge per user license, such as NetSuite, but it's harder to tell which records the integration app created or updated.

Weigh the trade-offs and choose what fits your business.

Enable the required NetSuite features

The Celigo integrator.io bundle (bundle ID 20038) installs only if these NetSuite features are turned on.

  1. In NetSuite, go to Setup > Company > Enable Features > Company.
  2. Under Data Management, select FILE CABINET.
  3. Under SuiteCloud, select CUSTOM RECORDS, CLIENT SUITESCRIPT, SERVER SUITESCRIPT, and WEB SERVICES.
  4. Select Save.

If the bundle installation fails, see integrator.io bundle installation fails.

Install the Celigo bundles in NetSuite

The integration app needs two Celigo bundles in your NetSuite account: integrator.io (bundle ID 20038) and Celigo BigCommerce Connector (bundle ID 119235).

  1. In NetSuite, go to Customization > SuiteBundler > Search & Install Bundles.
  2. Search for Celigo integrator.io, and install bundle ID 20038.
  3. Search for Celigo BigCommerce Connector, and install bundle ID 119235.

Install the integration app

  1. In integrator.io, go to Marketplace marketplace-icon.png.

  2. Select BigCommerce, and then select Install on the BigCommerce - NetSuite integration app.

    If you see Contact Sales instead of Install, contact your Celigo account executive to check your integration app license.

  3. On the BigCommerce - NetSuite tile, select Setup.

The setup page lists four steps: NetSuite Connection, BigCommerce Connection, Integrator Bundle, and BigCommerce Bundle. Complete them in the order shown in the following sections.

Configure the NetSuite connection

  1. For NetSuite Connection, select Click to Configure.
  2. Configure the connection with token-based authentication. For steps, see Set up token-based authentication for the NetSuite connection.

Create a BigCommerce API account

The BigCommerce connection uses the access token, store hash, and client ID of a BigCommerce API account. You get these values when you create the API account.

  1. Sign in to your BigCommerce store's control panel.
  2. Go to Advanced Settings > API Accounts, and then select Create API Account.
  3. Enter a Name for the API account.

  4. Under Oauth Scopes, set these scopes:

    • Content: read-only
    • Customers: read-only
    • Customers Login: None
    • Information: read-only
    • Marketing: read-only
    • Orders: modify
    • Products: modify
  5. Note the store hash, which is the part of the API Path between /stores/ and /v3/. For example, in https://api.bigcommerce.com/stores/g3uz5c7jx/v3/, the store hash is g3uz5c7jx.
  6. Select Save. The BigCommerce API credentials page shows the Access Token and Client ID. Copy them.

Configure the BigCommerce connection

  1. For BigCommerce Connection, select Click to Configure.

  2. For Authentication Type, select one of these, and enter its details:

  3. Select Test. When the connection works, you see the message Connection is working fine.
  4. Select Save.

Note: You can't delete an online or offline connection after you configure it.

Verify the NetSuite bundles

  1. For Integrator Bundle, confirm that the status shows Installed. If you see Click to Install, select it, sign in to NetSuite, and then select Verify Now.
  2. For BigCommerce Bundle, select Verify Now. If you see Click to Install, select it, sign in to NetSuite, and then select Verify Now.

After setup, map your shipping and payment methods before you sync orders. For details, see Map shipping and payment methods.