Update SOAP Library Version for SuiteCommerce Advanced Compatibility

Before NetSuite 2026.1 is released, you need to update the SOAP library version in your SuiteCommerce Advanced (SCA) environment to avoid issues with your developer tools.

These patch instructions describe how to update an attribute in your SOAP library. If you don’t make this update, you may experience disruptions when you deploy changes with gulp commands in the SCA developer tools.

Important:

This change won’t affect live SuiteCommerce or SCA websites, or extensions. It only affects deployment processes with SCA developer tools.

To avoid problems with your developer tools, make this change after you’ve updated to NetSuite 2025.2 and before NetSuite 2026.1 is released.

To update the version attribute in your SOAP library, follow these steps:

In your local workspace, open the source code folder for the SCA developer tools.

This folder was created when you downloaded and unzipped the source files to set up developer tools.
Go to the correct folder depending on your SCA version:
- For SCA 2019.1 and earlier (not including Denali):
  
  ns_npm_repository\suitetalk4node\src\
- For SCA Denali:
  
  gulp\ns-deploy\suitetalk4node\src
- For SCA 2019.2 to SCA 2024.2:
  
  Commons\ns_npm_repository\suitetalk4node\src\
- For SCA 2025.1:
  
  node_modules\@sc-utils\suitetalk\src
Edit the tool.js file in a text editor.
Find the existing nsVersion attribute and change the value to 2024_2.

For example, change the nsVersion attribute from 2020_2 to 2024_2.
Save and close the file.
Test your environment to ensure that everything is working correctly.

Related Topics