# NetSuite

NetSuite (opens new window) is a cloud business management suite that offers comprehensive software for an organization, with software products encompassing ERP/Financials, CRM, and ecommerce.

# API version

The NetSuite connector uses the WSDL from the SuiteTalk 2020_2 API. This gives you the latest access to objects introduced in past API versions. A variety of new fields for objects have also been introduced.

# SuiteTalk 2020_2 changes

Payment Instrument added to Search object action
New schema updates to over 70 objects across create, update, search, and retrieve actions.

# How to connect to NetSuite on Workato

You can connect to NetSuite via token based authentication. In order to do so, we need to generate an application ID, consumer key and consumer secret as well as a token ID and token secret.

In this section, we'll go through how to get these.

Enable Web Services and Token-based Authentication in your NetSuite instance
Create an integration record
Create an integration role with required permission levels for your integration
Assign the integration role to the integration user
Create access token for this integration user

# 1. Enable Web Services access in your NetSuite instance

First, API Access and Token-based Authentication needs to be enabled in NetSuite. Go to Setup > Company > Enable Features > SuiteCloud.

Setup > Company > Enabled Features > SuiteCloud In NetSuite, go to Setup > Company > Enable Features > SuiteCloud

Under the SuiteCloud tab, check the Client SuiteScript and Server SuitScript checkboxes.

In the SuiteCloud tab, check the Client SuiteScript and Server SuitScript checkboxes

Under the SuiteTalk (Web Services) section, check the SOAP Web Services and REST Web Services checkboxes. Under the Manage Authentication section, check the Token-based Authentication and OAuth 2.0 checkboxes.

Check the SuiteTalk Web Services and Token-based Authentication checkbox In the SuiteCloud tab, check the SOAP Web Services, REST Web Services, Token-based Authentication and OAuth 2.0 checkboxes

You can also refer to the NetSuite documentation (opens new window) on enabling the Token-based Authentication feature.

# 2. Create an integration record

We need to create an integration record (opens new window) to represent an external application connecting to NetSuite.

Go to Setup > Integration > Manage Integrations > New.

In NetSuite, go to Setup > Integration > Manage Integrations > New

Now, add a name for this integration. Make sure to select Enabled in the State pick list and check the Token-based Authentication checkbox, then save this integration.

Check the Token-based Authentication checkbox

Now that we have created an integration record, save the consumer key and consumer secret. This will be used for connecting to NetSuite on Workato.

You can also refer to the NetSuite documentation (opens new window) on creating integration records.

# 3. Create an integration role with required permission levels for your integration

We recommend that you create a separate integration role just for your integrations. This integration role needs to have permissions to read and write to the records relevant for your integrations. This integration role also needs the ability to login through RESTlets or SuiteTalk (web services).

The minimum set of permissions needed for this user are: A) Permissions to read/write to records required for integration B) Web Services (Full level) C) Log in using Access Tokens (Full level) or User Access Tokens (Full level) for more privileges to create and revoke own tokens D) Set Up Company (Full level)

A) Assign integration specific read/write permissions

We recommend that you make a copy of an existing role that already has the permissions required for the integrations to work and proceed to customize it further for your integration needs. This role can then be assigned to the integration user. Alternatively, you can create a new role and add the permissions required for the integrations to work.

In NetSuite, create an integration role via Setup > Users/Roles > Manage Roles > New.

Setup > Users/Roles > Manage Roles > New

Under the Permissions tab, set up the permissions and permission levels you wish this role to have. This should correspond with what you wish to do with your Workato integration, for example, if you wish to create sales orders in NetSuite, you should have the Sales Order - Create permission level, and if you wish to be able to create and update and read sales order data, select the Full permission level.

Set up integration specific permissions

Refer to the NetSuite documentation (opens new window) for more details about customizing or creating roles and setting permissions.

B. Assign Web Services permissions to integration role

Check the Web Services Only Role checkbox if you don't want this role to have the ability to login to NetSuite (i.e. if you want this user to only have the ability to connect to NetSuite via the API).

Check Web Services Only Role checkbox if relevant

Under Permissions > Setup, add the SOAP Web Services and REST Web Services permissions with a Full level.

Assign Full level Web Services permissions Assign Full level SOAP and REST Web Services permissions

C. Assign token-based authentication permissions to integration role

There are 3 types of token-based authentication permissions (opens new window):

Access Token Management
User Access Tokens
Log in using Access Tokens

