How to Connect Your NetSuite Account to Hopstack

This guide provides step-by-step instructions on how to integrate your NetSuite account with Hopstack.

1. Hopstack Portal Configuration

1. Login to the Hopstack Portal using the provided link and credentials.

2. On the left sidebar, navigate to Setup > Integration Management.

3. Choose your Warehouse and Client.

4. Locate and click on the NetSuite tile, then click on Connect.
   

   

   
   

5. Enter the following integration details:

   • Account ID

   • Consumer Key

   • Consumer Secret

   • NetSuite Token Key

   • NetSuite Token Secret

   • SuiteTalk URL

   • RESTlet URL

2. Obtain NetSuite Credentials

i. Get your Account ID

1. Login to NetSuite.
   

   

2. Go to Setup > Company > Company Information.
   

   

   
   

3. Locate the ACCOUNT ID label on the right side. Record the number, excluding any suffix (e.g., _SB1).

4. On the same page, find the SuiteTalk (Web Services) URL section. This will contain your SuiteTalk URL.

ii. Create a Consumer Key/Secret Pair

1. Navigate to Setup > Integrations > Manage Integrations.
   

   

   
   

2. Define a name for your integration.

3. Check the Token-Based Authentication and TBA: ISSUETOKEN ENDPOINT options.

4. Uncheck the TBA: AUTHORIZATION FLOW and AUTHORIZATION CODE GRANT options.

5. After saving, find your Consumer Key/Secret Pair at the bottom. Note: This pair is only shown once. Store it securely.

iii. Create a Role

1. Navigate to Setup > Users/Roles > Manage Roles.

2. Create a new role with full permissions for:

   • Setup

   • User Access Token

   • SOAP Web Services

   • Log in using Access Tokens

   • Integration Application

   • REST Web Services

   • Access Token Management

3. Configure additional permissions for Lists, Reports, and Transactions based on your integration needs.

iv. Assign the Role to a User

1. Choose a user:

   • For a new user: Go to Lists > Employees > New.

   • For an existing user: Go to Lists > Employees > Search and select the user.

2. Under the Access > Roles tab, add the integration role you created.

3. Save your changes.

v. Generate Access Token Key/Secret Pair

1. Navigate to Setup > Users/Roles > Access Tokens > New.

2. On the Access Token page, select the Integration Record, User, and Role you set up.

3. After saving, locate your Token ID/Secret Pair at the bottom of the page.

3. Paste the Netsuite Credentials in the Hopstack Platform

1. Navigate to the Hopstack platform with the provided URL and log in with your credentials

2. Navigate to the Integration Management screen under the Setup Section

3. Choose the relevant warehouse and tenant from the applicable dropdown menus on the screen.

4. Scroll down to find the Netsuite logo

5. Click on the Connect button

6. Type in the relevant keys retrieved from the previous step. The format should be as follows:

   1. Account ID:

      • This is a unique identifier for your account.

      • Format: Contains numbers followed by an underscore and then more characters (e.g., 123456_ABC).

      • Example: 767814_SB2

   2. Token Key:

      • A unique key is generated for API token-based authentication.

      • Format: Long alphanumeric string, usually 64 characters in length.

      • Example: 7e9f6765a3f9db2a538b61ba157229bff76e2c25b8b821df9b4c4e41a6a33f1f

   3. Token Secret:

      • A secret associated with the Token Key.

      • Format: Long alphanumeric string, typically matches the length of the Token Key.

      • Example: 8c82bf7b8ac4ab9c1f6cc24aac8a57e45e9e95c3f54b0c2b5a8eb3b937245cdd

   4. Consumer Key:

      • Key for the consumer (your application) to authenticate itself.

      • Format: Long alphanumeric string.

      • Example: 8920b5ff943fe2176ca578f2a4bee4183d2e9313b98430c67c4e4d0c105d98da

   5. Consumer Secret:

      • A secret key associated with the Consumer Key.

      • Format: Long alphanumeric string, typically matches the length of the Consumer Key.

      • Example: ba9a8998ff2d3d21afb2741ac8d0ca9631ca38838245c82e655e9912763f6e80

   6. SuiteTalk URL:

      • URL endpoint for the SuiteTalk API service.

      • Format: Starts with 'https://' and contains 'suitetalk.api.netsuite.com'.

      • Example: <https://767814-sb1.suitetalk.api.netsuite.com>

   7. RESTlet URL:

      • URL endpoint for the RESTlet API service.

      • Format: Starts with 'https://' and contains 'restlets.api.netsuite.com'.

      • Example: <https://767814-sb1.restlets.api.netsuite.com/app/site/hosting/restlet.nl?script=577&deploy=1

After completing these steps, your NetSuite account should be successfully connected to Hopstack. If you experience any issues, please contact Hopstack Support.