NetSuite Connection

Introduction

A NetSuite connection is configured using the NetSuite connector, establishing access to the NetSuite endpoint. Once a connection is established, you can configure one or more NetSuite activities associated with that connection to be used either as a source to provide data to an operation or as a target to consume data in an operation. In addition, the NetSuite connection can be used in 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, use the Show dropdown to filter on Connectors, and then click the NetSuite connector block:

To configure an existing NetSuite connection, use the Show dropdown to filter on Endpoints, and then double-click the NetSuite connection block:

These open the configuration screen for the NetSuite connection, covered next.

Configuring a NetSuite Connection

Configuration of a NetSuite connection includes these fields:

• Endpoint Name: Enter a name to use to identify the NetSuite connection. The name must be unique for each NetSuite connection and must not contain forward slashes (/) or colons (:). This name is also used to identify the NetSuite endpoint, which refers to both a specific connection and its activities.

• 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 account-specific URL of the NetSuite WSDL used by the NetSuite instance. Jitterbit supports the WSDL versions listed in NetSuite Prerequisites. Instructions for obtaining the account-specific WSDL URL are provided in Using a NetSuite Account-Specific WSDL URL.

• 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 Using NetSuite TBA.

• 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 Using NetSuite TBA.

  CAUTION: If you are using a NetSuite sandbox account, each time the sandbox is refreshed, you need to create new tokens.

• Signature Algorithm: Use the dropdown to select the signature algorithm to be used to sign the request, one of HMAC-SHA1 or HMAC-SHA256. The signature algorithm determines how the payload is encrypted.

  NOTE: NetSuite has deprecated HMAC-SHA1 as a valid signature method in favor of HMAC-SHA256 as of these versions:

  • Non-Production Accounts: NetSuite version 2021.2 and later
  • Production Accounts: NetSuite version 2022.1 and later

  The deprecation of HMAC-SHA1 is independent of which WSDL version you specify in the configuration of the NetSuite connection.

• Call Time Out: Enter the call timeout value in seconds if you want to the timeout value to be less than the default agent setting.

  NOTE: The default agent setting for timeout of NetSuite calls is 300 seconds. For Private Agents, this default can be changed in the [ConnectorsInfo] section of the Private Agent configuration file.
• Retry on Recoverable Exception: This setting is functional only when using an environment associated with a Private Agent Group whose agents are version 10.24 or later. Its behavior depends on the Private Agent version. When selected, this setting is used to retry a rejected request to NetSuite when either of these criteria is met:
  • Private Agents 10.24 and later: NetSuite's governance limit for concurrent requests is reached and the error WS_REQUEST_BLOCKED is returned.
  • Private Agents 10.36 and later: NetSuite does not return a response in the expected timeframe and a timeout exception occurs.

  To check your NetSuite account's concurrency limits, in the NetSuite UI, go to Setup > Integration > Integration Governance. For more information, see NetSuite's documentation on Concurrency Governance Limits Based on Service Tiers and SuiteCloud Plus Licenses.

  In order for this setting to take effect, the Jitterbit variable jitterbit.netsuite.async must not be set to true upstream of the operation.

  With Private Agents version 10.23 or earlier, on Cloud Agents, or if the Jitterbit asynchronous variable is enabled, this setting will be ignored.

  Select the Retry on Recoverable Exception checkbox to expand additional configuration options:

  

  • Retry Interval (Seconds): Enter the number of seconds (maximum of 5 seconds) to wait between resending a rejected request to NetSuite.
  • Max Retries: Enter the number of times (maximum of 5 retries) that a rejected request will be resent to NetSuite. If the request is still rejected after the maximum number of retries, an exception with an error message will be returned in the operation log. In addition, the Private Agent will log each retry in the jitterbit-agent.log log file.

    Each retry is treated as part of the same operation run, where only a single record appears in the operation log. Any operation actions configured to run downstream operations are triggered based on the end status of the operation after retrying up to the maximum number of retries.

• Test: Click to verify the connection using the provided credentials.

  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 NetSuite Data Center Error.

• Save Changes: Click to save and close the connection configuration.
• Discard Changes: After making changes to a new or existing configuration, click to close the configuration without saving. A message asks you to confirm that you want to discard changes.
• Delete: After opening an existing connection configuration, click to permanently delete the connection from the project and close the configuration (see Component Dependencies, Deletion, and Removal). A message asks you to confirm that you want to delete the connection.

Next Steps

After a NetSuite connection has been created, menu actions for that connection are accessible from the project pane's Components tab. See Connection Actions Menu for details.

After configuring a NetSuite connection, you can configure one or more NetSuite activities associated with that connection to be used either as a source to provide data to an operation or as a target to consume data in an operation, or you can use the NetSuite connection within a script.

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).

After configuring a NetSuite connection, use the Show dropdown to filter on Endpoints, and then click the NetSuite connection block to display activities that are available to be used with a NetSuite connection:

For more information, see these activities:

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

Using NetSuite Connections in Scripts

NetSuite connections can be referenced in a script using script functions that use a netSuiteOrg as a parameter. For more information, see Using NetSuite Functions.