Skip to end of metadata
Go to start of metadata

Introduction

Before you can create NetSuite operations in Jitterbit using the NetSuite Connector, you must configure at least one NetSuite endpoint.

Each endpoint represents the URL and login credentials for a specific NetSuite account. Creating the endpoint allows Jitterbit to access the account to perform the requested operations. If your organization uses multiple NetSuite accounts, you will need to create an endpoint for each account.

Other ways to connect to NetSuite using Jitterbit Studio include using a web service method or calling a RESTlet. More information about these options is provided within these pages:

Prerequisites

To successfully use the Jitterbit NetSuite Connector for NetSuite integrations, these criteria must be met:

  • The NetSuite instance must use one of these NetSuite WSDL versions:
  • The WSDL URL must be provided in the format of an account-specific WSDL URL. Instructions for obtaining the WSDL URL are provided in NetSuite Account-Specific WSDL URL.
  • NetSuite WSDL 2020.1 requires Jitterbit Harmony Cloud or Private Agents version 10.18 or higher.
  • NetSuite WSDL 2019.1 or 2019.2 requires Jitterbit Harmony Cloud or Private Agents version 10.4 or higher.
  • NetSuite WSDLs up to 2018.2 require Jitterbit Harmony Cloud or Private Agents version 9.9 or higher. 
  • To use token-based authentication (TBA):
    • You must be using SuiteTalk version 2015.2 or higher.
    • You must have TBA enabled for your NetSuite account.
    • To configure a new TBA endpoint, you must be using Jitterbit Harmony Design Studio and Agent versions 9.2 or higher.
    • To convert an existing SSO endpoint to use TBA, you must be using Jitterbit Harmony Design Studio version 9.3.1 or higher and Agents version 9.2 or higher.

TIP: For additional information, refer to the following NetSuite documentation (login to NetSuite required):

Create an Endpoint

NOTE: If you are not already familiar with Jitterbit, see Getting Started or Design Studio for detailed information on how to use the product.

Within your project within Jitterbit Studio, there are several ways to start a new NetSuite endpoint:

  • Go to File > New > Connectors > New NetSuite Endpoint.
  • In the tree on the left under Connectors, right-click on the NetSuite category, then select New NetSuite Endpoint.
  • In the tree on the left under Connectors, double-click on the NetSuite category, then right-click on New NetSuite Endpoint and select New NetSuite Endpoint.
  • In the top toolbar, click the connector icon (orange jigsaw piece) . In the popup, select NetSuite, then select NetSuite Endpoint.

Select Authentication Type

In the first screen of the NetSuite endpoint wizard, choose how you would like Jitterbit to authenticate with your NetSuite instance using the credentials provided in the next screen. Each option is explained below.

  • SSO: SSO (Single Sign-On) is the traditional method used by Jitterbit for authenticating with NetSuite and is available in all Jitterbit Harmony versions where the NetSuite Connector is available. The SSO authentication type has been deprecated by NetSuite and is no longer supported with NetSuite WSDL versions 2020.1 and higher. It is now recommended for all users to use TBA.

    CAUTION: With the SSO authentication type, Jitterbit users whose NetSuite subscription is limited to a single thread of processing may experience issues with throughput. These users should use TBA. NetSuite users with a SuiteCloud Plus license can use either type of authentication, as this license type allows greater concurrency of threads.
    WARNING: Those using NetSuite two-factor authentication (TFA or 2FA) should not use the SSO authentication type. Doing so may cause your NetSuite endpoint to fail. Instead, use TBA.
  • TBA: TBA (Token-Based Authentication) is available to those using Jitterbit Harmony Design Studio and Agent versions 9.2 and higher. In Jitterbit, using TBA facilitates using multiple processing threads thereby resolving throughput issues that may be experienced by NetSuite users limited by their NetSuite subscription.

    NOTE: Those using NetSuite two-factor authentication (TFA or 2FA) in NetSuite are required to use TBA with Jitterbit Harmony. Learn more in NetSuite 2018.2 Token-Based Authentication.

Enter Credentials

Click Next to continue. The next screens depend on whether you have selected SSO or TBA.

SSO

