sevDesk

Consume the sevDesk API

Actions98

Contact Actions
- Get Many
- Check Customer Number Availability
- Create
- Delete
- Find By Custom Field Value
- Get
- Get Number of Items
- Is Deletable
- Update
AccountingContact Actions
- Create
- Delete
- Get
- Get Many
- Update
Category Actions
- Get Many
CheckAccount Actions
- Create Clearing Account
- Create File Import Account
- Delete
- Get
- Get Balance at Date
- Update
CheckAccountTransaction Actions
- Create
- Delete
- Get Many
- Update
CommunicationWay Actions
- Create
- Delete
- Get
- Get Many
- Update
Contact Address Actions
- Create
- Delete
- Get
- Update
Contact Custom Field Actions
- Create
- Delete
- Get
- Update
Contact Custom Field Setting Actions
- Create
- Delete
- Get
- Update
Credit Note Actions
- Book
- Create
- Create From Invoice
- Delete
- Enshrine
- Get
- Get Many
- Get PDF
- Mark As Sent
- Reset Status To Draft
- Reset Status To Open
- Send By Email
- Send By Printing
- Update
Credit Note Po Actions
- Get Many
Export Actions
- Update Export Config
- Export DATEV (Deprecated)
- Start DATEV CSV Zip Export
- Start DATEV XML Zip Export
- Generate Download Hash
- Get Progress
- Get Job Download Info
- Export Invoice as CSV
- Export Invoice as Zip
- Export Credit Note as CSV
- Export Voucher as CSV
- Export Voucher as Zip
- Export Transaction as CSV
- Export Contact as CSV
Part Actions
- Get Many
- Create
- Get
- Get Stock
- Update
Invoice Actions
- Get Many
Invoice Position Actions
- Get Many
Order Actions
- Create
- Create Invoice
- Delete
- Download PDF
- Get
- Get Many
- Send By Email
- Update
Order Position Actions
- Get Many
- Get
- Update
- Delete
Report Actions
- Get Many
Tag Actions
- Create
- Delete
- Get
- Get Many
- Update
Voucher Actions
- Get Many
VoucherPo Actions
- Get Many

Overview

This node integrates with the sevDesk API to retrieve multiple check account transactions based on specified filters. It is useful for automating financial workflows, such as fetching transaction data for reconciliation, reporting, or further processing within an n8n workflow.

For example, a user might want to get all booked transactions from a specific check account within a date range to generate a financial report or trigger alerts on certain payment purposes.

Properties

Name	Meaning
Filters	A collection of optional filters to narrow down the transactions retrieved:
- Check Account ID	Filter transactions by a specific check account identifier (string).
- End Date	Retrieve transactions up to this end date/time (dateTime).
- Is Booked	Boolean flag to filter only booked transactions (`true`) or unbooked (`false`).
- Payment Purpose	Filter transactions by their payment purpose description (string).
- Start Date	Retrieve transactions starting from this start date/time (dateTime).

Output

The node outputs an array of JSON objects representing the retrieved check account transactions. Each object contains the transaction details as returned by the sevDesk API, including fields such as transaction ID, amount, date, booking status, payment purpose, and related metadata.

No binary data output is produced by this node.

Dependencies

Requires an active sevDesk API key credential configured in n8n.
The node communicates with the sevDesk REST API endpoint at https://my.sevdesk.de/api/.
Environment configuration validation is performed before execution to ensure proper setup.

Troubleshooting

Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect filter values (e.g., invalid date formats) may result in API errors or empty results.
- Network connectivity problems can prevent successful API calls.
Error messages:
- Errors thrown by the node include the API error message in the output JSON under an error field when "Continue On Fail" is enabled.
- To resolve errors, verify API credentials, check filter parameter correctness, and ensure network access to sevDesk API endpoints.

Links and References

sevDesk API Documentation
n8n documentation on creating custom nodes

sevDeskInstall