SOAP Node (DSmart)

Make SOAP web service requests with authentication for DSmart services

Actions17

ReturnLink

AI-generated

Overview

This node enables making authenticated SOAP web service requests specifically for DSmart services. It supports various predefined SOAP operations related to banking, payments, direct debits, invoices, and agreements, as well as a custom SOAP envelope mode for flexibility.

A common use case is integrating with the DSmart online payment system to retrieve or update financial data such as bank agreements, invoice details, payment statuses, or direct debit information. For example, you can use it to fetch a return link for payment processing or to submit payment cancellation requests.

The "ReturnLink" operation (the focus here) retrieves a return URL from the DSmart SOAP service, which can be used in workflows that require redirecting users after payment or transaction completion.

Properties

Name Meaning
SOAP Service URL The URL of the SOAP web service endpoint to send requests to. Default is the DSmart Online Payment System WSDL URL.
Input Mode Choose how to send the SOAP request: either by specifying parameters (which are inserted into predefined SOAP templates) or by providing a fully custom SOAP envelope XML.
Parameters When using "Parameters" input mode, this collection allows setting specific fields such as Invoice ID, Opbel (operation number), TCKN (Turkish ID number), Vkont (contract number), Year, and extra template variables.
Authentication Source Select how to provide authentication credentials: either use stored API credentials or enter username and password manually.
Authentication If manual authentication is selected, specify the username and password here.
SOAP Envelope When using "Custom SOAP Envelope" input mode, provide the full SOAP XML envelope here. Supports variable placeholders like {{username}}, N8N expressions, and credential field references.

Output

The node outputs an array of items where each item contains:

  • json.response: The parsed SOAP response body relevant to the requested operation, typically extracted from the <OperationName>Result element.
  • json.rawResponse: The raw XML response string returned by the SOAP service.
  • json.statusCode: HTTP status code of the SOAP response.
  • json.statusText: HTTP status text of the SOAP response.

No binary data output is produced by this node.

Dependencies

  • Requires access to the DSmart SOAP web service endpoint.
  • Needs valid authentication credentials (either via stored credentials or manual input).
  • Uses the axios library for HTTP requests.
  • Uses the xml2js library to parse XML responses into JSON.
  • No special environment variables are required beyond standard n8n credential management.

Troubleshooting

  • Authentication errors: If the SOAP service returns authentication failures, verify that the username and password are correct and properly provided either via credentials or manual input.
  • Timeouts or network errors: The node uses a 30-second timeout; ensure the SOAP service URL is reachable and responsive.
  • Malformed SOAP envelope: When using custom envelopes, ensure the XML is well-formed and all required placeholders are correctly replaced.
  • Unexpected response structure: If the node cannot find the expected response elements, check if the SOAP action matches the operation and that the service URL is correct.
  • Continue on Fail: If enabled, the node will output error details instead of stopping execution, useful for debugging batch requests.

Links and References

Discussion