Skip to main content

Mock SOAP Server from WSDL

Beeceptor now allows you to create intelligent SOAP mock servers directly from WSDL specifications, making it easier to develop, test & integrate SOAP-based connections. Beeceptor automatically generates fully structured request and response envelopes, enriched with dynamic test data using modern AI and large language model (LLM) capabilities. You get a fully functional mock server—no coding or additional deployment required.

Whether you're consuming a third-party SOAP API, validating client integrations, or simulating legacy systems, this feature offers a fast, realistic, and customizable mock environment. Beeceptor is compatible with WSDL 1.1, as well as SOAP 1.1 and 1.2 protocols.

Importing WSDL Specifications​

You can start by uploading your WSDL specification in one of two ways:

  • File Upload: Simply drag and drop a .wsdl or .xml file, or browse to select from your local system.
  • URL Input: Alternatively, provide a direct link to your WSDL specification for Beeceptor to fetch it remotely.
info

External imports (such as <import> and <include> elements that reference external files) are currently not supported. This is planned for a future update.

Once uploaded, Beeceptor processes the file in real time and displays live status updates while parsing and generating the mock endpoints. Beeceptor AI engine looks at the request and response envelops and generates contextual test data. In addition to this, it can reuse request envelop parameters and send in the operation's response. This makes your SOAP integration as real as possible and demo worthy.

Inspecting payloads​

The mock server dashboard gives you an organized view of all operations derived from your WSDL specification. This makes it easy to inspect each SOAP operation, including the request and response envelopes, message bindings, and associated ports. For WSDL-powered mock servers, the dashboard automatically lists all available operations parsed from the contract, allowing you to explore without switching contexts or tools.

inspect request and response envelopes for SOAP operations

SOAP Action & Operation Matching​

Once your SOAP mock server is ready, you can begin interacting with it immediately. You can invoke SOAP operations using standard HTTP POST requests and the SOAPAction header. The endpoint automatically matches requests based on multiple factors, including:

  • The SOAP action mentioned in the Content-Type request header
  • The SOAP action value from the SOAPAction request header.
  • WS-Addressing headers (if present)
  • Operation name inside the request envelope
  • The request URL

This multi-layered matching logic ensures compatibility with various client implementations, even those that may not strictly follow the specification.

The mock server also support serving spec definition. You can make a request to the base URL of your mock server with ?wsdl and Beeceptor will respond with original specification for client generation.

Realistic Test Data​

Beeceptor uses Handlebars compatible template engine to generate realistic and dynamic data for response envelops. For example, string fields might contain full names or email addresses, while date fields reflect proper ISO timestamps. This helps simulate real-world usage and improves integration testing.

You also have full control over the generated mocks. The AI generated response is fully specification compliant. If needed, you can override any AI-generated response with a custom payload or manually adjust request templates.

SOAP Fault Handling​

Beeceptor detects and processes fault definitions (<fault> elements) within the WSDL to generate corresponding SOAP fault envelopes. These can be triggered through the UI or as part of a rule, allowing you to simulate various error scenarios such as authentication failures, missing data, or server exceptions.