Enter the SSO credentials for your new NetSuite endpoint. An example is provided below. Each configurable option is explained as follows.

  • Name: Enter an appropriate name for your new NetSuite endpoint. If you are creating endpoints for multiple NetSuite accounts, it is a good idea to distinguish them here by name.
  • Account: Enter the NetSuite account ID associated with your NetSuite account.

    NOTE: If you are using NetSuite's sandbox environment, this is now indicated by the NetSuite account ID. For example, the account ID may be appended with _SB1, _SB2, etc.

    Because NetSuite no longer uses separate sandbox URL and sandbox is now indicated by account ID, the Sandbox checkbox has been removed in Design Studio versions 9.2 and higher.

    More information can be found in NetSuite's documentation About Sandbox Accounts on the NetSuite Domain (login to NetSuite required).

  • Email: Enter the email address you use to log in to your NetSuite account.
  • Customer Center Role: Check this box if you are using NetSuite Customer Center role to control permissions.
  • Password: Enter the password you use to log in to your NetSuite account.

  • Wsdl Download Url: Enter the account-specific URL of the NetSuite WSDL used by the NetSuite instance. Jitterbit supports the WSDL versions listed in Prerequisites earlier on this page. Instructions for obtaining the account-specific WSDL URL are provided in NetSuite Account-Specific WSDL URL.
  • Application ID: Optionally enter your Application ID, if you have been issued one by NetSuite. If not, leave this field blank.

    TIP: To generate a new Application ID for Jitterbit or to locate one that already exists, see Getting a NetSuite Application ID
  • 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.

TBA

To obtain the values needed for this screen, you must have enabled TBA for your NetSuite account. After configuring TBA in NetSuite, enter the TBA credentials for your new NetSuite endpoint. An example is provided below. Each configurable option is explained as follows.

  • Name: Enter an appropriate name for your new NetSuite endpoint. If you are creating endpoints for multiple NetSuite accounts, it is a good idea to distinguish them here by name.
  • Account: Enter the NetSuite account ID associated with your NetSuite account.

    NOTE: If you are using NetSuite's sandbox environment, this is now indicated by the NetSuite account ID. For example, the account ID may be appended with _SB1, _SB2, etc.

    Because NetSuite no longer uses separate sandbox URL and sandbox is now indicated by account ID, the Sandbox checkbox has been removed in Design Studio versions 9.2 and higher.

    More information can be found in NetSuite's documentation About Sandbox Accounts on the NetSuite Domain (login to NetSuite required).

  • Wsdl Download Url: Enter the account-specific URL of the NetSuite WSDL used by the NetSuite instance. Jitterbit supports the WSDL versions listed in Prerequisites earlier on this page. Instructions for obtaining the account-specific WSDL URL are provided in 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 Enabling TBA in 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 Enabling TBA in NetSuite.

    CAUTION: If you are using a NetSuite sandbox account, each time the sandbox is refreshed, you will 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. These affect how the payload is encrypted and you may select either type.
  • 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.

Verify Credentials (SSO)

NOTE: This step is not present for TBA. Instead those using TBA can verify credentials using the Test Connection button as described in the next section, Edit or Test an Endpoint.

For the SSO authentication type only, upon clicking Finish, Jitterbit will verify the provided credentials.

  • If successful, your new NetSuite endpoint will be created. The endpoint configuration screen will open in the main view of Studio. You can get back to the configuration screen at any time by double-clicking the endpoint in the tree on the left under Connectors > NetSuite > NetSuite Endpoints.
  • If unsuccessful, a message will appear indicating a problem with the credentials. You can still choose to create the endpoint and modify credentials later.

Edit or Test an Endpoint

After your endpoint is created, you can get back to the configuration screen at any time by double-clicking the endpoint in the tree on the left under Connectors > NetSuite > NetSuite Endpoints.

SSO

For the SSO authentication type, the configuration screen will look similar to that below.

  • Name: Rename your existing NetSuite endpoint. If you are creating endpoints for multiple NetSuite accounts, it is a good idea to distinguish them here by name.
  • Passport: This section contains the information entered when the endpoint was created. The Account and Email are listed here. You can also edit the Wsdl Download Url and optional Application ID and Call Time Out fields here. These fields are the same as those described above on this page.
  • Convert to TBA: This option is available in Design Studio version 9.3.1 and higher.

    Click the Convert to TBA button to open a popup window to enter credentials for changing the authentication type from SSO to TBA. The value used for each field is documented earlier on this page under Enter Credentials in the TBA section.

  • Edit Credentials: Click the Edit Credentials button to edit the AccountEmailPassword, or Customer Center Role settings. These options are the same as those described above on this page.
  • Test Connection: Click the Test Connection button to verify the connection to your NetSuite account. A message will indicate if the connection is successful. If the connection is not successful, make sure you meet the prerequisites and double check the values you provided on this screen. If you receive an error testing the connection, refer to troubleshooting information.

TBA

For the TBA authentication type, the configuration will look similar to that below.

  • Name: Rename your existing NetSuite endpoint. If you are creating endpoints for multiple NetSuite accounts, it is a good idea to distinguish them here by name.
  • TBA Passport: This section contains the information entered when the endpoint was created. You can edit any of the fields available from the original configuration, as described above on this page.
  • Test Connection: Click the Test Connection button to verify the connection to your NetSuite account. A message will indicate if the connection is successful. If the connection is not successful, make sure you meet the prerequisites and double check the values you provided on this screen. If you receive an error testing the connection, refer to troubleshooting information.
On This Page

Last updated:  Aug 13, 2020