sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to manage various resources, including Credit Notes. Specifically, the Delete operation for the Credit Note resource allows users to remove a credit note from their sevDesk account by specifying its unique ID. This is useful in scenarios where a credit note was created in error or is no longer needed.

Practical examples:

  • Automatically deleting credit notes that were voided or canceled in an external system.
  • Cleaning up test or duplicate credit notes during data synchronization workflows.

Properties

Name Meaning
Credit Note ID The unique identifier of the credit note to delete. This is a required string property.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will include confirmation of deletion or any relevant response from the sevDesk API. If an error occurs, the output JSON will contain an error field with the error message.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the sevDesk API via an API key credential.
  • The node uses the base URL https://my.sevdesk.de/api/ combined with the configured API version.
  • Environment configuration validation is performed before execution to ensure proper setup.

Troubleshooting

  • Common issues:

    • Invalid or missing Credit Note ID will cause the API call to fail.
    • Network connectivity problems or incorrect API credentials can prevent successful deletion.
    • Attempting to delete a credit note that does not exist or has already been deleted may return an error.
  • Error messages and resolutions:

    • "error": "Credit Note not found": Verify the Credit Note ID is correct and exists in sevDesk.
    • Authentication errors: Check that the API key credential is valid and has sufficient permissions.
    • Validation warnings on environment config: Ensure all required environment variables and configurations are properly set.

Links and References

Discussion