Pre-installation tasks

Required configuration needed to establish the NetSuite connection

Enable SuiteTalk (Web Services) and SuiteScript

To enable SuiteTalk (Web Services) and SuiteScript in NetSuite, go to Setup > Company > Enable Features. Select SuiteCloud in the sub-menu. The features are displayed. Select the SuiteScript and SuiteTalk (Web Services) checkbox and click Save.

NetSuite information needed to establish NetSuite connection with the integration app

The integration app requires the following information from NetSuite to be entered when configuring NetSuite connection:

• Account ID
• Role ID
• Email
• Password

The Role ID is the NetSuite Internal ID of the Role associated with the Account ID (User). To obtain this value you must first know the Account ID associated with the user you are using for this connection. One way to obtain this value within NetSuite is via Setup > Integration > Web Services Preferences > Account ID.

Once you know the Account ID, you can navigate to Setup > Users/Roles > Manage Roles > Internal ID and if you have NetSuite Internal Ids displayed automatically it will just show in the list view, or you can open the Role in view mode and look at the URL in the browser and the ID will be listed there too.

Note: To enable the visibility of internal IDs in NetSuite, go to Home > Set Preferences > General Tab > Set Defaults and select the Show Internal IDs checkbox.

Ways to establish NetSuite Connection with integrator.io

You can establish your NetSuite account connection with integrator.io in the following ways:

• Setup the NetSuite connection with administrator access.
  You can choose to assign the Account ID (user) you provide when installing a Celigo’s integration app with the administrator role in the Role ID field. Default internal id for an administrator role in NetSuite is “3”.
  
  
• Setup the NetSuite connection without administrator access.
  If you do not want to associate the administrator role with the Account ID you provide when installing an integration app, you will need to ensure that the Role ID associated with the Account ID has the necessary permissions for the integration app to access the required details from your NetSuite account. The following section provides more details on permission needed to establish NetSuite connection with a non-administrator role.

Recommendation: When you use the same login for multiple integration apps, the concurrency of that login is shared by all the connections. As NetSuite allows you to make only 10 concurrent RESTlet requests at a time per login, we recommend you to use separate NetSuite user login (email and password) for each integration app for better throughputs.

Set up permissions for non-administrators roles in NetSuite

Each non-administrator will be able to only access the NetSuite record types that their role permits. Not having adequate role permissions could lead to unwanted errors when executing the data flows. In order for the user to set up, run, and maintain integrations and integration apps with a non-administrator role, you need to provide controlled access using the Permissions option in NetSuite.

To set up controlled access permissions in NetSuite, select Setup > Users/Roles > Manage Roles. The Manage Roles page is displayed. Find the role for which you need to customize the permissions and click Customize. The Role page is displayed.

In the Permissions tab, ensure that the following permissions are enabled for the user:

Please note, NetSuite 2018.1 release requires two-factor authentication (2FA) for the initial login of all users with the Administrator role and Full Access roles in newly provisioned accounts.

For users of the following integration apps:

ADP - NetSuite, Amazon - NetSuite (SuiteScript or IO), BigCommerce – NetSuite, Cash Application Manager (IO), eBay - NetSuite (SuiteScript or IO), JIRA - NetSuite, Magento 2 - NetSuite, Shopify - NetSuite, Vendor Payment Manager, Walmart - NetSuite , Zendesk - NetSuite, Salesforce Commerce Cloud - NetSuite, Salesforce - NetSuite v1, Salesforce - NetSuite v2. 

• If you are installing the integration app in an 18.1 provisioned NetSuite account, you need to install the integration app with the NetSuite connection setup with Basic authentication. The role should be a non-admin role that should not have 2FA enabled. Once the integration app is installed, switch the NetSuite connection from Basic to Token.
• If you are an existing user of any of the aforementioned integration apps, there is no immediate action since this feature is only applicable to accounts provisioned in 18.1 but it's highly recommended you switch the Authentication Type from Basic to Token so any future NetSuite releases will not have any impact on your integration.

If you are already using Authentication Type as Token, your integration app will remain unaffected even if you use the 2FA feature in NetSuite. Hence, you are not required to take any action.

For additional information please see this article.