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 CheckAccount resource and the Get Balance at Date operation, it retrieves the balance of a specified check account as of a given date (up to 23:59:59). This is useful for financial workflows where you need to know the account balance at a particular point in time, such as generating reports, reconciling accounts, or auditing transactions.
Practical Examples
- Fetching the balance of a bank account on the last day of a fiscal quarter.
- Retrieving historical balances for cash flow analysis.
- Validating account balances before processing payments or transfers.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the check account whose balance you want to retrieve. |
| Date | The cutoff date (up to 23:59:59) to consider transactions when calculating the balance. |
Output
The node outputs JSON data representing the balance information of the specified check account as of the given date. The exact structure depends on the sevDesk API response but typically includes fields such as:
- Account ID
- Balance amount
- Currency
- Date of balance calculation
- Possibly additional metadata related to the account or transactions considered
If the node supports binary data output, it would be used for file downloads or attachments, but this node primarily returns JSON data.
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 from credentials. - Validation schemas are initialized at runtime to ensure request correctness.
- No other external dependencies are required beyond the sevDesk API access.
Troubleshooting
Common Issues:
- Invalid or missing check account ID will cause errors.
- Incorrect date format or invalid date values may lead to failed requests.
- Network issues or incorrect API credentials will prevent successful API calls.
Error Messages:
- Errors returned by the API will be captured and can appear in the output if "Continue On Fail" is enabled.
- Typical error messages include authentication failures, resource not found, or validation errors.
Resolutions:
- Verify that the check account ID exists and is correctly entered.
- Ensure the date string is valid and formatted properly.
- Confirm API credentials are correct and have sufficient permissions.
- Check network connectivity and sevDesk service status.
Links and References
- sevDesk API Documentation
- n8n Documentation on Creating Custom Nodes
- Date and Time Handling Best Practices (for formatting dates correctly)