SOAP Web Services Overview and Migration to REST

What Are SOAP Web Services in NetSuite?

The SOAP web services platform in NetSuite provides access to your NetSuite data and business processes through an XML-based API. This technology supports various operations of integration and is crucial for developers working with legacy systems.

Key Features of SOAP Web Services

• SOAP Encoded Web Services: Utilizes SOAP-based protocols for web services operations.
• Integration Management: Handles record types, fields, and forms for seamless data management.
• Error Handling: Provides response codes and error handling mechanisms to ensure smooth operations.
• PHP Toolkit: An available toolkit for PHP developers to create applications that use SOAP web services.

Transition to REST Web Services

Oracle has announced the scheduled removal of SOAP web services in a phased approach, aligning with their focus on modernizing integration methods. The 2025.2 SOAP endpoint will be the last one available, with complete deprecation expected by the 2028.2 release. It’s crucial for developers and organizations to migrate to SuiteTalk REST web services, which are designed to handle more modern integration needs with improved security models, including OAuth 2.0 for authentication.

Steps to Prepare for Migration

• Assess Current Integrations: Review any existing SOAP integrations to gauge the impact of the transition.
• Use REST for New Applications: Always opt for REST web services when building new integration solutions.
• Consult Partners: If you use third-party products, ensure they transition to REST-based applications.

Migration Resources

To help facilitate this transition, resources such as the SOAP Web Services to REST Web Services Upgrade Guide are available, which provide detailed steps for migrating existing applications to the new architecture.

Who This Affects

• Developers: Those involved in building integrations should focus on transitioning to REST immediately.
• System Administrators: Responsible for ensuring that all integrations are updated and compliant with the new standards.
• Project Managers: Need to plan for the replacement of SOAP with REST in ongoing and future projects.

Key Takeaways

• The phased removal of SOAP web services marks a significant shift towards modern integration strategies with REST.
• The 2025.2 endpoint will be the last supported SOAP endpoint, with full retirement anticipated by 2028.2.
• Transitioning to REST ensures continued functionality and leveraging of advanced security features.
• Resources are available to assist in planning migration strategies.

Source: This article is based on Oracle's official NetSuite documentation.