Creating an Inbound SOAP Web Service   

To create an inbound SOAP web service in Qntrl:

1. Navigate to(settings)  >> WEB SERVICES >> Inbound >> Select SOAP. 

• Name: Provide a unique name for the SOAP service.
• Source Endpoint: The endpoint URL that will be used to interact with your SOAP service.
• Operation: The operation the service will perform. Default: execute.
• Resource: Choose an existing function or create a new one to define the actions for the SOAP service. Only SOAP-type functions will be shown in the list. If you create a new function, write the script in the editor. The function will automatically appear in the function module with a generated name, which you can change later.
• Authentication Type: Choose the authentication type for the API call. Qntrl supports three authentication types:
• OAuth
• API Key
• Basic Authentication (username and password encoded in Base64 and sent in headers).
• Mandate WSDL Compliance: Select the option to enable WSDL compliance.

• True

• Only the configured request and response parameters are allowed. Any extra parameters in the incoming request will be rejected.

• Non-configured output parameters will be excluded from the response.

• The operation name in the request must exactly match the one defined in the WSDL — otherwise, the request will fail.

• False

• The system accepts any external request, even if it contains parameters not defined in the WSDL.

• However, it still applies validation rules to the parameters you have configured.

• Request Params: Define the parameters to be passed in the request.
• Param Name: Define the name of the input parameter.
• Type: Select the data type.
• Allowed Regex: Set restrictions for the parameter values.
• Min Length: Define the minimum length of the input.
• Max Length: Define the maximum length of the input.
• Default Value: Set default values for parameters.
• Mandatory: Specify whether the parameter is mandatory. If a mandatory parameter is missing, an error will occur.
• Response Params  
• Name: Define the name of the output parameter.
• Mandatory: Set whether this parameter is required in the response.

Validation ensures incoming requests meet the expected format. If validation fails, the request will be rejected.

      

Processing Requests and Responses 

• Use the soapRequest object to process incoming requests based on the configured parameters and operations.

• The soapResponse object allows you to customize the response, setting the required output parameters based on the request.

• In case of an error, use the setFault method to define error codes and messages, which will be communicated back to the client.

Calling and Processing WSDL in Qntrl   

How to make a SOAP WSDL Request

Method: Any HTTP method (e.g., GET)

URL: https://core.qntrl.com/webservice/soap/<org-id>/<source_endpoint>?WSDL

Authentication (must be added in the request header):

• OAuth Token
• Header Format: Authorization: Zoho-oauthtoken <access_token>
• Required OAuth Scopes: ws_soapinbound.UPDATE
• API Key  
• Header Format: Authorization: Bearer <api_key>
• Basic Authentication
• Authorization: Basic <base64-encoded username:password>

How to Send a SOAP Message Request  

Method: Any HTTP method (e.g., POST)

URL: https://core.qntrl.com/webservice/soap/<org-id>/<source_endpoint>

Authentication (must be added in the request header):

• OAuth Token

• Header Format: Authorization: Zoho-oauthtoken <access_token>

• Required OAuth Scopes: ws_soapinbound.UPDATE

• API Key  

• Header Format: Authorization: Bearer <api_key>

• Basic Authentication

• Authorization: Basic <base64-encoded username:password>

Body: The body should contain the raw XML request data.

 

<soapenv:Envelope 
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:ord="https://98173384.core.localqntrlhost.com/webservice/98173384/orderManagement">
  
  <soapenv:Header>
    <ord:AuthHeader>
      <ord:companyName>Zoho Corp</ord:companyName>
    </ord:AuthHeader>
  </soapenv:Header>
  
  <soapenv:Body>
    <ord:PlaceOrder>
      <ord:OrderID>12345</ord:OrderID>
      <ord:CustomerID>98765</ord:CustomerID>
      <ord:ProductID>10111</ord:ProductID>
      <ord:Quantity>3</ord:Quantity>
      <ord:OrderDate>2025-03-28</ord:OrderDate>
    </ord:PlaceOrder>
  </soapenv:Body>
  
</soapenv:Envelope>

Other Actions

Enable or Disable a SOAP Request

You can control the activation of individual SOAP requests from the configuration panel:

1. Navigate to(settings)  >> WEB SERVICES >> Inbound >> Select SOAP. 

2. Under the Resources section on the left panel, locate the SOAP message.

3. Use the toggle button next to the message name to enable or disable it.

Delete a SOAP Request

To remove a SOAP request:

1. Navigate to(settings)  >> WEB SERVICES >> Inbound >> Select SOAP. 

2. Select the message you want to delete.

3. Click the delete icon at the top right of the message details page.