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:

  1. You must have SuiteTalk enabled on your NetSuite account.
  2. You must have the appropriate permissions role on your NetSuite account.
  3. To use token-based authentication (TBA):
    1. You must be using SuiteTalk version 2015.2 or higher.
    2. You must have TBA enabled for your NetSuite account.
    3. To configure a new TBA endpoint, you must be using Jitterbit Harmony Design Studio and Agent versions 9.2 or higher.
    4. 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. This authentication type is being phased out by NetSuite, and 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.

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.

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:  Jul 18, 2019