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. Extra incoming parameters are rejected, and any non-configured output parameters are excluded from the response.
• False: The system can process any external request, regardless of the configured parameters, but still enforces validation rules applied to the parameters.
• 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 WSDLs in Qntrl   

How to make a SOAP WSDL Request

Method: GET

URL Format: https://core.qntrl.com/webservice/soap/<ZSOID>/<source_endpoint>?WSDL

Authentication: Include necessary authentication details in the request header (e.g., API key, OAuth, or basic authentication).

How to Send a SOAP Message Request  

Method: POST

URL Format: https://core.qntrl.com/webservice/soap/<ZSOID>/<source_endpoint>

Authentication: Include necessary authentication details in the request header (e.g., API key, OAuth, or basic authentication).

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:Username>
    </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>