sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to manage various resources, including Accounting Contacts. Specifically, the "Delete" operation for the AccountingContact resource allows users to remove an existing accounting contact from their sevDesk account. This can be useful for cleaning up outdated or incorrect contact records.

A practical example is when a user wants to delete an accounting contact that is no longer relevant or was created by mistake. However, caution is advised because deleting an Accounting Contact may cause booking errors, especially in DATEV exports, and sevDesk's compatibility with DATEV is not guaranteed after such deletions.

Properties

Name Meaning
Accounting Contact ID Unique identifier (number) of the Accounting Contact to delete. Warning: Deleting this contact can lead to booking errors, particularly in DATEV export scenarios.

Output

The node outputs JSON data representing the response from the sevDesk API after attempting to delete the specified Accounting Contact. Typically, this will include confirmation of deletion or error details if the operation failed.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the sevDesk API.
  • The node needs an API authentication token credential configured in n8n to authorize requests.
  • Internet access to https://my.sevdesk.de/api/v1/ is necessary.

Troubleshooting

  • Common Issues:

    • Attempting to delete an Accounting Contact that does not exist or has already been deleted may result in an error.
    • Deleting contacts linked to financial bookings might cause inconsistencies or errors in accounting exports, especially with DATEV.
    • Insufficient permissions or invalid API credentials will prevent successful deletion.
  • Error Messages:

    • "Not Found" or similar indicates the provided Accounting Contact ID does not exist.
    • "Unauthorized" or "Forbidden" suggests issues with API authentication; verify the API key and permissions.
    • Booking-related errors after deletion indicate that the contact was involved in transactions; review accounting data before deletion.

Links and References

Discussion