Actions41
- AccountingContact Actions
- Category Actions
- CheckAccount Actions
- CheckAccountTransaction Actions
- CommunicationWay Actions
- Contact Actions
- ContactAddress Actions
- Invoice Actions
- Part Actions
Overview
The node integrates with the sevDesk API to retrieve multiple invoice records based on specified filters and limits. It is useful for scenarios where users need to fetch a list of invoices, such as generating reports, syncing invoice data with other systems, or performing batch operations on invoices.
For example, a user might want to:
- Retrieve all invoices within a specific date range.
- Get invoices related to a particular contact.
- Fetch only invoices with a certain status like "Draft" or "Paid".
- Limit the number of invoices returned to avoid overwhelming downstream processing.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all matching invoices or limit the results to a specified maximum number. |
| Limit | The maximum number of invoices to return when not returning all. Minimum value is 1, default 50. |
| Filters | Collection of optional filters to narrow down the invoices retrieved: |
| - Contact ID | Retrieve invoices associated with a specific contact ID. Must be used together with Contact Object Name. |
| - End Date | Retrieve invoices with a date equal to or before this date. |
| - Invoice Number | Retrieve invoices matching a specific invoice number. |
| - Start Date | Retrieve invoices with a date equal to or after this date. |
| - Status | Filter invoices by their status. Options are: Draft (100), Open / Due (200), Paid (1000). |
Output
The node outputs an array of invoice objects in the json field of the output data. Each object represents an invoice record retrieved from the sevDesk API, containing details such as invoice number, dates, status, contact information, and other invoice-specific fields.
If binary data were involved (e.g., PDF attachments), it would be included in the binary output, but this operation focuses on JSON invoice data only.
Dependencies
- Requires an active connection to the sevDesk API.
- Users must provide valid API authentication credentials (an API key or token) configured in n8n.
- The node sends HTTP requests to
https://my.sevdesk.de/api/v1/.
Troubleshooting
- No invoices returned: Check that the filters are correctly set and that invoices exist matching those criteria. Also verify API credentials and network connectivity.
- Authentication errors: Ensure the API key/token is valid and has sufficient permissions.
- Limit ignored or too many results: If
Return Allis false but more than the limit appears, verify the node configuration and API response handling. - Invalid filter values: For example, using a non-existent contact ID or invalid date format may cause no results or errors.
- Status filter confusion: The status values are numeric codes; ensure correct values are selected (Draft=100, Open/Due=200, Paid=1000).