To authenticate NetSuite, you will need to provide the following information:

• Consumer Key

• Consumer Secret

• Token ID

• Token Secret

This guide will walk you through finding or creating those credentials within NetSuite.

 

Prerequisites

Please ensure you have Administrator permissions in your company's NetSuite instance, or someone has shared their access with you.

 

Instructions

Step 1: Finding your NetSuite Account ID

1. Enter your NetSuite Account ID in the Linking flow

2. This is the combination of letters or numbers before "app.netsuite.com" of the URL

3. If your URL is "https://7600508.app.netsuite.com...", your NetSuite Account ID is 7600508

​

Step 2: Enable SuiteCloud features

1. Open the NetSuite Enable Features Page

2. Under SuiteCloud, check the following boxes then click save

   1. SOAP WEB SERVICES

   2. REST WEB SERVICES

   3. TOKEN-BASED AUTHENTICATION

 

 

Step 3: Install the AccountLink NetSuite bundle

1. Install one of the Permissions Bundles below that fits your use case
   a) Merge Full Permissions Bundle will allow for read-and-write access
   
   

2. It may take up to 5 minutes to install and you may be re-routed to the Installed Bundles page when the installation is complete

1.  

The bundle creates a role that can authenticate to NetSuite's API. For a full list of the role's permissions, see this article. The permissions may be updated, or a separate Role may be used, but doing so could result in permission issues.

 

Step 4: Edit role

1. Go to edit role (Setup > User/Role / Manage Roles)
2. Select the role you imported through the bundle (Merge Full Permissions)
3. Click edit
4. Set subsidiary restrictions (A) to selected
5. Make sure Allow cross-subsidiary record viewing is unchecked (A)
6. Choose the one subsidiary that you wish to use with Weel (B)
   1. Selecting multiple will result in an error on Weel's end.
7. Click save (C)

 

 

 

Step 5: Assign a user to the role

1. Open Manage Users

2. Either select a user to assign the Role to or create a new user

   • Most users use an existing user (often yourself) so that an additional NetSuite seat is not consumed

   • To create a new user, however, go to Lists > Employees > Employees > New. Create the user and grant them NetSuite access by going to the Access tab in the Employee record and select 'Give Access'

3. In the user's employee record, click Edit and go to the Access tab. In your Access tab, go to Roles and select the Role you imported through the Import Bundle process in Step 3
   ​

   

    

4. Click Save to apply these changes

 

Step 6: Create an integration to obtain your Consumer Key and Secret

1. Navigate to Integration and create an integration with the following details

   • NAME: any value

   • CONCURRENCY LIMIT: leave blank

   • CALLBACK URL: https://app.merge.dev/oauth/callback

   • REDIRECT URI: https://app.merge.dev/oauth/callback

   • Check the following boxes

     • REST WEB SERVICES

     • TOKEN-BASED AUTHENTICATION

     • TBA AUTHORIZATION FLOW
       ​

     

      

2. Once you click save, Copy the Consumer Key and Consumer Secret and store them in a safe place. They will only be shown once and you will need to enter it in Step 10.
   ​

   

 

Step 7: Create an access token to obtain your Token ID and Secret

1. Navigate to Access Token

2. Click New Access Token

3. Ensure the below details are selected and click Save

   • Application Name: Name of the Integration created in Step 6

   • User: User that the Role was added to during Step 5

   • Role: The imported role (Merge Full Permissions or Merge Read-only Permissions)
     ​

     

      

4. Copy the Token ID and Token Secret and store them in a safe place. They will only be shown once and you will need to enter it in Step 10.

 

 

Step 8: Set up default tax for subsidiary

1. Go to Setup > Accounting > Set Up Taxes

2. Make sure that you have default tax codes selected for all countries

 

 

Step 9: Create Chart of Accounts for Weel

1. Go to Lists > Accounting > Accounts > New

2. Click New

3. Fill:

   1. Number - choose number

   2. Name - it must be Weel Expenses Account

   3. Type - Bank

   4. Currency - Australian Dollar

   5. Bank Account Number (you can find it in Weel Settings > Account balance > Account number)

   6. Subsidiaries - choose the subsidiary you want to integrate to Weel, same as Step 4.B

4. Click Save

 

Step 10: Enter credentials in the linking flow

1. Consumer Key: Confirmation screen after creating the integration (Step 7)

2. Consumer Secret: Confirmation screen after creating the integration (Step 7)

3. Token ID: Confirmation screen after creating your Access Token (Step 7)

4. Token Secret: Confirmation screen after creating your Access Token (Step 7)