QUICK LINKS
View Jitterbit Developer Portal
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.
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.
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
[
into the field or click the variable icon to display existing variables to choose from.
/
) 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_1_0/netsuite.wsdl
(supported with agents version 10.4 or higher)https://webservices.netsuite.com/wsdl/v2018_1_0/netsuite.wsdl
https://webservices.netsuite.com/wsdl/v2017_2_0/netsuite.wsdl
https://webservices.netsuite.com/wsdl/v2016_2_0/netsuite.wsdl
(default)
https://webservices.netsuite.com/wsdl/v2016_1_0/netsuite.wsdl
https://webservices.netsuite.com/wsdl/v2015_2_0/netsuite.wsdl
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.
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.
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.
For more details on referencing activities in scripts, see Endpoints on the Jitterbit Script page.
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.
https://webservices.netsuite.com/wsdl/v2016_2_0/netsuite.wsdl
http://123456.suitetalk.api.netsuite.com/wsdl/v2016_2_0/netsuite.wsdl
https://webservices.netsuite.com/wsdl/v2016_2_0/netsuite.wsdl
https://webservices.na3.netsuite.com/wsdl/v2016_2_0/netsuite.wsdl
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).
Last updated: Nov 20, 2019