We need the Log in using Access Tokens permission at a minimum to enable the user to authenticate via token-based authentication. If you would like the integration user to be able to create and revoke access tokens for their own use, you can give the role the User Access Tokens permissions. We recommend that the integration user not have the Access Token Management permissions for better security maintenance.

Under Permissions > Setup, add the Log in using Access Tokens permission with a Full level.

Assign Login using access token permissions

D. Assign Set Up Company (Full level) permissions to integration role

Lastly, add the Set Up Company (Full level) permissions to the integration role.

Assign Set Up Company permissions

# 4. Set up an integration user

Once we've set up our integration role, we need to assign this role to our integration user. We recommend creating a separate user for your integrations.

In NetSuite, go to Setup > Users/Roles > Manage Users to edit an existing user or create a new user.

Set up other permissions and permission levels Navigate to Setup > Users/Roles > Manage Users

When editing a user, under the Access tab, ensure you assign this user the integration role you've just created/edited above.

Assign integration role to user

# 5. Create access token

Finally, create an access token for the integration user. If the integration user has User Access Tokens permissions, they will be able to create and revoke their own tokens. If the integration user has only Log in using Access Tokens permissions, you will need to use a user with Access Token Management permissions to create an access token for the integration user.

Go to Setup > Users/Roles > Access Tokens > New.

Setup > Users/Roles > Access Tokens > New In NetSuite, go to Setup>Users/Roles>Access Tokens>New

Select the integration record, integration user and role we created earlier, then click save. Record the token ID and token secret somewhere and keep it confidential - these will not be retrievable again from NetSuite. These will be used for connecting to NetSuite on Workato.

# 6. Connect to NetSuite on Workato

NetSuite asks for the following information to connect.

Information to connect to NetSuite

Field	Description
Account ID	Retrieve the account ID of your NetSuite instance from Integration>Web Services Preferences
Consumer key	Consumer key from the integration record that you've just created
Consumer secret	Consumer secret from the integration record that you've just created
Token ID	Token ID from the access token that you've just created
Token secret	Token secret from the access token that you've just created
Account timezone	Select the timezone of your NetSuite instance to ensure that the dates in your NetSuite account are handled accurately. All datetime values used in actions/triggers for the NetSuite connection will be based on this timezone.
Ignore read-only fields	If set to Yes, read-only fields will be omitted from create and update actions. If set to No, read-only field will appear in create and update actions. Trying to create or update these read-only field will cause an error.

# Common NetSuite fields and possible disparity between object/field names in NetSuite and Workato

The NetSuite connector is able to retrieve your standard or custom NetSuite objects and the associated set of standard and custom fields. Whenever you configure your trigger or action, you would first need to select the specific object you wish to interact with.

Take note that objects in your NetSuite instance might have been renamed, in which case they would appear in Workato with the original name (instead of the new name). Do check with your NetSuite admin or reach out to us if it looks like you're not able to find your object on Workato!

If you're configuring an action, you would see the fields selector pop up with a list of the standard and custom fields that belongs to the selected object. Simply select the fields you wish to interact with.

NetSuite fields selector

Some fields are displayed with their internal API names instead of their labels in NetSuite. The following list brings you through the more common NetSuite fields, some of which might have a different name in Workato.

Internal ID

Every NetSuite record has a unique internal ID, which can be found in the URL when viewing the specific NetSuite record. Internal IDs are usually used to specify the exact record to update for update object actions. They can be obtained from the datatree of create object actions or search object actions.

NetSuite Internal ID Internal ID of a specific sales order as seen in the URL

External ID

Every NetSuite record has an external ID field to store the IDs of corresponding objects in other systems - for example, you can store the corresponding Salesforce ID of a NetSuite customer in that customer's external ID field. When you

This field is a standard field in NetSuite, but typically not visible by default in NetSuite.

When linking an object to another object via Workato (for example, when creating a transaction and trying to link this transaction to a class, department, or subsidiary), NetSuite usually asks for the IDs of the object you wish to link to. To find these IDs, you would typically need to search for these objects (for example, in this case, to search for your class, department, or subsidiary). Alternatively, you might want to store these values in a lookup table for easy reference without having to execute a search in your NetSuite instance.

Custom fields

The recipe is able to retrieve the custom fields of your selected NetSuite object for you to read from or write to. All custom fields are grouped together under the parent Custom fields.

When working with custom fields that reference other objects in NetSuite, you can now reference these objects using their internal or external IDs. To reference another object using its external ID, you will have to add a prefix to value given.

