sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to manage accounting contacts. Specifically, the "Update" operation for the "AccountingContact" resource allows users to modify existing accounting contact records by specifying their ID and updating relevant fields such as contact details, debitor number, and creditor number.

Common scenarios where this node is beneficial include:

  • Synchronizing updated contact information from other systems into sevDesk.
  • Correcting or adding financial identifiers like debitor or creditor numbers for accounting contacts.
  • Automating updates to accounting contacts in bulk workflows.

For example, a user might update an accounting contact's linked contact ID and assign a new debitor number after receiving updated client data from a CRM system.

Properties

Name Meaning
ID The unique identifier of the accounting contact to update.
Contact Collection of contact information related to the accounting contact:
- Contact ID: The ID of the contact entity this accounting contact belongs to.
- Object Name: Fixed string "Contact" indicating the type of object referenced.
Debitor Number The debitor number associated with the accounting contact (used for accounts receivable).
Creditor Number The creditor number associated with the accounting contact (used for accounts payable).

Output

The node outputs JSON data representing the result of the update operation on the accounting contact. This typically includes the updated accounting contact object returned by the sevDesk API.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the sevDesk API via an API key credential configured in n8n.
  • The base URL for API requests is https://my.sevdesk.de/api/ appended with the API version specified in credentials.
  • Validation schemas are initialized at runtime to ensure request correctness.

Troubleshooting

  • Common issues:

    • Invalid or missing accounting contact ID will cause the update to fail.
    • Incorrect API credentials or expired tokens will result in authentication errors.
    • Providing incomplete or invalid contact information may lead to validation errors from the API.
  • Error messages:

    • Errors thrown during execution are caught and can be output as error JSON if "Continue On Fail" is enabled.
    • Typical error messages include "Not Found" for invalid IDs or "Unauthorized" for credential issues.
  • Resolution tips:

    • Verify that the accounting contact ID exists in sevDesk before attempting an update.
    • Ensure API credentials are correctly set up and have sufficient permissions.
    • Validate input fields against expected formats and required fields.

Links and References

Discussion