sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions98

Overview

This node integrates with the sevDesk API to update an existing check account. It allows users to modify various attributes of a check account such as its name, accounting number, import type, status, and other settings. This is useful in scenarios where financial accounts need to be maintained or adjusted programmatically within an automated workflow, for example, updating account details after organizational changes or correcting account information without manual intervention.

Practical examples include:

  • Automatically updating the name or status of a check account when triggered by external events.
  • Changing the import type or currency of a check account based on new business requirements.
  • Setting a particular check account as the default account dynamically.

Properties

Name Meaning
ID The unique identifier of the check account to update (required).
Name The new name for the check account (required).
Accounting Number The booking account number used for this clearing account (required).
Import Type Method used to import transactions into the check account. Options: CSV, MT940.
Type Specifies whether the check account is "Online" or "Offline".
Currency The currency code of the check account, e.g., EUR.
Default Account Boolean flag indicating if this check account should be set as the default account.
Status Status of the check account. Options: Active (100), Archived (200).
Auto Map Transactions Boolean flag indicating whether transactions are automatically mapped to invoices and vouchers when imported if possible.

Output

The node outputs JSON data representing the updated check account object returned from the sevDesk API. This typically includes all the updated fields of the check account along with any metadata provided by the API.

If an error occurs during execution and the node is configured to continue on failure, the output will contain an error message in the JSON under an error field corresponding to the failed item.

No binary data output is produced by this node.

Dependencies

  • Requires an active sevDesk API key credential configured in n8n to authenticate requests.
  • The node uses the sevDesk API endpoint at https://my.sevdesk.de/api/.
  • Environment configuration validation is performed before execution to ensure required environment variables or settings are present.

Troubleshooting

  • Common issues:

    • Invalid or missing check account ID will cause the update operation to fail.
    • Incorrect API credentials or expired tokens will result in authentication errors.
    • Providing invalid values for enumerated properties like Import Type or Status may cause API validation errors.
    • Network connectivity issues can prevent communication with the sevDesk API.

  • Error messages:

    • Errors returned from the API are captured and included in the output JSON under an error property if "Continue On Fail" is enabled.
    • Typical error messages might include "Resource not found" if the check account ID does not exist, or "Unauthorized" if API credentials are invalid.

  • Resolution tips:

    • Verify that the check account ID exists and is correct.
    • Ensure API credentials are valid and have sufficient permissions.
    • Double-check property values against allowed options.
    • Confirm network access to the sevDesk API endpoint.

Links and References

Discussion