19/5/2020 Enhancement

As of 19/5/2020, we have made a significant enhancement to the migration of NetSuite recipes from Sandbox to Production environments. This requires certain steps to be taken for any NetSuite recipes created on or before 19/5/2020. Learn more about from our migration guide here

NetSuite custom fields Custom fields Tax Receipt No. and External ID

Item list

For transaction objects that contains line items, the available fields within each line item can be found grouped within the item list field.

NetSuite item list Item list displayed in the create sales order action

# New classification object trigger

Certain objects in NetSuite are classification objects, such as departments, locations, and classifications. Select the classification object to monitor.

When the recipe is first started, all the existing instances of the selected object will be picked up by the recipe. Subsequently, only newly created instances will be processed by the recipe.

New classification object trigger

For example, if I select departments as the object to trigger upon, all existing department objects will be picked up by the trigger when the recipe is first ran. Subsequently, if the recipe is kept running, only departments which have been newly created will be picked up by the recipe.

# Trigger behaviour when recipe is stopped and restarted

Even if the recipe is stopped, when it's restarted again, all departments created in the time during which the recipe was stopped will be picked up by the recipe.

# New standard object and new custom object trigger

The new standard object and new custom object trigger are very similar, so this section will cover both. Certain records are not supported in the trigger due to API limitations.

# Configuring the trigger

To use this trigger, we need to first select the standard object or the custom object to monitor. We also need to input the datetime in the From field to pinpoint the exact date from which the recipe should start processing records.

Unconfigured NetSuite new object trigger NetSuite new object trigger - unconfigured. Select the object to monitor for newly created records.

When the recipe is first started, all the existing instances of the selected object created after the datetime in the From field will be picked up by the recipe. Subsequently, only newly created instances will be processed by the recipe.

For example, I've selected sales order and 1 Jan, 2017 midnight for my trigger as below.

Configured NetSuite new object trigger NetSuite new object trigger - configured

When I first start my recipe all sales orders created from or after 1 Jan, 2017 midnight, will be processed. Subsequently, if the recipe is kept running, only sales orders which have been newly created will be picked up by the recipe.

# Trigger behaviour when recipe is stopped and restarted

Even if the recipe is stopped, when it's restarted again, all sales orders created in the time during which the recipe was stopped will be picked up by the recipe.

# New/updated standard object and new/updated custom object trigger

The new/updated standard object and new/updated custom object trigger are very similar, so this section will cover both.

# Configuring the trigger

To use this trigger, we need to first select the standard object or the custom object to monitor. We also need to input the datetime from the From field to pinpoint the exact date from which the recipe should start processing records.

Unconfigured NetSuite new/updated object trigger NetSuite new/updated object trigger - unconfigured. Select the object to monitor for newly created or updated records.

When the recipe is first started, all the existing instances of the selected object created or updated after the datetime in the From field will be picked up by the recipe. Subsequently, any newly created instances or updated instances will be processed by the recipe.

For example, I've selected sales order and 1 Jan, 2017 midnight for my trigger as below.

Configured NetSuite new/updated object trigger NetSuite new/updated object trigger - configured

When I first start my recipe all sales orders created or updated from or after 1 Jan, 2017 midnight, will be processed. Subsequently, if the recipe is kept running, any sales orders which have been newly created or updated will be picked up by the recipe.

# Trigger behaviour when recipe is stopped and restarted

Even if the recipe is stopped, when it's restarted again, all sales orders created or updated in the time during which the recipe was stopped will be picked up by the recipe. Do note, however, that the recipe will only pick up the last (most updated) version of search record. For example, if a record was newly created and had 3 updates made to it while the recipe was stopped, the recipe will only pick up the last updated version of the record when it's restarted again.

# New saved search result for object trigger

The New saved search result for object trigger retrieves new records that meet the saved search's criteria, for example, for a saved search that fetches customer records of industry type Hardware, new customers created of the industry type Hardware will be picked up as a trigger event.

Existing customers whose industry type is changed to Hardware will also be picked up as a trigger event if their Date created value is valid for the recipe (falls after the datetime in the From field specified in the trigger).

To ensure the trigger works, we need to make sure that the columns Internal ID and Date created are configured as result columns in the saved search. To do this, navigate to the saved search page to edit it.

Edit the saved search

Navigate to the Results page's Columns section, and add the two fields to the list of columns if it's not there.

Add Internal ID and Date created columns in saved search for New trigger

