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 perform various operations related to invoices. Specifically, the Book Invoice operation allows users to book an invoice by specifying details such as the invoice ID, booking amount (which can be partial), booking date, type of booking, and the check account to which the booking should be applied. This operation is useful for automating financial workflows where invoices need to be marked as booked in the accounting system, reflecting payments or adjustments.
Practical examples include:
- Automatically booking customer invoices once payment is received.
- Booking partial payments or discounts on invoices.
- Recording currency fluctuation adjustments or reminder charges against invoices.
Properties
| Name | Meaning |
|---|---|
| Invoice ID | The unique identifier of the invoice to be booked. |
| Amount | The amount to be booked on the invoice. Can represent a full or partial amount. |
| Date | The booking date, typically the current date when the booking occurs. |
| Type | The type of booking. Options include: - Normal booking / partial booking - Reduced amount due to discount (skonto) - Reduced/Higher amount due to currency fluctuations - Reduced/Higher amount due to other reasons - Higher amount due to reminder charges - Reduced amount due to monetary traffic costs |
| Check Account ID | The ID of the check account on which the booking should be made. This links the booking to a specific financial account. |
| Additional Fields | Optional extra fields: - Check Account Transaction ID: Links the booking to a specific transaction on the check account. - Create Feed: Boolean flag indicating whether to create a feed entry for this booking process. |
Output
The node outputs JSON data representing the result of the booking operation as returned by the sevDesk API. This typically includes confirmation details about the booked invoice, such as updated status, amounts, and linked accounts. There is no binary output involved.
Dependencies
- Requires an active connection to the sevDesk API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- The base URL for API requests is
https://my.sevdesk.de/api/v1/.
Troubleshooting
- Invalid Invoice ID: If the invoice ID does not exist or is incorrect, the API will return an error. Verify the invoice ID before booking.
- Insufficient Permissions: Ensure the API key has permissions to book invoices.
- Incorrect Check Account ID: Using an invalid or non-existent check account ID will cause errors. Retrieve valid IDs using the sevDesk node’s "Get Many" operation for Check Accounts.
- Date Format Issues: The booking date must be in a valid datetime format; otherwise, the API may reject the request.
- Partial Amounts: When booking partial amounts, ensure the amount does not exceed the invoice balance.
- API Rate Limits: Frequent bookings might hit API rate limits; handle retries or delays accordingly.