Actions98
- Contact Actions
- AccountingContact Actions
- Category Actions
- CheckAccount Actions
- CheckAccountTransaction Actions
- CommunicationWay Actions
- Contact Address Actions
- Contact Custom Field Actions
- Contact Custom Field Setting Actions
- Credit Note Actions
- Credit Note Po Actions
- 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
- Invoice Actions
- Invoice Position Actions
- Order Actions
- Order Position Actions
- Report Actions
- Tag Actions
- Voucher Actions
- VoucherPo Actions
Overview
This node integrates with the sevDesk API to perform various operations on sevDesk resources. Specifically, for the Tag resource with the Get Many operation, it retrieves multiple tag records from the sevDesk system. This is useful when you want to fetch a list of tags, optionally filtered by certain criteria such as ID or name.
Practical examples include:
- Retrieving all tags to display in a dashboard.
- Filtering tags by name to find specific categories or labels used in your accounting or CRM processes.
- Synchronizing tags from sevDesk into another system.
Properties
| Name | Meaning |
|---|---|
| Filters | A collection of optional filters to narrow down the tags returned. Options include: |
| - ID | Filter tags by their unique identifier (string). |
| - Name | Filter tags by their name (string). |
Output
The node outputs an array of JSON objects representing the tags retrieved from sevDesk. Each object corresponds to a tag and contains its properties as returned by the sevDesk API, such as ID, name, and other tag-related metadata.
If any error occurs during execution and "Continue On Fail" is enabled, the output will include an error object with the error message for the corresponding input item.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the sevDesk API via an API key credential configured in n8n.
- The node uses the base URL
https://my.sevdesk.de/api/combined with the API version specified in credentials. - Environment configuration validation is performed before execution to ensure required environment variables or settings are present.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect filter values may result in empty responses.
- Network connectivity problems can prevent access to the sevDesk API.
Error messages:
- Errors thrown by the API (e.g., unauthorized, not found) will be surfaced in the node's output if "Continue On Fail" is enabled.
- Initialization errors related to validation schemas are logged to the console but do not stop node execution.
Resolutions:
- Verify that the API key credential is correctly set up and has necessary permissions.
- Double-check filter inputs for correct formatting.
- Ensure network access to
my.sevdesk.deis available.