mulesoft · issuvarna1 · Apr 22, 2026 · Apr 22, 2026 · Apr 23, 2026 · Apr 23, 2026
@@ -1,5 +1,4 @@
 = NetSuite Connector 11.11
-:page-aliases: connectors::netsuite/netsuite-about.adoc
 
 
 Anypoint Connector for NetSuite (NetSuite Connector) synchronizes data and automates business processes between NetSuite and third-party applications, either on-premises or in the cloud. NetSuite provides cloud-based business management software that helps companies manage core business processes, ERP financials, CRM, e-commerce, inventory, and more.

@@ -1,5 +1,4 @@
 = Upgrading and Migrating to NetSuite Connector 11.x
-:page-aliases: connectors::netsuite/netsuite-connector-upgrade-migrate.adoc
 
 Upgrade NetSuite Connector to version 11.x to use the new features.
 

@@ -1,5 +1,4 @@
 = NetSuite Connector 11.11 XML and Maven Support 
-:page-aliases: connectors::netsuite/netsuite-connector-xml-maven.adoc
 
 Although you can manually code a Mule app in XML, it is more efficient to use Anypoint Studio:
 

@@ -1,5 +1,4 @@
 = NetSuite Connector 11.11 Examples 
-:page-aliases: connectors::netsuite/netsuite-examples.adoc
 
 
 The following examples show how to perform searches in Anypoint Connector for NetSuite (NetSuite Connector):

@@ -1,5 +1,4 @@
 = NetSuite Connector 11.11 Reference 
-:page-aliases: connectors::netsuite-connector-reference.adoc, connectors::netsuite/netsuite-reference.adoc
 
 
 

@@ -1,5 +1,4 @@
 = Using Anypoint Studio to Configure NetSuite Connector 11.11 
-:page-aliases: connectors::netsuite/netsuite-studio-configure.adoc, connectors::netsuite/netsuite-to-use-design-center.adoc
 
 Anypoint Studio (Studio) editors help you design and update your Mule applications, properties, and configuration files.
 

@@ -1,5 +1,4 @@
 = NetSuite Connector 11.11 Troubleshooting 
-:page-aliases: connectors::netsuite/netsuite-troubleshooting.adoc
 
 You might encounter the following issues when working with the Anypoint Connector for NetSuite (NetSuite Connector):
 

