Nue Knowledge Center

Nue Docs navigation

search
clear
/

NetSuite Integration Setup

NetSuite Integration Setup

This document details the steps required to set up NetSuite and Nue to prepare for the following NetSuite integration:

Setup NetSuite

Permissions

To configure NetSuite and install the connector, you need Administrator or a similar role with adequate permissions.

Enable Required Features

Ensure that Token-Based Authentication and SuiteAnalytics are enabled:

  1. Navigate to Setup > Company > Enable Features.
  2. On the SuiteCloud tab, check Token-Based Authentication.
  3. On the Analytics tab, check SuiteAnalytics Workbook.

Create Custom Fields on the Transaction Line Object

In the Object Transaction Line, we are using the following fields to integrate with NetSuite ARM: 

 

  • custcol_nue_transactionlineid
  • custcol_nue_term
  • custcol_nue_start_date
  • custcol_nue_end_date

Create Custom Fields.jpg

Revenue Fields Mapping for Revenue Recognition

To automate revenue plans in NetSuite ARM, follow the steps below to setup the field mapping: 

 

  • Login to NetSuite
  • Navigate to Setup →  Accounting →  Revenue Field Mapping →  New

Rev. Rec. Map the fields Menu.jpg

 

  • Configure the following:
    • Source Record Type: Transaction Line
    • Source Field IDs: custcol_nue_start_date → Start Date; custcol_nue_end_date → End Date

Rev. Rec. Map the fields.jpg

 

If these fields are already mapped, verify that the configuration correctly populates the values from Nue.

Setup Nue

Permissions

The following permissions must be enabled in the user role: 

  • Integrations
    • Manage NetSuite Integration
  • Collections
    • View Payment Application
    • Manage Payment Application

Setup NetSuite Connection

Next, follow these steps to set up the NetSuite Connector in Nue:

  • Go to System Settings.
  • Search for NetSuite Integration.
  • Click Configure to launch the Config-Wizard.
  • On the Config-Wizard page:
    • Create “API Key-based” authentication for Nue.  Please follow the steps documented here to retrieve your Nue API Key.  We recommend creating a dedicated API Key for the NetSuite Connector.  
    • Set up “Token-Based” authentications for NetSuite. This requires configuring both REST and SOAP connectors separately.  Please follow the steps in the section below to retrieve NetSuite Credentials.  
  • Complete the remaining settings and click Finish to finalize the configuration.

Retrieve NetSuite Credentials

Nue integrates with NetSuite using Token-Based Authentication. You will need the following credentials to complete the setup:

 

  • Account ID
  • Consumer key and Consumer Secret
  • Token ID and Token Secret

Account ID

  • Login to NetSuite
  • Navigate to Setup →  Company → Company Information

Company Information Menu.jpg

  • Copy your Account ID at the bottom of the right-hand column.

Company Information.jpg
Consumer Key and Consumer Secret

  • Login to NetSuite
  • Navigate to Setup →  Integration → Manage Integrations → New

Integration Menu.jpg

  • Fill in the required details.
  • Enable Token-Based Authentication and save the record.

Integration Tokens.jpg

  • Copy the Consumer Key and Consumer Secret from the confirmation page.

CAUTION

 

Note that this information will only be displayed once, so please ensure it is saved elsewhere in a secure place for future setup/requirements.

Token ID and Token secret

  • Login to NetSuite
  • Navigate to Setup →  Users/Roles → Access Tokens → New

Access Token Menu.jpg

  • On the Access Tokens page, click New Access Token and select the Application Name associated with the integration record you created earlier

Access Tokens.jpg

 

  • The Token Name is pre-filled by default as a combination of the Application Name, User, and Role. After completing the setup, the Token ID and Token Secret will be displayed.

CAUTION

 

Note that this information will only be displayed once, so please ensure it is saved elsewhere in a secure place for future setup/requirements.