sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions41

Overview

This node integrates with the sevDesk API to update an existing Accounting Contact record. It allows users to modify specific fields of an Accounting Contact by specifying its unique identifier and the fields to update. This is useful in scenarios where contact details related to accounting need to be kept current, such as updating debtor or creditor numbers or linking the contact to a different main contact entity.

Practical examples include:

  • Correcting or changing the debtor or creditor number associated with an accounting contact.
  • Associating an accounting contact with a different main contact ID.
  • Maintaining accurate accounting contact data to ensure proper bookkeeping and export compatibility.

Important Note: Updating an existing Accounting Contact can lead to booking errors, especially when exporting data to DATEV (a German accounting software). Compatibility with DATEV is no longer guaranteed after updates, so caution is advised.

Properties

Name Meaning
Accounting Contact ID Unique identifier of the Accounting Contact to update. Required to specify which contact to modify.
Fields to Update Collection of optional fields that can be updated:
- Contact ID Unique identifier of the Contact linked to this Accounting Contact.
- Debitor Number Debitor number assigned to the accounting contact.
- Creditor Number Creditor number assigned to the accounting contact.

Output

The node outputs JSON data representing the updated Accounting Contact object as returned by the sevDesk API. This typically includes the updated fields and metadata confirming the successful update.

If the node supports binary data output, it would represent any file or attachment related to the Accounting Contact, but based on the provided code and properties, this node primarily deals with JSON data.

Dependencies

  • Requires an active connection to the sevDesk API.
  • Needs an API authentication token or key configured in n8n credentials for sevDesk.
  • The base URL for API requests is https://my.sevdesk.de/api/v1/.

Troubleshooting

  • Booking Errors After Update: Users should be aware that updating Accounting Contacts may cause booking inconsistencies, especially with DATEV exports. Verify data integrity post-update.
  • Invalid Accounting Contact ID: If the specified Accounting Contact ID does not exist or is incorrect, the API will likely return an error. Ensure the ID is valid.
  • Missing Required Fields: The node requires the Accounting Contact ID; omitting it will prevent execution.
  • API Authentication Issues: Ensure the API key or token is correctly set up in n8n credentials; otherwise, authentication errors will occur.
  • Field Validation Errors: Providing invalid values for debitor or creditor numbers (e.g., non-numeric) may cause the API to reject the request.

Links and References

Discussion