SOAP Node (DSmart)

Make SOAP web service requests with authentication for DSmart services

Actions17

GetPaymentCancel

AI-generated

Overview

This node enables making authenticated SOAP web service requests specifically for DSmart services. It supports multiple predefined operations related to banking and payment systems, such as retrieving payment cancellations, invoices, direct debit information, and managing payments or cancellations.

For the GetPaymentCancel operation, the node fetches details about canceled payments by sending a SOAP request with relevant parameters like bank code, subscriber number, and invoice number. This is useful in financial workflows where you need to verify or audit payment cancellation statuses from the DSmart payment system.

Practical example:
You can use this node to automatically check if a particular invoice payment has been canceled before proceeding with further processing or notifications in your workflow.

Properties

Name Meaning
SOAP Service URL The URL of the SOAP web service endpoint to which requests are sent. Default is the DSmart online payment system WSDL URL.
Input Mode Choose how to send the SOAP request: either by specifying parameters that get inserted into a predefined SOAP envelope ("Parameters") or by providing a fully custom SOAP XML envelope ("Custom SOAP Envelope").
Parameters When using "Parameters" input mode, this collection allows setting various parameters including:
- Extra Variables (custom name-value pairs)
- Invoice ID (string)
- Opbel (number)
- TCKN (string)
- Vkont (string)
- Year (number)
Authentication Source 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}}, {{password}}, and N8N expressions.

Output

The node outputs an array of JSON objects, each corresponding to an input item processed. Each output object contains:

  • response: The parsed SOAP response body specific to the called operation, extracted from the SOAP envelope.
  • rawResponse: The raw XML string returned by the SOAP service.
  • statusCode: HTTP status code of the SOAP response.
  • statusText: HTTP status text of the SOAP response.

If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message and any available HTTP response details.

No binary data output is produced by this node.

Dependencies

  • Requires access to the DSmart SOAP web service endpoint (default URL provided).
  • Needs valid authentication credentials (username and password) either via stored credentials or manual input.
  • Uses the axios library for HTTP requests.
  • Uses the xml2js library to parse XML SOAP responses.

Troubleshooting

  • Authentication errors: Ensure correct username and password are provided. If using stored credentials, verify they are correctly configured.
  • Timeouts or network errors: Check network connectivity to the SOAP service URL and ensure the service is reachable.
  • Invalid SOAP envelope or parameters: When using custom envelopes, ensure the XML is well-formed and all required variables are properly replaced.
  • Parsing errors: If the SOAP response structure changes or is unexpected, parsing may fail or return incomplete data.
  • Common error messages:
    • HTTP 401 Unauthorized: Invalid credentials.
    • HTTP 404 Not Found: Incorrect SOAP service URL.
    • XML parsing errors: Malformed SOAP response or unexpected format.

To resolve these, verify configuration settings, credentials, and SOAP envelope correctness.

Links and References

Discussion