NetSuite Integration

Overview

• The steps below will guide you through integrating your NetSuite platform account with Starshipit.
• Once completed, your orders will be imported into Starshipit, and when you print a label, the tracking information will be written back.
• 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.
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.
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 to your Web Service Account Id, e.g. '1234567_SB1' (this has '_SB1' appended).