# NetSuite Integration
URL: https://support.starshipit.com/articles/213384326-netsuite-integration
Canonical: https://support.starshipit.com/articles/213384326-netsuite-integration
Markdown: https://support.starshipit.com/articles/213384326-netsuite-integration.md
Updated: 2026-05-06

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Integrate your NetSuite platform with Starshipit to import orders and write back tracking information when you print labels.

Integrate your NetSuite platform with Starshipit to import orders and write back tracking information when you print labels. You can configure Starshipit to import Item Fulfilments, Sales Orders or Invoices.

## Integrating with NetSuite

You will be creating web service access in NetSuite for Starshipit and then entering the authentication details in Starshipit.

### 1. Enabling the Token-based Authentication Feature in NetSuite

1. Go to **Setup** > **Company** > **Enable Features**.
2. Click the **SuiteCloud** subtab.
3. In the SuiteScript section, check the following boxes:
   * Client SuiteScript
   * Server SuiteScript
4. Scroll to the **Manage Authentication** section.
5. Check **TOKEN-BASED AUTHENTICATION** box.
6. Click **Save**.

### 2. Setting Up Token-based Authentication Roles in NetSuite

1. Go to **Setup** > **Users/Roles** > **Manage Roles** > **New**.
2. Enter **Starshipit Integration Role** in **Name** field.
3. Check **WEB SERVICES ONLY ROLE** box in **Authentication** section.
4. Click the **Permissions** subtab.
   1. Add Permissions for **Transactions**:
      * **Find Transactions** (Full Level)
      * **Fulfill Orders** (Full Level)
      * **Item Fulfillment** (Full Level)
      * **Sales Order** (Full Level)
   2. Add Permissions for **Lists**:
      * **Items** (Full Level)
      * **Currency** (Full Level)
   3. Add Permissions for **Setup**:
      * **User Access Tokens** (Full Level)
      * **Soap Web Services** (Full Level)
5. Click **Save**.

### 3. Assigning Users to Token-based Authentication Roles in NetSuite

1. Go to **Setup** > **Users/Roles** > **Manage Users**.
2. Choose an **Administrator** user, then select **Edit**.
3. Click the **Access** subtab.
4. Add **Starshipit Integration Role** into the **Roles**
5. Click **Add**.
6. Click **Save**.

### 4. Creating Applications for Token-based Authentication in NetSuite

1. Go to **Setup** > **Integration** > **Manage Integrations** > **New**.
2. Enter **Starshipit TBA** in **Name** field.
3. Check the **USER CREDENTIALS** box on the **User Credentials** subtab.
4. Uncheck **AUTHORIZATION CODE GRANT** under **OAuth 2.0** subtab.
5. Uncheck **TBA: AUTHORIZATION FLOW** under **Token Based Authentication** subtab.
6. Check the **TOKEN-BASED AUTHENTICATION** box on the **Authentication** subtab.
7. Click **Save**.
8. The **User Credentials** subtab will display the **Consumer Key** and **Consumer Secret** for this integration. Please note them down for later use.

### 5. Creating and Assigning a TBA Token in NetSuite

1. Go to **Setup** > **Users/Roles** > **Access Tokens** > **New**.
2. Select **Starshipit TBA** as the **Application Name** in the drop down.
3. Select the **User** that you assigned **Starshipit Integration Role** with previously.
4. Select **Starshipit Integration Role** as the **Role**.
5. Click **Save**.
6. The confirmation page will display the **Token ID** and **Token Secret**. Please note them down for later use.

### 6. Obtaining Web Service Account ID in NetSuite

1. Go to **Setup** > **Integration** > **Web Services Preferences**.
2. Note down the **ACCOUNT ID** value for later use.

### 7. Entering NetSuite Integration Details in Starshipit

1. Log into [Starshipit](https://app2.starshipit.com).
2. Go to **Settings** > **Integrations**.
3. Click **Add a new integration**then select **NetSuite**.
4. Tick **Enable NetSuite**.
5. Enter the **Web Service Account ID**.  
   *Please note that the Account ID is **case-sensitive**, so be sure to enter it exactly as provided. We recommend using Caps Lock.*
6. Select **Token-Based** as the Authentication Method.
7. Please enter the values you have noted down from NetSuite:  
   * **Consumer Key**
   * **Consumer Secret**
   * **Token ID**
   * **Token Secret**
8. **Select Import Type**Under the "Import Type" section, choose whether you want to import Sales Orders, Invoices, or Item Fulfilments into your Starshipit account.
9. **Specify Status to Import**From the "Status to Import" section, select the appropriate order statuses that you want to import into Starshipit.
10. Click **Save**.
11. Click **Test to ensure it works** to check the integration connection.

## Import Custom Fields

The following information can be imported from NetSuite to Starshipit when the values are stored in custom fields with designated script ids:

* **Delivery Instructions** - custbody_delivery_instructions (Text Custom Field)
* **Authority To Leave** - custbody_authority_to_leave (Boolean Custom Field)
* **Signature Required** - custbody_signature_required (Boolean Custom Field)

## Troubleshooting

The NetSuite API limits each NetSuite user to a single API connection based on the user's login credentials. This can cause Starshipit that use a NetSuite connection to fail with the following errors if other calls are made to the NetSuite API using the same credentials:

* Only one request may be made against a session at a time
* The operation has timed out

If the error occurred while updating your NetSuite orders, then Starshipit will try to update these orders again in a scheduled fashion to ensure the orders are being updated in NetSuite.

Alternatively, you can purchase concurrent connection licenses from NetSuite which will permit simultaneous requests from the same user account.

For temporary testing purposes, you can point Starshipit to your NetSuite sandbox environment by appending the sandbox Id to your Web Service Account Id, e.g. '1234567_SB1' (this has '_SB1' appended).