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 Download PDF operation, it allows users to download a PDF document related to an order by providing the Order ID. This is useful in scenarios where you want to programmatically retrieve invoices, order confirmations, or other order-related documents in PDF format directly from sevDesk.

Practical examples include:

  • Automatically downloading and storing order PDFs for record-keeping.
  • Sending order PDFs as email attachments in automated workflows.
  • Archiving order documents in external storage systems.

Properties

Name Meaning
Order ID The unique identifier of the order for which the PDF should be downloaded. This is required.

Output

The node outputs JSON data representing the result of the PDF download operation. While the exact structure depends on the API response, typically it will contain metadata about the PDF or a link to the PDF file.

If the node supports binary data output (common for PDF downloads), the binary data field will contain the actual PDF file content, allowing further processing such as saving to disk or sending via email.

Dependencies

  • Requires an active connection to the sevDesk API using an API key credential.
  • The node expects the API version to be configured as part of the credentials or environment settings.
  • No additional external dependencies are needed beyond the sevDesk API access.

Troubleshooting

  • Common issues:

    • Invalid or missing Order ID: Ensure the Order ID provided exists and is correctly formatted.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network or API downtime: Check network connectivity and sevDesk service status.
  • Error messages:

    • Errors returned from the API will be captured and can appear in the output JSON under an error field if "Continue On Fail" is enabled.
    • Common error messages might include "Order not found" or "Unauthorized access," indicating either a wrong Order ID or invalid credentials.

Links and References

Discussion