sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API, specifically allowing users to manage invoices among other resources. The "Cancel Invoice" operation enables users to cancel an existing invoice by providing its unique identifier. This is useful in scenarios where an invoice was issued incorrectly or needs to be voided due to changes in billing or order status.

Practical examples include:

  • Automatically cancelling invoices when an order is refunded.
  • Voiding invoices that were created by mistake during data entry.
  • Integrating with accounting workflows to keep invoice statuses up-to-date.

Properties

Name Meaning
Invoice ID ID of the invoice to be cancelled

Output

The node outputs JSON data representing the response from the sevDesk API after attempting to cancel the specified invoice. This typically includes confirmation of the cancellation status and any relevant metadata about the invoice. There is no indication that binary data is output by this operation.

Dependencies

  • Requires an active connection to the sevDesk API.
  • Users must provide valid API authentication credentials (an API key or token) configured within n8n.
  • The base URL for API requests is https://my.sevdesk.de/api/v1/.

Troubleshooting

  • Invalid Invoice ID: If the provided invoice ID does not exist or is incorrect, the API may return an error indicating the invoice could not be found. Verify the invoice ID before running the node.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Ensure the API key/token is correctly set up in n8n credentials.
  • Network Issues: Connectivity problems can prevent the node from reaching the sevDesk API. Check network settings and firewall rules.
  • Permission Denied: The API user associated with the credentials might lack permissions to cancel invoices. Confirm appropriate access rights in sevDesk.

Links and References

Discussion