Configure NetSuite to connect

Configure the integration and generate credentials

First, you'll need to generate credentials, ie. a Consumer Key and a Consumer Secret. You'll use these later to make the NetSuite connection in Violet.

1. In your NetSuite instance, navigate to Setup → Integrations → Manage Integrations → New.

2. Click New. Provide a name, eg. "Violet". The State should be "Enabled"

3. Check the box for “Token-Based Authentication”. You can uncheck the other options:

   
4. Click Save. Under Client Credentials, a Consumer Key and Consumer Secret will appear. Copy these and keep them somewhere secure.

Create a role with the necessary permissions

Next, you'll need to create a role and assign permissions.

1. If you don’t already have a role that you will want to grant Violet access to, navigate to Setup → Users/Roles → Manage Roles → New Role.

2. Provide a name for the new role, eg. "Violet REST API User".

3. Under Authentication, check the box for Web Services Only Role.

   
4. Next, assign the necessary Permissions. In each section below, search for the specified permissions and click Add.

   • Transactions: Find Transaction, Purchase Order

     • Note, these are required in order to import purchase order data

     
   • Reports: SuiteAnalytics Workbook (with Level = Edit)

     • Note, these are required so that Violet can run SuiteQL queries to fetch data

     
   • Lists: Employee Record, Employees, Items (with Level = Full), Vendors

     • Note, these are required so that Violet can import user data, parts (Items), and vendor data. It also allows Violet to Push part data to create and update Items in NetSuite.

     
   • Setup: Log in using Access Tokens, REST Web Services, SOAP Web Services (with Level = Full for all items)

     • Note, these are required to allow Violet to access the REST and SOAP apis which are used to fetch and push data to NetSuite

     
5. Click Save.

Grant your user access to the new role

1. Navigate to Setup → Users/Roles → Manage Users. Find your user, or the user that will be connecting NetSuite in Violet, and click Edit.

2. In the Roles section near the bottom, add the new role you created and click Save.

Create an authentication token

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

2. In the dropdown fields, select the integration you created, your user, and the new role you created. Click Save.

   
3. The Token Id and Token Secret will appear at the bottom of the screen. Copy these down and save them somewhere secure.

Now, you're ready to connect NetSuite in Violet.