Testing SOAP Web Services Integrations in NetSuite

TL;DR: This article provides best practices for testing SOAP web services integrations in NetSuite, highlighting the importance of correct domain usage and SOAP endpoint support.

Understanding SOAP Web Services Integrations

Testing SOAP web services integrations is crucial for ensuring that your NetSuite account communicates correctly with external systems. Proper testing can help identify integration issues early on, leading to smoother operations and increased reliability.

Accessing Your Release Preview Account

To access your Release Preview environment through SOAP web services, use specific account URLs that are structured based on your account ID. Each account has a distinctive domain that reflects its type, whether it’s a production, sandbox, or Release Preview account. Remember that attempting to construct an account-specific domain manually is discouraged; you should always use the URLs as listed in your Company Information page under the Company URLs subtab.

Key Points About Account-Specific Domains

• Each account type has a unique domain which does not change even if the account is moved to a different data center.
• To view your account-specific domains, navigate to Setup > Company > Company Information, then click the Company URLs subtab.

Important Considerations

• Do Not Use Certificate Pinning: NetSuite certificates can change without notice. Use of certificate pinning may result in access issues when certificates are updated.
• Ensure that your external client is configured to send requests using the correct domain name for your specific account type, as incorrect domains will lead to integration failures.

Planning Your Testing Strategy

When preparing to test your SOAP integrations, consider developing a structured test plan that includes the following components:

• Define goals: Clarify what you're trying to achieve with the integration testing.
• Identify scenarios: Outline the key scenarios you need to test for effective integration.
• Validate responses: Ensure that your SOAP requests return the expected results, particularly at the boundaries of normal operations.

SOAP Version Support

As of the latest updates, keep in mind that NetSuite supports SOAP web services versions for a limited time, with the most recent version being crucial for ongoing integrations. Familiarize yourself with the timeline for SOAP web services deprecation to avoid future disruptions, particularly the planned discontinuation of SOAP in 2028.2. New integrations should focus on transitioning to SuiteTalk REST web services combined with OAuth 2.0 for security.

Who This Affects

• Developers and Integrators: Those responsible for implementing and maintaining integrations with SOAP web services.
• NetSuite Administrators: Professionals managing the NetSuite environment and user access related to integrations.

Key Takeaways

• Use account-specific domains for SOAP web services correctly to avoid connection issues.
• Do not implement certificate pinning in your integrations.
• Stay updated on SOAP version support and begin planning transitions to REST solutions.
• Test integrations thoroughly using structured testing plans to improve reliability.