sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to perform operations related to invoices, specifically rendering an invoice document. The "Render Invoice" operation allows users to generate a visual or printable representation of an invoice identified by its ID. This is useful in scenarios where automated generation of invoice PDFs or previews is needed, such as sending invoices to customers, archiving, or further processing in workflows.

Practical examples include:

  • Automatically generating and emailing an invoice PDF after a sale.
  • Creating invoice previews for review before finalizing billing.
  • Archiving rendered invoices in external storage systems.

Properties

Name Meaning
Invoice ID The unique numeric identifier of the invoice resource to render.
Force Reload Boolean option indicating whether to force a re-render of the invoice, bypassing cache.

Output

The node outputs JSON data representing the rendered invoice. This typically includes the invoice content in a format suitable for display or download (e.g., base64 encoded PDF or HTML). If binary data is involved (such as a PDF file), it will be available in the binary output field, allowing subsequent nodes to handle file storage or transmission.

Dependencies

  • Requires an active connection to the sevDesk API via an API key credential.
  • The node configuration must include this API authentication token to access invoice data and rendering endpoints.
  • Network access to https://my.sevdesk.de/api/v1/ is necessary.

Troubleshooting

  • Invalid Invoice ID: If the provided invoice ID does not exist or is incorrect, the node may return an error indicating the resource was not found. Verify the invoice ID is correct.
  • Authentication Errors: Missing or invalid API credentials will cause authorization failures. Ensure the API key is correctly configured.
  • Force Reload Issues: Using the force reload option unnecessarily might increase API load or cause delays; use only when a fresh render is required.
  • API Rate Limits: Frequent rendering requests may hit API rate limits; consider adding delays or batching requests.

Links and References

Discussion