About Token-Based Authorization

Token-based authorization is used to integrate NetSuite™ with Descartes™ ShipRush Web. The process takes 15 to 30 minutes to complete. Please pay close attention to every step on this page.

You must log in as a NetSuite administrator in order to perform the steps on this page. NetSuite is complex to set up. This task may take 15-focused minutes for experienced NetSuite administrators or 30 minutes for occasional administrators. We suggest avoiding interruptions and working through all steps in one session. Missing a step results in a setup that causes errors and does not work properly.

Part 1 - Steps Required Before Setting Token-Based Authentication

In the next two sections, you will:

• Enable the web services feature in NetSuite

• Locate your NetSuite account ID and Role ID

Enabling Web Services Feature in NetSuite

These steps are required before you can create credentials.

1. As an administrator, go to Setup > Company > Enable Features.

2. Click the SuiteCloud subtab.

3. Select SOAP WEB SERVICES (AKA SuiteTalk).

4. Under Manager Authentication, select TOKEN-BASED AUTHENTICATION.

5. Click Save.

Locating Your Account ID

The NetSuite information obtained through these steps is necessary for credentials authentication:

1. Go to Setup > Integration > SOAP Web Services Preferences.

2. Your Account ID is displayed in the upper left corner.

Note: Record your Account ID because you will enter it into the Descartes ShipRush Web wizard.

Part 2 - Setting Up Token-Based Authentication

After performing these steps, you will have saved the four pieces of information listed below. Record this information because you will enter it in the Descartes ShipRush Web wizard.

• From the Integration page:

  • Consumer Key

  • Consumer Secret

• From the Tokens page:

  • Token Key

  • Token Secret

Obtaining Your Consumer Key and Consumer Secret

To obtain your Consumer Key and Consumer Secret:

1. Go to Setup > Integration > Manage Integrations > New.

2. Enter an application name (for example, "ShipRush").

3. Confirm that Enabled is selected.

4. Select Token-Based Authentication.

5. Uncheck TBA: Authorization Flow.

6. Under OAuth 2.0, uncheck Authorization Code Grant.

7. Click Save.

8. On the next page, you will see your Consumer Key and Consumer Secret. Record your Consumer Key and Consumer Secret because you will enter them into the Descartes ShipRush Web wizard.

Warning: Above is the only time that you will see your Consumer Key and Consumer Secret. Be sure to record them before leaving this screen.

Creating Access Token Key and Secret:

To create an Access Token Key and Secret:

Enable your admin account to have a token Role. Do the following:

• Perform a search (top bar) for the page “New Role”.

• Assign the Role name "ShipRush Token". Scroll to the Permissions area.

• On the Transactions tab, set access to Full for "Invoice," "Sales Order," ":Fulfill Orders," and "Item Fulfillment."

• On the Lists tab, set access to View for "Items", "Customers", and "Documents and Files", if available.

• On the Setup tab, set access to Full for "User Access Token," "Access Token Management," and "SOAP Web Services."

• Click Save!

1. With that Role created, perform a search (top bar) for your admin login name.

2. Open the Employee: (Your Name) area, and then click Edit.

3. Scroll to Access > Roles. Find the “ShipRush Token” role, add it and then click Save.

4. Go to Setup > Users/Roles > Access Tokens > New.

5. Select your Application Name (ShipRush), select User (Your Admin Name) and then select Role (ShipRush Token).

6. Click Save.

You should now see your Access Token ID (AKA Token Key) and Token Secret. Record the Token ID/Key and Token Secret because you will enter them into the Descartes ShipRush Web wizard.

Entering NetSuite Integration Information into Descartes ShipRush Web Wizard

In Descartes ShipRush Web, do the following:

1. Click SETTINGS.

2. Click Add Web Store (top of screen).

3. In the Web Store Configuration dialog, on the Select a Web Store dropdown, click NetSuite. Click Next.

4. On the NetSuite Setup Instructions page, read the instructions. Click I HAVE MY ACCOUNT AND CREDENTIALS.

5. In the NetSuite Web Store Information dialog, enter your:

   1. Account ID

   2. Consumer Key

   3. Consumer Secret

   4. Token Key

   5. Token Secret

6. Click Continue.

7. Follow the wizard until complete.

Obtaining Your Application ID (if Required)

To obtain your application ID:

1. Go to Setup > Integration > Manage Integrations > New.

2. Name the integration something like "Connection" and keep the state Enabled.

3. Click Save.

4. Your Application ID is displayed on the next page. Record your Application ID.

NetSuite.com Admin Email and Password

Use your normal account login credentials for the NetSuite.com admin console.

Back to Top