Also, make sure to remove the Dashboard column in the saved search's results if it's present. Having this column will cause the trigger to throw an error.

Remove Dashboard column in saved search

Once this setup has been done, we can proceed to configure the trigger. This configuration is similar to that for New/updated saved search result trigger:

Select the object type we wish to retrieve the saved searches for. In our case, we selected the customer object.
Once the object type has been selected, select the saved search to listen to for new records.
Specify the date time in the From field. Only records created after this From date will be retrieved by the recipe. This means that, when an existing record meets the saved search criteria, it will only be picked up by the recipe if it has a Date created value after the From value.

Configure the new saved search results trigger

# New/updated saved search result for object trigger

The New/updated saved search result for object trigger retrieves new and updated records that meet the saved search's criteria, for example, for a saved search that fetches customer records of industry type Hardware, new, or updated customers of the industry type Hardware will be picked up as a trigger event.

Existing customers whose industry type is changed to Hardware will also be picked up as a trigger event.

To ensure the trigger works, we need to make sure that the columns Internal ID and Last modified are configured as result columns in the saved search. To do this, navigate to the saved search page to edit it.

Add Internal ID and Last modified columns in saved search for New/updated trigger

Also, make sure to remove the Dashboard column in the saved search's results if it's present. Having this column will cause the trigger to throw an error.

Remove Dashboard column in saved search

Once this setup has been done, we can proceed to configure the trigger. This configuration is similar to that for New saved search result trigger:

Select the object type we wish to retrieve the saved searches for. In our case, we selected the customer object.
Once the object type has been selected, select the saved search to listen to for new records.
Specify the datetime in the From field. Only records created or updated after this From date will be retrieved by the recipe.

Configure the new/updated saved search results trigger

# Add standard object and add custom object action

The add standard object and add custom object actions are similar except that the former works with standard NetSuite objects, while the latter works with custom objects created by your organization.

In this section, we'll be covering how to use the add standard object action, which will be applicable for the add custom object action as well.

# Configuring your add object action

To configure your action, first select the object you would like to create. In this case, let's create a sales order. After you have selected the object you wish to create, the recipe will retrieve the fields of your selected NetSuite object.

Unconfigured NetSuite add object action NetSuite add object action - unconfigured. Select the object to create.

# Selecting and mapping your fields

After selecting the object you wish to create, you'd need to select the specific fields you wish to write to when creating your NetSuite record.

Unconfigured NetSuite add object action After selecting your object, select the specific fields you wish to write to

Take note that some NetSuite fields are displayed with their internal API names instead of their labels in NetSuite. For example, entity ID refers to the customer/vendor to attach a transaction document to, while internal ID refers to the NetSuite ID of any object.

If you can't find the field you're looking for, check with your NetSuite admin or with us!

# Search standard objects action

The search standard objects action will return a list of records that match the criteria given. If no matching record is found, the action will simply return an empty array. Certain records are not supported in the action due to API limitations.

# Configuring the search standard objects action

To carry out a search standard object action, we would first need to tell the recipe exactly what standard object category and what specific object we want to search for. The following displays an unconfigured search standard object action.

Unconfigured search standard object action. Select the category and specific object to search for.

Regardless of category, we're able to search for any standard objects by its internal ID or its external ID. As these IDs are unique, we would only retrieve a maximum of 1 record if we search by IDs.

Available categories to search from

Regardless of category, we're able to search for any standard objects by its internal ID or its external ID. As these IDs are unique, we would only retrieve a maximum of 1 record if we search by IDs.

Ability to search NetSuite record by unique internal ID or external ID

Depending on the object category selected, we would be able to search by additional fields specific to that category.

When selecting the fields to search by in the NetSuite connector, take note that some NetSuite fields are displayed with their internal API names instead of their labels in NetSuite. For example, entity ID refers to the customer/vendor to attach a transaction document to, while internal ID refers to the NetSuite ID of any object.

If you can't find the field you're looking for, check with your NetSuite admin or with us!

# Search custom objects action

The search custom objects action will return a list of records that match the criteria given. If no matching record is found, the action will simply return an empty array.

# Configuring the search custom objects action

To carry out a search custom objects action, we would first need to tell the recipe exactly what specific custom object we want to search for. The following displays an unconfigured search custom objects action.

Unconfigured search custom object action. Select the specific object to search for.

Regardless of selected object, we're able to search for any custom objects by its internal ID or its external ID. As these IDs are unique, we would only retrieve a maximum of 1 record if we search by IDs.

