Skip to end of metadata
Go to start of metadata

Introduction

A NetSuite connection is configured using the NetSuite connector to establish access with a specific NetSuite instance. Once a connection is established, you can configure one or more NetSuite activities associated with that connection to use as a source or target within an operation. In addition, the NetSuite connection can be used within scripts.

Creating or Editing a NetSuite Connection

From the design canvas, open the Connectivity tab of the design component palette:

To configure a new NetSuite connection, within the Connectors filter, click the NetSuite connector block:

To configure an existing NetSuite connection, within the Endpoints filter, double-click the NetSuite connection block:

This will open a configuration screen for the NetSuite connection, covered next.

Configuring a NetSuite Connection

Configuration of a NetSuite connection includes these fields:

TIP: Fields with a variable icon support using global variablesproject variables, and Jitterbit variables. Begin typing an open square bracket [ into the field or click the variable icon to display existing variables to choose from.

Next Steps

After configuring a NetSuite connection, you can configure one or more NetSuite activities associated with that connection to use as a source or target within an operation, or you can use the NetSuite connection within a script as described below.

Configuring Activities

NetSuite activities interact with the NetSuite connection to act as sources (providing data within an operation) or targets (receiving data within an operation). For more information, see these activities:

  • Search: Retrieves existing records from a NetSuite connection and is used as a source in an operation.
  • Create: Creates new records in a NetSuite connection and is used as a target in an operation.
  • Update: Updates existing records in a NetSuite connection and is used as a target in an operation.
  • Get List: Retrieves a list of existing records based on ID from a NetSuite connection and is used as a target in an operation.
  • Upsert: Both updates existing records and creates new records in a NetSuite connection and is used as a target in an operation.
  • Delete: Deletes records in a NetSuite connection and is used as a target in an operation.

Using NetSuite Connections in Scripts

NetSuite connections can be referenced in a script using certain script functions that use a netSuiteOrg as a parameter. For example:

To add a NetSuite connection to a script to be referenced by one of these functions, drag the configured endpoint from the Endpoints tab of the script component palette to the script. Or, if you already know the function you want to use, add it from the Functions tab first; then position the cursor after the opening parenthesis of the function and press Control+Space (or Command+Space on Mac) to bring up a list of autocomplete suggestions. The connection reference will be inserted into the script.

For more details on referencing activities in scripts, see Endpoints on the Jitterbit Script page.

Troubleshooting

This section describes issues and workarounds to common issues experienced with NetSuite connections.

Data Center Error

A connection may have previously been tested successfully, but now fails with this error:

You are not requesting the correct data center for your company.

This error may result from a NetSuite account having been moved to another data center on NetSuite's side, resulting in a change to the WSDL URL.

To resolve, change the WSDL to either (1) the account-specific domain or (2) the data center-specific domain. Details on obtaining the URL for your specific account or data center are provided in NetSuite's documentation on URLs for Account-Specific Domains and Understanding NetSuite URLs and Data Centers (login to NetSuite required).

NetSuite recommends using the getDataCenterUrls SOAP call to dynamically discover your account-specific NetSuite domain. Account-specific domains are independent of the data center your account is in, so if your data center changes, you will not need to adjust the URL. Once you have the correct WSDL, use it in the configuration of the NetSuite connection in Cloud Studio.

Example of Account-Specific WSDL

Example of Data Center-Specific WSDL

Permissions Error

Even if testing a NetSuite connection is successful, you may receive an INSUFFICIENT_PERMISSION error upon running operations containing activities using that connection.

In this case, you may need to use a different role for generating TBA access tokens or add permissions to the role you are currently using.

To resolve, while generating access tokens, make sure to generate them on either a Full Access or Administrator role or make sure the appropriate permissions are allowed for the role.

Detailed instructions are available in NetSuite's documentation Getting Started with Token-based Authentication (login to NetSuite required).

On This Page

Last updated:  Aug 06, 2019

  • No labels