NetSuite Connector Upgrade Process

Changes in your various NetSuite application accounts, such as updated user information (new tokens or key, etc) will require an update to your existing Connector Projects. Another possible reason to update is when the  WSDL version used while creating the connector is 15 or more versions older than the NetSuite instance/release version (message shown below). This requirement is mentioned in the official NetSuite article Support for Existing WSDL Versions. These are just two possible examples of when a Connector requires an update.

NetSuite Instance/Release Version 

Another scenario that requires Connector updating is when the WSDL version used to create your NetSuite Connector is 15 or more versions older than the NetSuite instance/release version. (This requirement is detailed in the NetSuite article Support for Existing WSDL Versions).

• Please follow the steps in the NetSuite article Finding Your NetSuite Release Version to locate your NetSuite instance/release version.

• To determine the current WSDL version set in the NetSuite connector vault, follow these steps:

  • Log into CIC.

  • Navigate to Network > Endpoints and click on the NetSuite vault for the WSDL version you wish to  verify (see below).
    
    This will display the endpoint information, in which the current WSDL version can be found (shown below).
    
    
    

• It is recommended to keep the WSDL version as close as possible to the NetSuite instance/release version.
• Before updating the Connector to change the WSDL version, please refer to the Known API Changes Across WSDL Versions section of this article to mitigate any impact on existing integration flows.

Generally, it is good practice to update your Connector Projects occasionally.

Steps

Take these steps to update Connector Projects.

1. From the main menu, select Cloud Connector Update.

   

2. Browse for and select the existing NetSuite Connector Project you want to be updated. Alternatively, you can right-click on the NetSuite Connector Project in your main menu and select Cloud Connector Update…

   

3. Follow the wizard and edit/provide your NetSuite Login information if prompted, and then press Finish when complete. Refer to Prerequisites - NetSuite to understand what NetSuite login information is required to update the NetSuite Connector.

4. If the WSDL version was updated in the wizard, select the Recreate Connector Objects checkbox. The checkbox should be left unchecked if there was no change in the WSDL version from the previous Connector (and only login information such as account number or tokens were changed in the wizard).

5. Certify all details and then click Finish to complete the update process.

Known API Changes Across WSDL Versions

APIs are bound to change across WSDL versions, and the users need to be aware of such changes to avoid any impact on existing integration flows. Some known changes are listed below.
Note: This is not an exhaustive list.

Starting WSDL version 2020 (and above), the following API changes are to be noted:

• Deprecated APIs
  • Login
  • Logout
  • MapSso
  • SsoLogin
  • SearchNext
  • SearchMore
• New APIs
  • GetIntegrationGovenanceInfo
  • GetAccountGovenanceInfo
• Changed APIs
  • GetPostingTransactionSummary - Requires the additional field: OperationID

Frequently Asked Questions

Q. Will I see a difference once the upgraded connector is available?
Yes, some differences will be introduced in the upgraded NetSuite Connector.  These include:

• Schema changes: In the new version of an API, if any Schema field being used in an existing integration is removed, then the associated Business Process will require updating to use alternative fields.
• API changes: If an API being used in an existing Business Process is deprecated, then the respective Business Process will not be available in the upgraded Connector. An alternative Business Process must be used to enable the required integration flows.