sevDesk icon

sevDesk

Consume the sevDesk API

Overview

The node integrates with the sevDesk API to send a credit note by email. It allows users to specify a particular credit note and provide email details such as recipient address, subject, and message text. This operation is useful in scenarios where businesses want to automate sending credit notes directly from their accounting system to customers or clients via email, streamlining communication and record-keeping.

Practical examples include:

  • Automatically emailing a credit note to a customer after it has been issued.
  • Sending reminders or follow-ups with attached credit notes.
  • Integrating with other workflows that trigger email dispatch of financial documents.

Properties

Name Meaning
Credit Note ID The unique identifier of the credit note to be sent by email.
Email Data Collection of email-related fields:
- To Recipient email address(es) for the credit note email.
- Subject Subject line of the email being sent.
- Text Body text content of the email message.

Output

The node outputs an array of JSON objects representing the response from the sevDesk API after attempting to send the credit note by email. Each output item corresponds to one input item processed.

  • The json field contains the API response data, which may include success confirmation or error details.
  • If an error occurs and "Continue On Fail" is enabled, the output will contain an object with an error property describing the failure.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the sevDesk API using a valid API key credential.
  • The node depends on environment configuration validation to ensure proper setup before execution.
  • No additional external services beyond sevDesk are required.

Troubleshooting

  • Common issues:

    • Invalid or missing Credit Note ID can cause the API call to fail.
    • Incorrect or incomplete email data (missing recipient address) may result in errors.
    • Network connectivity problems or invalid API credentials will prevent successful requests.
  • Error messages:

    • Errors returned from the API will be included in the output if "Continue On Fail" is enabled.
    • Typical error messages might indicate authorization failures, resource not found, or validation errors on email fields.
  • Resolution tips:

    • Verify the Credit Note ID exists and is correct.
    • Ensure the email "To" field is properly formatted and not empty.
    • Confirm API credentials are valid and have necessary permissions.
    • Check network connectivity and sevDesk service status.

Links and References

Discussion