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.

Authentication

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. Scroll to Manage Authentication section.
  4. Check TOKEN-BASED AUTHENTICATION box.
  5. 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)
      • 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. Add/Edit users.
  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 Authentication subtab.
  4. Check the TOKEN-BASED AUTHENTICATION box on the Authentication subtab.
  5. Click Save.
  6. The confirmation page will display the Consumer Key and Consumer Secret for this integration, so 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. On the Access Tokens page, click New Access Token.
  3. Select Starshipit TBA as the Application Name
  4. Select the User that you assign Starshipit Integration Role with previously.
  5. Select Starshipit Integration Role as the Role
  6. Click Save.
  7. The confirmation page will display the Token ID and Token Secret, so 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 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.
  4. Click NetSuite.
  5. Tick Enable NetSuite.
  6. Enter the Web Service Account ID.
  7. Select Token-Based as the Authentication Method.
  8. Enter Consumer Key.
  9. Enter Consumer Secret.
  10. Enter Token ID.
  11. Enter Token Secret.
  12. Click Save.
  13. 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).

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.