@@ -0,0 +1,18 @@
+name: netsuite-connector
+version: '12.0'
+display_version: 12.0 (Mule 4)
+title: NetSuite Connector
+nav:
+- modules/ROOT/nav.adoc
+asciidoc:
+  attributes:
+    page-component-desc: Synchronizes data and automates business processes between NetSuite and third party applications, either on-premise or in the cloud.
+    page-connector-type: Connector
+    page-connector-level: Select
+    page-exchange-group-id: com.mulesoft.connectors
+    page-exchange-asset-id: mule-netsuite-connector
+    page-runtime-version: 4.9.0
+    page-release-notes-page: release-notes::connector/netsuite-connector-release-notes-mule-4.adoc
+    page-vendor-name: netsuite
+    page-vendor-title: NetSuite
+    page-notice-banner-message: Standard support for Java 8 and 11 ends in August 2026 for 4.6 LTS. Plan your upgrade path for apps that are running on Java 8 or 11 accordingly.
@@ -0,0 +1,8 @@
+.xref:index.adoc[NetSuite Connector]
+* xref:index.adoc[NetSuite Connector Overview]
+* xref:netsuite-connector-upgrade-migrate.adoc[Upgrading and Migrating NetSuite Connector]
+* xref:netsuite-studio-configure.adoc[Using Anypoint Studio to Configure NetSuite Connector]
+* xref:netsuite-connector-xml-maven.adoc[NetSuite Connector XML and Maven Support]
+* xref:netsuite-examples.adoc[NetSuite Connector Examples]
+* xref:netsuite-troubleshooting.adoc[Troubleshooting NetSuite Connector]
+* xref:netsuite-reference.adoc[NetSuite Connector Reference]
@@ -0,0 +1,69 @@
+= NetSuite Connector 12.0
+:page-aliases: connectors::netsuite/netsuite-about.adoc
+
+
+Anypoint Connector for NetSuite (NetSuite Connector) synchronizes data and automates business processes between NetSuite and third-party applications, either on-premises or in the cloud. NetSuite provides cloud-based business management software that helps companies manage core business processes, ERP financials, CRM, e-commerce, inventory, and more.
+
+NetSuite Connector provides the following features:
+
+* SOAP-based integration
++
+NetSuite Connector 11.0 and later does not support REST-based operations.
+* Generation of NetSuite business objects
+* Different authentication levels
+* Error-handling support
+
+For compatibility information and fixed issues, see the xref:release-notes::connector/netsuite-connector-release-notes-mule-4.adoc[NetSuite Connector Release Notes].
+
+== Before You Begin
+
+To use this connector, you must be familiar with:
+
+* The NetSuite API
+* Anypoint connectors
+* Mule runtime engine (Mule)
+* Elements and global elements in a Mule flow
+* Creating a Mule app using Anypoint Studio or Anypoint Code Builder
+
+Before creating an app, you must have:
+
+* Credentials to access NetSuite Web Services
+* Anypoint Studio version 7.21 or later
+
+== Common Use Cases for the Connector
+
+* Quote-to-Cash
++
+Improve cash flow, remove manual order entries, and minimize order errors by leveraging realtime integrations to connect and synchronize data about your customer’s intent to buy from your CRM application, such as Salesforce, into its realization of revenue in NetSuite ERP.
++
+* Invoice-to-Reconciliation
++
+Automate your Accounts Receivable (A/R) process by automatically applying bank payments against invoices in NetSuite for real-time A/R processing. Streamline accounts payable by automating payment file transfers between NetSuite and your banks.
++
+* Hire-to-Retire
++
+Build a single view of your employees with realtime synchronization of employee information between Netsuite and your Human Capital Management (HCM) services, such as Workday, Oracle HCM, PeopleSoft, and so on. Automatically trigger employee onboarding processes such as ordering computer equipment, uniforms, system access setup, and so on, while reversing the process upon retirement.
+
+== Authentication types
+
+NetSuite connections use token-based authentication, which uses either a consumer key and token ID or secret pairs to authenticate.
+
+For information about configuring this authentication type, see xref:netsuite-studio-configure.adoc[Using Anypoint Studio to Configure NetSuite Connector].
+
+== Using Exchange Templates and Examples
+
+https://www.mulesoft.com/exchange/[Anypoint Exchange] provides the following templates
+that you can use as starting points for your apps:
+
+* https://www.mulesoft.com/exchange/org.mule.examples/get-customer-list-from-netsuite/[Retrieve a List of Customers from NetSuite]
+* https://www.mulesoft.com/exchange/org.mule.templates/template-sfdc2nets-opportunity-aggregation/[Salesforce and NetSuite Opportunity Aggrgation]
+
+== Next Step
+
+After you complete the prerequisites, you are ready to create your own app and configure the connector using xref:netsuite-studio-configure.adoc[Anypoint Studio].
+
+== See Also
+
+* xref:connectors::introduction/introduction-to-anypoint-connectors.adoc[Introduction to Anypoint Connectors]
+* xref:connectors::introduction/intro-use-exchange.adoc[Use Exchange to Discover Connectors, Templates, and Examples]
+* https://help.salesforce.com[Salesforce Help]
@@ -0,0 +1,83 @@
+= Upgrading and Migrating NetSuite Connector to Version 12.x
+:page-aliases: connectors::netsuite/netsuite-connector-upgrade-migrate.adoc
+
+Upgrade Anypoint Connector for NetSuite (NetSuite Connector) to version 12.x.
+
+== Supported Upgrade Paths
+
+[%header,"cols=50a,50a"]
+|===
+|From Version | To Version
+|11.x |12.x
+|===
+
+== 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:
+
+[%header%autowidth.spread]
+|===
+|Application/Service |Version
+|Mule |4.9.0 and later
+|Java |17
+|===
+
+== 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:
+
+. In Anypoint Studio, create a Mule project.
+. In the *Mule Palette* view, click *Search in Exchange*.
+. In *Add Dependencies to Project*, enter `netsuite` in the search field.
+. In *Available modules*, select *NetSuite* and click *Add*.
+. Click *Finish*.
+. 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 xref:netsuite-troubleshooting.adoc[Troubleshooting NetSuite Connector] 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:
+
+. In Studio, verify that there are no errors in the *Problems* or *Console* views.
+. Verify that there are no problems in the project `pom.xml` file.
+. 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
+
+* xref:netsuite-reference.adoc[NetSuite Connector Reference]
+* xref:connectors::introduction/introduction-to-anypoint-connectors.adoc[Introduction to Anypoint Connectors]
+* https://help.salesforce.com[Salesforce Help]
@@ -0,0 +1,75 @@
+= NetSuite Connector 12.0 XML and Maven Support 
+:page-aliases: connectors::netsuite/netsuite-connector-xml-maven.adoc
+
+Although you can manually code a Mule app in XML, it is more efficient to use Anypoint Studio:
+
+If you manually code a Mule runtime engine (Mule) app in XML, either from the Anypoint Studio XML editor or from a text editor, you can access the connector from your app by adding reference statements to both your XML Mule flow and the Apache Maven `pom.xml` file.
+
+If you add the connector in Studio, Studio automatically populates the XML code with the connector's namespace and schema location and it also adds a dependency to the `pom.xml` file.
+
+== Add a Namespace for the Connector
+
+Paste the following code inside the `mule` tag of the header of your configuration XML:
+
+[source,xml,linenums]
+----
+http://www.mulesoft.org/schema/mule/netsuite
+http://www.mulesoft.org/schema/mule/netsuite/current/mule-netsuite.xsd
+----
+
+This example shows how the namespace statements are placed in the `<mule>` XML block:
+
+[source,xml,linenums]
+----
+<mule xmlns:netsuite="http://www.mulesoft.org/schema/mule/netsuite"
+	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
+	xmlns:http="http://www.mulesoft.org/schema/mule/http"
+	xmlns:file="http://www.mulesoft.org/schema/mule/file"
+	xmlns="http://www.mulesoft.org/schema/mule/core"
+	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
+	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
+	http://www.mulesoft.org/schema/mule/file
+	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
+	http://www.mulesoft.org/schema/mule/http
+	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
+	http://www.mulesoft.org/schema/mule/ee/core
+	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
+	http://www.mulesoft.org/schema/mule/netsuite
+	http://www.mulesoft.org/schema/mule/netsuite/current/mule-netsuite.xsd">
+----
+
+
+== Add a POM File Dependency
+
+The Apache Maven `pom.xml` file generated by Anypoint Studio contains dependencies for a Mule app. If you code a Mule app manually, include this XML snippet in your `pom.xml` file to enable access to this connector:
+
+[source,xml,linenums]
+----
+<dependency>
+  <groupId>com.mulesoft.connectors</groupId>
+  <artifactId>mule-netsuite-connector</artifactId>
+  <version>x.x.x</version>
+  <classifier>mule-plugin</classifier>
+</dependency>
+----
+
+Replace `x.x.x` with the version that corresponds to the connector you are using.
+
+To obtain the most up-to-date `pom.xml` file information:
+
+. Go to https://www.mulesoft.com/exchange/[Anypoint Exchange].
+. In Exchange, click *Login* and supply your Anypoint Platform username and password.
+. In Exchange, search for `netsuite`.
+. Select the connector.
+. Click *Dependency Snippets* near the upper right of the screen.
+
+== Next Step
+
+After completing your namespace and `pom.xml` file, you can try the xref:netsuite-examples.adoc[NetSuite examples].
+
+== See Also
+
+* xref:connectors::introduction/introduction-to-anypoint-connectors.adoc[Introduction to Anypoint Connectors]
+* https://help.salesforce.com[Salesforce Help]
Original file line number	Diff line number	Diff line change
		@@ -1,5 +1,4 @@
		= NetSuite Connector 11.11 Reference
		:page-aliases: connectors::netsuite-connector-reference.adoc, connectors::netsuite/netsuite-reference.adoc



Expand Down