Depending on the object selected, we would be able to search by additional fields specific to that object.

Available fields to search by for the custom object estimate

If you can't find the field you're looking for, check with your NetSuite admin or with us!

# Get all standard objects action

The get all standard objects action will return the entire list of records of the selected record type in your NetSuite.

# Configuring the get all standard objects action

To carry out a get all standard object action, we would first need to tell the recipe exactly what standard object category you want to retrieve. The output of this action will be a list containing all records in your NetSuite instance. You can then filter this list of records using .where methods in formula mode in downstream actions. Find out more here

Configuring the get all standard objects action

If you can't find the object you're looking for, check with your NetSuite admin or with us!

# Update standard object and update custom object action

The update standard object and update custom object actions are similar except that the former works with standard NetSuite objects, while the latter works with custom objects created by your organization.

In this section, we'll be covering how to use the update standard object action, which will be applicable for the update custom object action as well.

# Functions of the update object actions

The following lists the various types of updates you can do with the update object action.

Overwrite existing field values with new values (you can't delete an existing value of a field and change it to null/a blank value, however)
Append new lines to records (for example, add additional line items to your sales order)
Replace all lines in records (for example, overwrite all existing line items in your sales order with a new set of line items)

# Configuring your update action

First, specify the object to update via internal ID or external ID To update your NetSuite record, you first need to specify which record to update. You can use either the internal ID or the external ID to specify the record - all other fields with values passed into them will overwrite the original existing value in the NetSuite record.

Specify record to update by ID Specifying the NetSuite record to update with either internal ID or external ID

Next, configure the action to carry out the type of update you want: overwrite existing values or append values

Overwrite existing field values

To do this, simply select the fields you wish to write to, then input the values or variables you wish to overwrite it with. For example, we might have a Shopify ecommerce site set up, and we want to move all our sales orders made in Shopify into NetSuite for inventory and delivery management.

In the following recipe, we're moving all newly created sales orders and all updates to existing orders from Shopify into NetSuite. Whenever there's a new/updated Shopify order, we try to search for the corresponding NetSuite order. If it exists, we'd update that NetSuite order. If it doesn't exist, we'll create a NetSuite order.

Shopify to NetSuite recipe Recipe that syncs Shopify sales orders into NetSuite.

In Step 3, which is the branch of the recipe we'd execute if we manage to find a NetSuite order that corresponds to the incoming Shopify sales order, we pass in the internal ID of the NetSuite order we've found.

Specify NetSuite record to update via internal ID

In this update action, we're taking the values of the note and email fields in the Shopify order, and updating the values of the memo and email fields in the corresponding NetSuite order.

Update memo and email fields

When selecting the fields to update in the NetSuite connector, take note that some NetSuite fields are displayed with their internal API names instead of their labels in NetSuite. For example, entity ID refers to the customer/vendor to attach a transaction document to, while internal ID refers to the NetSuite ID of any object.

If you can't find the field you're looking for, check with your NetSuite admin or with us!

Append new lines to object VS replacing all lines in the object

There are numerous NetSuite objects which contains one or more lists. For example, transaction objects such as sales orders have lists of line items. When updating objects in NetSuite, with most lists you have the ability to define whether you'd like to append more elements to the list, or if you'd like to replace the existing list with a whole new list.

First specify the object you'd like to update, then the specific ID of the object to update. Do the same data mapping for the item list as you would usually do.

Specify NetSuite record to update via internal ID Select object and record ID to update

At the end of most NetSuite lists, you will see the Replace all option. Select True to overwrite all existing list items, select False to append new list items to existing list of items.

Specify NetSuite record to update via internal ID Replace all picklist found at the end of NetSuite lists

If you can't find the field you're looking for, check with your NetSuite admin or with us!

# Unsupported records

There are certain records that triggers and search actions do not support, as they cannot be queried via the NetSuite API.

Users can use the Get all standard records action to retrieve these objects not found in search actions or triggers:

Budget category
Campaign audience
Campaign category
Campaign channel
Campaign family
Campaign offer
Campaign search engine
Campaign subscription
Campaign vertical
Currency
Lead source
State
Support case issue
Support case origin
Support case priority
Support case status
Support case type
Tax account

The following records are not supported:

Campaign response
Item revision
Landed cost
Sales tax item
Tax group
Tax type
Currency revaluation
Payroll adjustment
Inventory worksheet