When integrating with NetSuite SOAP Web Services, you may encounter the InvalidVersionFault error. This error occurs when the request message specifies an unsupported or outdated version of the NetSuite schema.
NetSuite regularly updates its Web Services versions, and older versions may become deprecated, requiring integrations to be updated accordingly. Using an incorrect version can lead to compatibility issues, preventing successful communication between your system and NetSuite.
Steps to Resolve the InvalidVersionFault Error
1. Verify the WSDL Version
- Check if you are using a deprecated WSDL version. NetSuite updates its Web Services schema with each new release.
2. Update Your Endpoint URL
- Ensure that your integration is using the correct WSDL endpoint for your NetSuite account.
- The endpoint format is:
- https://<ACCOUNT_ID>.suitetalk.api.netsuite.com/services/NetSuitePort_<VERSION>
- Example for 2023.2:
- https://123456.suitetalk.api.netsuite.com/services/NetSuitePort_2023_2
See SuiteAnswer Article Support for Existing WSDL Versions
3. Modify the SOAP Request Header
- Your SOAP request should specify the correct version in the urn:platformMsgs namespace.
- Example:
- <soapenv:Envelope xmlns:xsd="http://www.w3.org/2003/XMLSchema" xmlns:platformCore="urn:core_2023_2.platform.webservices.netsuite.com" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:platformMsgs="urn:messages_2023_2.platform.webservices.netsuite.com" xmlns:xsi="http://www.w3.org/2003/XMLSchema-instance">
- Update the version to match the latest supported version. See Upgrading WSDL Versions
The sample code described herein is provided on an "as is" basis, without warranty of any kind, to the fullest extent permitted by law. Oracle + NetSuite Inc. does not warrant or guarantee the individual success developers may have in implementing the sample code on their development platforms or in using their own Web server configurations.
Oracle + NetSuite Inc. does not warrant, guarantee or make any representations regarding the use, results of use, accuracy, timeliness or completeness of any data or information relating to the sample code. Oracle + NetSuite Inc. disclaims all warranties, express or implied, and in particular, disclaims all warranties of merchantability, fitness for a particular purpose, and warranties related to the code, or any service or software related thereto.
Oracle + NetSuite Inc. shall not be liable for any direct, indirect, or consequential damages or costs of any type arising out of any action taken by you or others related to the sample code.
How do you manage your WSDL version in your business? Share your approach in NetSuite Admin Corner!