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.
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.
Configuration of a NetSuite connection includes these fields:
TIP: Fields with a variable icon support using global variables, project variables, and Jitterbit variables. Begin typing an open square bracket
/) or colons (
:). As a specific connection and its activities are referred to as an endpoint, this name is also used to identify the NetSuite endpoint.
Account: Enter the NetSuite account ID associated with the NetSuite account you want to use. Accounts associated with a NetSuite sandbox environment may be indicated with a suffix such as _SB1, _SB2, etc.
WSDL Download URL: Enter the URL of the NetSuite WSDL used in the NetSuite instance. Jitterbit supports these WSDL versions:
https://webservices.netsuite.com/wsdl/v2019_2_0/netsuite.wsdl(supported with all agent versions)
https://webservices.netsuite.com/wsdl/v2019_1_0/netsuite.wsdl(supported with agents version 10.4 or higher)
|NOTE: As of January 2018, NetSuite uses the same URL for both their production and sandbox domain. If your NetSuite sandbox has not been refreshed since these changes were implemented, you may need to use a sandbox-specific WSDL URL. For more information, see NetSuite's documentation About Sandbox Accounts on the NetSuite Domain (login to NetSuite required).|
CAUTION: If you receive an error regarding the data center while testing the connection, you may need to use a different WSDL URL. For more information, see Data Center Error later on this page.
Consumer Key and Consumer Secret: Enter the NetSuite Consumer Key and Consumer Secret values obtained from NetSuite. For instructions on obtaining these values, see Gathering Values for Jitterbit Harmony under NetSuite.
Token Key and Token Secret: Enter the NetSuite Token ID and Token Secret values obtained from NetSuite. For instructions on obtaining these values, see Gathering Values for Jitterbit Harmony under NetSuite.
|CAUTION: If you are using a NetSuite sandbox account, each time the sandbox is refreshed, you will need to create new tokens.|
Call Time Out: Optionally enter the call timeout value in seconds if you want to the timeout value to be less than the agent setting.
|NOTE: The default agent setting for timeout of NetSuite calls is 300 seconds.|
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.
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:
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 to display a list of autocomplete suggestions. Select a connection to insert the connection reference into the script.
This section describes issues and workarounds to common issues experienced with NetSuite connections.
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.
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).