sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to manage various resources, including Credit Notes. Specifically, the "Reset Status To Open" operation for the Credit Note resource allows users to change the status of a credit note back to "open." This can be useful in scenarios where a credit note was previously closed or finalized but needs to be reopened for further editing or processing.

Practical examples include:

  • Reopening a credit note that was mistakenly marked as completed.
  • Adjusting financial documents during audits or corrections.
  • Managing workflows where credit notes need to be reactivated after review.

Properties

Name Meaning
Credit Note ID The unique identifier of the credit note whose status you want to reset to "open". This is a required string input.

Output

The node outputs JSON data representing the result of the "Reset Status To Open" operation on the specified credit note. The exact structure depends on the sevDesk API response but typically includes details about the updated credit note status and related metadata.

If an error occurs during execution (e.g., invalid ID or API failure), the output will contain an error field with the error message.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the sevDesk API via an API key credential configured in n8n.
  • The node uses the base URL https://my.sevdesk.de/api/ combined with the API version specified in credentials.
  • Proper environment configuration validation is performed before execution.

Troubleshooting

  • Common Issues:

    • Invalid or missing Credit Note ID: Ensure the provided ID corresponds to an existing credit note in sevDesk.
    • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
    • Network or API downtime: Check sevDesk service status if requests fail unexpectedly.
  • Error Messages:

    • Errors returned from the API are captured and included in the output under an error property.
    • If the node is set to continue on failure, it will return error details per item; otherwise, it will throw and stop execution.

Links and References

Discussion