Upgrade and Migrate to NetSuite 10.0 - Mule 4

Upgrade NetSuite Connector to version 10.0 to use the new features.

Supported Upgrade Paths

From Version To Version



New Features in This Release

This release contains the following new features:

  • These operations were added:

    • Get Account Governance Info

    • Get Integration Governance Info

Changed Functionality in This Release

This release contains the following changed functionality:

  • The Login and SSO authentication types were removed.
    If your integration is based on these authentication types, you must migrate to a Request or Token-Based authentication type.

  • Other nonfunctional changes were applied to the interface of the connector to make it more consistent with other Anypoint Connectors.
    This means that some of the operation calls in your existing application might not initially work until some minor migration tasks are performed.

  • Unknown errors are now thrown as ANY rather than UNKNOWN.
    Consequently, error codes DISPOSE_ERROR, MAPPING_ERROR, CANT_READ_FILE, and TRIGGER are now considered ERROR_FAULT errors instead of UNKNOWN.

  • The Map SSO operation was removed.

  • All exposed classes have been moved from the org.mule.module.netsuite.extension.api package to the com.mulesoft.connector.netsuite.extension.api package.

Changed Operations

The behavior of some operations has changed in NetSuite Connector 10.0.

The following operations' parameters no longer default to payload:

Operation Parameter

Change Email


Change Password


Get Data Center URLs


Get Async Result


Get Custom Record


The following operations' parameters are now primary content parameters:

Operation Parameter

Async Search


Async Add List


Async Update List


Async Upsert List


Update Invitee Status List


Get Posting Transaction Summary


Get Posting Transaction Summary


Add File


Add Record


Get Deleted Records


Update Record


Upsert Record


When a parameter is designated as primary content, if you do not explicitly assign a value to it, it defaults to payload.

For example, the criteria parameter for the Async Search operation is now designated as a primary content parameter. This means that if you do not explicitly assign a value to the criteria parameter, it defaults to payload].

Additionally, since criteria is now a content parameter, you no longer use it like this:
<netsuite:async-search config-ref="…​" criteria="something">.

Instead, you must assign it like this:

<netsuite:async-search config-ref="...">
  <netsuite:criteria> something, a DW script, etc </netsuite:criteria>

Changed Sources

The three message sources were renamed:

Source name Old XML name New XML name

On New Object



On Modified Object



On Deleted Object



Upgrade Steps

If you are upgrading from an earlier version of the connector, you can click the Updates Available pop-up message in the bottom right corner of Anypoint Studio and follow the prompts.

You can also follow these steps to perform the upgrade:

  1. In Anypoint Studio, create a Mule project.

  2. In Mule Palette, click Search in Exchange.

  3. In Add Dependencies to Project, enter netsuite in the search field.

  4. In Available modules, select NetSuite and click Add.
    Studio upgrades the connector automatically.

  5. Click Finish.

  6. In the pom.xml file for the Mule project, verify that the NetSuite Connector dependency version is 10.0.0.

Post Upgrade Tasks

  • Ensure that your configurations use either Request Based or Token authentication.

  • Verify that your error handling is updated to work with the minor changes in error codes in this version of the connector.

  • Refer to Changed Operations and Changed Sources for updated operations and sources.
    If your integration uses any of the affected operations and sources, make the necessary changes to comply with the new interfaces.

  • Because the package of the exposed classes was changed to com.mulesoft.connector.netsuite.extension.api, you must update all DataWeave mappings that create objects for operation inputs.
    You must also update mappings that transform object outputs.

Verify the Upgrade

After you install the latest version of the connector, verify the upgrade:

  1. In Studio, verify that there are no errors in the Problems or Console views.

  2. Verify that there are no problems in the project pom.xml file.

  3. Test the connection to verify that the operations work.

Revert the Upgrade

If you must revert to your previous version of NetSuite Connector, change the mule-netsuite-connector dependency version 10.0.0 in the project’s pom.xml to the previous version. Additionally, revert any changes made in the operations to their previous state.