NetSuite periodically updates its WSDL (Web Services Description Language) file with new features, fields, and schema changes. If you’re using SuiteTalk SOAP Web Services, you need to update your integration when NetSuite releases a new version.
1. Check the Current WSDL Version
To verify the currently used WSDL version:
- Go to:
Setup > Integration > Web Services Preferences - Check the Version Number (e.g.,
2024_1,2023_2, etc.). - Compare it with your integration’s existing WSDL version.
2. Download the Latest WSDL
To update your SOAP integration:
- Navigate to:
Setup > Integration > SOAP Web Services Preferences
- Click on “Download WSDL” to get the latest schema.
URL Format for WSDL Download:
You can also directly access the WSDL using:
https://webservices.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl
(Change 2024_1_0 to the required version.)
3. Update Your Integration with the New WSDL
- If using Java or .NET, regenerate SOAP client stubs using:
- Java: Use
wsimport
wsimport -keep -p com.netsuite.soap https://webservices.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl
- .NET (C#): Use
svcutil
svcutil.exe https://webservices.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl
- For PHP, update the
SoapClientobject with the new WSDL:
$client = new SoapClient('https://webservices.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl');
- For Python (Zeep):
client = Client('https://webservices.netsuite.com/wsdl/v2024_1_0/netsuite.wsdl')
4. Handle Schema Changes
Check for Deprecated or Modified Fields
- NetSuite occasionally removes or renames fields.
- Compare your integration’s field usage with the SOAP Schema Browser:
https://www.netsuite.com/help- Go to Web Services Schema Browser for your version.
Update Field References in Code
- If a field is removed, find its replacement.
- If a new mandatory field is introduced, update your payloads.