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=”” rel=”noopener noreferrer” target=”_blank”>http://www.w3.org/2003/XMLSchema-instance”>
- Update the version to match the latest supported version. See Upgrading WSDL Versions