Celigo NetSuite Integrator SuiteApp 2.0 (beta)

Currently available for NetSuite integrations, Celigo NetSuite Integrator 2.0 is built as a SuiteApp on SuiteCloud Development Framework (SDF). This technology upgrade offers several advantages over the NetSuite bundles that are coded for the popular but less robust SuiteScript v1.0. 

Contents

• What’s new
  • Known differences
  • Beta release limitations
• Install the SuiteApp
• Apply SuiteScript 2.0 to a NetSuite export
• Apply SuiteScript 2.0 to a NetSuite listener (in a “real-time” flow)
• Apply SuiteScript 2.0 to a NetSuite import
• Update hooks
• Celigo NetSuite script descriptions

What’s new

Customers who switch to NetSuite Integrator 2.0 will have access to the following features:

• You’re now able to write hooks in SuiteScript 2.0, when implementing Celigo Integrator 2.0
• Faster SuiteApp upgrades 
• Native functionality that takes advantage of the new NetSuite SDF architecture, now and going forward
• Support for newer NetSuite record types that might be supported only in SuiteScript 2.0
• Unlimited dynamic lookups for NetSuite imports – that is, you won’t have to worry about exceeding SuiteScript point restrictions in common import operations 

Known differences

SuiteScript 2.0 differences may have a slight effect on your current integration logic:

• Checkboxes have the standard value of true or false (instead of the earlier "T" or "F")
• SuiteScript hooks have a slightly different sequence

Beta release limitations

We are committed to an aggressive timeline to be able to offer you integration features and performance at least comparable with the NetSuite bundles.

For the initial rollout, NetSuite Integrator 2.0 does not support the following functions:

• Subrecords on import (sublists work as expected)
• Automatic migration – you must follow the steps below
• Integration Apps (options available only to custom flows)

We will continue to update this page with fully tested and released enhancements. Keep in mind that the above limitations would work as expected in SuiteScript 1.0. 

Install the SuiteApp

At present, Celigo NetSuite Integrator 2.0 relies on the integrator.io NetSuite (SuiteScript 1.0) bundle to return additional information. Before you begin, install the current NetSuite bundle (20038).

To install any SuiteApp, you must be signed in to NetSuite as an administrator. Then, you can choose either installation method, simply as a matter of convenience:

Launch installation from integrator.io

When creating an export or import (see below) using SuiteScript 2.0, integrator.io will try to confirm whether Celigo Integrator on SuiteScript 2.0 SuiteApp is already installed in your NetSuite account. If it cannot be confirmed, you are presented with a hyperlink to suggest you install the SuiteApp.

Example import; same link shown for export

Once logged into NetSuite, you will be redirected you to the page below. Click Install to proceed. 

Apply SuiteScript 2.0 to a NetSuite export

1. Open a new export from NetSuite to modify its settings. 
2. Expand the Advanced section. 
3. For the NetSuite API version, select SuiteScript 2.0 (beta).
4. Save the export, and verify that any SuiteScript hooks in your integration are written for the corresponding version (SuiteScript 1.0 and 2.0 are incompatible).

Tip: Depending on your flows’ requirements, you may apply different SuiteScript versions to each flow step and they will work correctly. For example, most of your imports may stay at the default SuiteScript 1.0, while another import is set to SuiteScript 2.0. Or, an export using SuiteScript 2.0 may send records to an import using SuiteScript 1.0.

Apply SuiteScript 2.0 to a NetSuite listener (in a “real-time” flow)

1. In Flow Builder, click Add source.
2. Select NetSuite for the Application.
3. Under What would you like to do? choose Listen for real-time data in source application.
4. Select your NetSuite connection (or create one if you have not already done so).
5. Click Next. The Create listener panel opens.
   1. Name the new listener, and specify the Record type, Execution context, and Execution type.
   2. If needed, provide any Sublists to include and Field-specific qualification criteria.
6. Expand the Advanced section, and click SuiteScript 2.0 (beta).

If you have not yet installed Celigo NetSuite Integrator 2.0, a reminder with a link appears at the top of the panel:

Apply SuiteScript 2.0 to a NetSuite import

1. Open a new import to NetSuite, and modify its settings. 
2. Expand the Advanced section. 
3. For the NetSuite API version, select SuiteScript 2.0 (beta).
4. Save the import, and verify that any SuiteScript hooks in your integration are written for the corresponding version (SuiteScript 1.0 and 2.0 are incompatible).

Updates to integrator.io SuiteScript hooks

Your integration hooks will differ slightly after you upgrade to NetSuite Integrator 2.0.

integrator.io SuiteScript hooks (for NetSuite SuiteScript 2.0) can be written in SuiteScript 2.0 and can use completely native NetSuite modules.

Celigo NetSuite script descriptions

The following scripts are included in the NetSuite bundle: