Guide to NetSuite Token-Based Authentication

Plans: All plans Platforms: NetSuite

Overview

AfterShip supports NetSuite TBA (Token Based Authentication) as an authentication type to prevent unauthorized access.

You can easily use TBA, once you make some required changes with respect to your NetSuite settings. Carefully follow the 5 steps given below to be able to establish a connection with AfterShip:

Step 1: Get the account ID

Access your Oracle NetSuite account > Go to the Setup tab > Company > Company Information
Your account number will be listed under the Account ID field
Copy it for later use

Step 2: Enable Token Based Authentication (TBA)

Again, go to the Setup tab of your Oracle NetSuite account > Company > Enable Features > SuiteCloud > Manage Authentication
In the SuiteScript section, check Client SuiteScript and Server SuiteScript
In the SuiteTalk (Web Services), check REST Web Services
In the Manage Authentication section, check Token-Based Authentication
Scroll to the bottom of the page and click Save

Step 3: Create an Integration Record

Once the TBA is enabled, go back to the Setup tab > click on Integrations > Manage Integrations > New
Set the name to AfterShip Integration and perform these actions

Check the "Token-Based Authentication" option
Uncheck the "TBA: AUTHORIZATION FLOW" and "AUTHORIZATION CODE GRANT" options
Check the "TBA: ISSUETOKEN ENDPOINT" option



In case you already have an integration record for AfterShip, you can reuse it by simply modifying settings as mentioned above.

Copy the values mentioned for “Consumer Key/Client Key” and “Consumer Secret/Client Secret”

||You can reuse the values for multiple access tokens.

Make sure that you copy the values properly, as they will be shown only once.

Step 4: Create a role and assign users

Go to Setup > Users/Roles > Manage Roles > New
Under the Subsidiary Restrictions, choose All (This is optional if you don't have a subsidiary set up in your NetSuite.)



Create a role and allow necessary permissions for successful AfterShip integration. Here’s what you need to take care of:

Lists - Customers
Lists - Contacts
Lists - Currency
Lists - Items
Lists - Perform Search
Lists - Persist Search
Reports - SuiteAnalytics Workbook
Transactions - Find Transactions
Transactions - Sales Order
Transactions - Item Fulfillment
Transactions - Fulfill Sales Orders
Transactions - Return Authorization (for RMA creation feature)
Transactions - Sales Order
Setup - SOAP Web Services
Setup - Rest Web Services
Setup - User Access Token (for Token-Based Authentication)

Make sure each created role has the "User Access Tokens" permission, as it’s important for using the TBA.

Now, assign the created role to concerned individuals. Go to Lists > Employees > Employees > Edit user > Access > Roles

Step 5: Create an Access Token for the Integration record, User, and Role

Go to Setup > Users/Roles > Access Tokens > New
Select the Integration record, User, and Role that you’ve created by following the aforementioned steps
Token Id and Token Secret will be displayed after tapping the Save button. Copy the values for AfterShip integration

Establish a connection with AfterShip

Go to Apps in AfterShip Tracking admin
Click View more apps, and you will be redirected to the AfterShip Tracking integration page.
Find NetSuite and select it to land on the detailed integration page
Click Install app



Select the right organization (online store) if you have multiple organizations configured in AfterShip Tracking for which you are establishing this integration and click Connect
On the OAuth confirmation page, fill in the required details



The same Consumer Key, Consumer Secret, Token ID, and Token Secret can be used multiple times while creating more connections.

For any help, contact our chat support team

Updated on: 17/07/2024