sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to perform various operations on sevDesk resources. Specifically, for the Order resource with the Send By Email operation, it allows users to send an existing order directly via email to a specified recipient. This is useful in scenarios where you want to automate sending order confirmations or invoices to customers without manually exporting and emailing documents.

Practical examples include:

  • Automatically emailing order confirmations to customers after an order is created.
  • Sending updated order details or invoices to clients as part of a workflow.
  • Integrating with CRM or e-commerce platforms to streamline communication.

Properties

Name Meaning
Order ID The unique identifier of the order to be sent by email.
Email The recipient's email address where the order will be sent.
Subject The subject line of the email that will be sent.
Text The body content of the email message.

Output

The node outputs JSON data representing the response from the sevDesk API after attempting to send the order via email. This typically includes confirmation details or error messages related to the email sending process.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with the error message for the failed item.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active sevDesk API key credential configured in n8n.
  • The node depends on the sevDesk API being accessible at https://my.sevdesk.de/api/.
  • Environment configuration validation is performed before execution to ensure required environment variables or settings are correct.

Troubleshooting

  • Common issues:

    • Invalid or missing Order ID: Ensure the Order ID corresponds to an existing order in sevDesk.
    • Incorrect email format: Validate the recipient email address format.
    • API authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
    • Network or API downtime: Check sevDesk service status if requests fail unexpectedly.
  • Error messages:

    • Errors returned from the API will be included in the output JSON under an error field if "Continue On Fail" is enabled.
    • Common error messages might relate to authorization failures, invalid parameters, or server errors.

To resolve errors, verify input parameters, credentials, and network connectivity.

Links and References

Discussion