Actions41
- AccountingContact Actions
- Category Actions
- CheckAccount Actions
- CheckAccountTransaction Actions
- CommunicationWay Actions
- Contact Actions
- ContactAddress Actions
- Invoice Actions
- Part Actions
Overview
This node integrates with the sevDesk API to create or update invoices. It allows users to manage invoices comprehensively by creating invoices with detailed positions and discounts, updating existing invoices, deleting invoice positions while adding new ones, and managing discounts flexibly. Additionally, it can automatically fill the invoice address based on the supplied contact's address.
Common scenarios where this node is beneficial include:
- Automating invoice creation in accounting workflows.
- Updating invoices dynamically with new line items or discounts.
- Managing recurring invoices with specific intervals and statuses.
- Integrating invoicing processes with customer and order data from sevDesk.
Practical example: A business could use this node to generate a final invoice for a customer after an order is completed, including multiple product positions, applying discounts, setting payment terms, and specifying tax details, all automatically populated from their CRM data.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The contact used in the invoice. (Required) Typically obtained from sevDesk contacts. |
| Invoice Date | Date of the invoice; must be timestamp or dd.mm.yyyy format. For final invoices, must be later or equal to related advance/partial invoices. (Required) |
| Discount | Percentage discount applied to the invoice. Provide zero if no discount. (Required) |
| Status | Status code of the invoice. Options: Deactivated Recurring Invoice (50), Draft (100), Open / Due (200), Payed (1000). (Required) |
| Contact Person ID | User acting as contact person for the invoice. (Required) |
| Tax Rate | Tax rate percentage for the invoice; overridden by individual invoice position tax rates. (Required) |
| Tax Text | Descriptive text for the tax, e.g., "Umsatzsteuer 19%". (Required) |
| Tax Type | Type of tax applied. Options: Default, EU (tax-free intra-community supply), Not EU (reverse charge outside EU), Custom, SS (not subject to VAT). (Required) |
| Invoice Type | Type of invoice. Options: Cancellation Invoice, Final Invoice, Normal Invoice, Part Invoice, Recurring Invoice, Reminder Invoice. (Required) |
| Currency | Currency code according to ISO-4217, e.g., EUR. (Required) |
| Map All | Boolean flag to map all fields automatically. Defaults to true. |
| Additional Fields | Collection of optional additional invoice attributes such as Invoice ID (for updates), Small Settlement scheme flag, Account Interval (for recurring invoices), Address, Cost Centre ID, Internal Notes, Delivery Dates, Payment Method, Reminder details, Send Type, Show Net flag, Tax Set, Time To Pay, etc. |
| Invoice Positions | Collection containing JSON arrays for saving new invoice positions or deleting existing ones. Positions define line items on the invoice. |
| Discounts | Collection containing JSON arrays for saving new discounts or deleting existing ones applied to the invoice. |
Output
The node outputs JSON data representing the created or updated invoice object as returned by the sevDesk API. This includes all invoice details such as IDs, dates, status, positions, discounts, tax information, and related metadata.
If binary data is output (not explicitly shown here), it would typically represent invoice PDFs or attachments, but this node primarily handles JSON invoice data.
Dependencies
- Requires an active sevDesk API key credential configured in n8n to authenticate requests.
- Uses the sevDesk REST API endpoint at
https://my.sevdesk.de/api/v1/. - No other external dependencies are indicated.
Troubleshooting
- Missing Required Fields: Errors may occur if required fields like Contact ID, Invoice Date, Status, or Tax Type are missing. Ensure all mandatory properties are provided.
- Invalid Date Formats: Invoice Date and other date fields must be valid timestamps or in dd.mm.yyyy format. Incorrect formats will cause request failures.
- Status Code Misuse: Using unsupported status codes may result in errors. Refer to the sevDesk API documentation for valid status values.
- Tax Type and Tax Set Mismatch: If using custom tax types, ensure the corresponding tax set ID is provided; otherwise, the API may reject the request.
- Invoice Position JSON Structure: When adding or deleting invoice positions or discounts, ensure the JSON structure matches the sevDesk model schema to avoid validation errors.
- API Limits or Authentication Failures: Check that the API key is valid and has sufficient permissions. Also, monitor for rate limits imposed by sevDesk.