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: The Consumer Secret and Token Secret are used to sign the request using either of these supported signature algorithms: HMAC-SHA1 or HMAC-SHA256. You may use either one to determine how the payload is encrypted.

• 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 Concurrent Exception: Available only when using an environment associated with a Private Agent Group, this setting is used to retry a rejected request to NetSuite when NetSuite's governance limit for concurrent requests is reached. If this limit is reached, the request is rejected and the error WS_REQUEST_BLOCKED is returned.

  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 (login to NetSuite required).

  In order for this setting to take effect, Private Agents must be version 10.24 or higher and the Jitterbit variable jitterbit.netsuite.async must not be set to true upstream of the operation. With earlier agent versions, or if the Jitterbit asynchronous variable is enabled, the configuration of this setting will be ignored without an error.

  Select the checkbox to expand additional configuration options:

  

  • Retry Interval (Seconds): Enter the number of seconds (maximum of 5) to wait between resending a rejected request to NetSuite.
  • Max Retries: Enter the number of times (maximum of 5) 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 log file jitterbit-agent.log will log each retry.

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