sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions41

Overview

This node integrates with the sevDesk API to update a Check Account resource. It allows users to modify properties of an existing check account, such as its name, type, currency, status, and import settings for transactions. This is useful in scenarios where financial accounts need to be programmatically maintained or synchronized with external systems, for example, updating account details after a bank change or adjusting import preferences for transaction data.

Practical examples:

  • Changing the default check account used for transactions.
  • Switching the import type between CSV and MT940 formats.
  • Activating or archiving a check account based on business needs.
  • Updating the currency or name of the check account to reflect organizational changes.

Properties

Name Meaning
ID of Check Account The unique numeric identifier of the check account to update. This is required to specify which account to modify.
Additional Fields A collection of optional fields to update on the check account:
- Import Type Method for importing transactions into the account; options are "CSV" or "MT940".
- Default Account Boolean flag indicating if this check account should be set as the default account.
- Auto Map Transactions Boolean flag determining whether imported transactions are automatically mapped to invoices and vouchers when possible.
- Name The name of the check account.
- Type The type of the check account; can be "Online" (supports CSV or MT940 imports) or "Offline" (no active bank connection).
- Currency The currency code of the check account, e.g., "EUR".
- Status The status of the check account; "Active" (100) or "Archived" (0).

Output

The node outputs JSON data representing the updated check account object as returned by the sevDesk API. This typically includes all current properties of the check account after the update operation.

If binary data were involved (not indicated here), it would represent associated files or attachments related to the check account, but this node focuses solely on JSON data updates.

Dependencies

  • Requires an active sevDesk API key credential configured in n8n to authenticate requests.
  • Relies on the sevDesk REST API endpoint at https://my.sevdesk.de/api/v1/.
  • The node sends JSON-formatted HTTP requests and expects JSON responses.

Troubleshooting

  • Invalid or missing Check Account ID: Ensure the provided ID corresponds to an existing check account in sevDesk; otherwise, the API will return an error.
  • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Invalid field values: For example, setting an unsupported import type or invalid currency code may cause the API to reject the request.
  • Status value issues: Only 0 (Archived) and 100 (Active) are valid; other values may cause errors.
  • Network or API downtime: Temporary connectivity issues with sevDesk API can cause failures; retrying later may help.

Links and References

Discussion