✅How to identify and fix sudden SOAP integration errors after an upgrade
You may have received a notification from Oracle NetSuite indicating that you are using:
unsupported SOAP web services endpoint versions (versions 2017_2 to 2021_1).
I have seen some clients immediately receive the following error message on their integration logs when their account environment is upgraded to 2024.2 if they were using a 2017_2 SOAP version.
UNSUPPORTED_WS_VERSION SuiteTalk endpoint version 2017_2 is no longer supported.
My understanding is that this is expected behavior for NetSuite to depreciate older versions of the SOAP connection. You can monitor the following page to see the oldest supported versions, but please note that the page has not been updated to include 2024.2 yet, which is the version that has been deployed already to many accounts in fall 2024.
See: Support for Existing WSDL Versions
There are also instructions for updating the WSDL here:
Ideally, your 3rd party integration developer would have preemptively upgraded to support the latest version. But, if you have developed your own integrations in-house or failed to routinely upgrade unmanaged bundles, it is possible your connection version has gone out-of-date.
Here is a rough guide on where to look to identify the offending integration(s) in your environment:
Option 1: Check Integration Records
- Navigate to the menu: Setup > Integration > Manage Integrations
- Click on each integration record
- Click on the execution log tab
- If there are entries under "SOAP Web Services", check the API Version column to see the version number, and also make note of the status and date/time to ensure it is recently used.
- You can also view the request and response links to investigate how this integration is being used.
Option 2: Review recent log entries
- In the global search, search for: SOAP Web Services Usage Log
- You may need to adjust the date range filters if you are not seeing daily integration connections. Specifically, filter to connections made after your upgrade to the latest NetSuite version.
- Depending on how many integrations you have, you may need to filter by integration. You may aso want to sort by number of failed records descending.
- Click on at least 1 of the "Response" links for each integration.
- Open the downloaded results XML file.
- Locate the "messages_" section on the 3rd line:
- The section I have highlighted will show the version number, such s 2017_2 or 2022_1 as above.
- Review each integration's result (one response file per integration should be enough) and then reach out to the corresponding partner to get it upgraded.
