---
schema_version: "1"
id: ecac2b385bbefc452722cc40fbc53cfa4e54911bbb11e5cd4153e67e10451925
title: Upgrading and Migrating NetSuite Connector to Version 12.x
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/netsuite-connector/latest/netsuite-connector-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/netsuite-connector/latest/netsuite-connector-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: a0e2b418696393a58be89268695b0ca4b7945e69ab858450598e05eba390d998
description: MuleSoft Documentation Site
release: "12.0"
latest: true
---
---
product: NetSuite Connector
version: 12.0
is-latest-version: true
---

# Upgrading and Migrating NetSuite Connector to Version 12.x

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Upgrade Anypoint Connector for NetSuite (NetSuite Connector) to version 12.x.

## Supported Upgrade Paths

<table><colgroup><col> <col></colgroup><thead><tr><th>From Version</th><th>To Version</th></tr></thead><tbody><tr><td><p>11.x</p></td><td><p>12.x</p></td></tr></tbody></table>

## Changes in This Release

- NetSuite Connector is now compatible only with Java 17.

- The connector no longer supports the **Omit the internal Id in the name of the custom field**
  field because its functionality is now the default behavior of the connector.

- These libraries are upgraded to address reported security vulnerabilities:

  - The `springframework` library is upgraded to version 6.2.

  - The `jakarta.activation-api` library is upgraded to version 2.1.4.

  - The `wiremock.server.dependency` library is upgraded to version 3.0.1.

  - The PowerMock library is replaced by Mockito version 5.2.0.

  - The `commons-io` library is added at version 2.16.1.

  - The `disruptor` library is added at version 4.0.0.

## Requirements

Ensure your system meets the following compatibility requirements before you perform the upgrade:

<table><colgroup><col> <col></colgroup><thead><tr><th>Application/Service</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.9.0 and later</p></td></tr><tr><td><p>Java</p></td><td><p>17</p></td></tr></tbody></table>

## Upgrade Prerequisites

Before you perform the upgrade, create a backup of your files, data, and configuration in case you
need to restore to the previous version.

## Upgrade Steps

Follow these steps to perform the upgrade to version 12.x:

1.  In Anypoint Studio, create a Mule project.

2.  In the **Mule Palette** view, 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**.

5.  Click **Finish**.

6.  Verify that the `mule-netsuite-connector` dependency version is 12.x in the `pom.xml` file in
    the Mule project.

Studio upgrades the connector automatically.

## Post-Upgrade Steps

After you install the latest version of the connector:

- Remove any `omitInternalIdFromCustomFields` attribute from the NetSuite global configuration in
  your flow XML or Studio settings.

- Update any DataWeave scripts or configuration that references custom field names in the
  `TYPE_SCRIPTID_INTERNALID` format to use the new `TYPE__SCRIPTID` format.

- Confirm that each Mule application using this connector runs on Mule 4.9.0 or later with Java 17.

- Ensure your connector configuration uses **Token-Based Authentication**.

- Verify that error handling still works as expected. See
  [Troubleshooting NetSuite Connector](https://docs.mulesoft.com/netsuite-connector/latest/netsuite-troubleshooting) if you encounter new validation or
  connectivity errors.

## Verify the Upgrade

After you install the latest version of the connector, follow these steps to 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 it is necessary to revert to the previous version of NetSuite Connector, change the
`mule-netsuite-connector` dependency version in the project’s `pom.xml` file to the previous
version.

You must update the project’s `pom.xml` file in Anypoint Studio.

## See Also

- [NetSuite Connector Reference](https://docs.mulesoft.com/netsuite-connector/latest/netsuite-reference)

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [Salesforce Help](https://help.salesforce.com)