sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions98

Overview

This node integrates with the sevDesk API to create invoices from existing orders. Specifically, the "Create Invoice" operation under the "Order" resource generates an invoice document based on a specified order ID. It supports creating either full or partial invoices, setting invoice and delivery dates, defining invoice status, applying tax rates or custom tax text, marking invoices as small business (tax-exempt), and specifying dunning levels for payment reminders.

Typical use cases include automating invoice generation after an order is finalized, issuing partial invoices for large or ongoing orders, and managing invoice statuses and tax details programmatically within an n8n workflow.

Example scenarios:

  • Automatically create an open invoice for a completed order with today's date.
  • Generate a draft invoice with a custom delivery date and tax exemption for small businesses.
  • Create a partial invoice summing only unbilled order positions.

Properties

Name Meaning
Order ID The unique identifier of the order to create an invoice for. Required.
Part Sum Boolean flag indicating whether to create a partial invoice that sums all not yet billed order positions.
Invoice Date Date/time for the created invoice; defaults to current date if not set.
Delivery Date Date/time representing the delivery date for the invoice.
Invoice Status Status of the created invoice. Options: Draft, Open, Paid. Default is Open.
Small Business Boolean flag indicating if the invoice is for a small business and thus tax-exempt.
Tax Rate Numeric percentage value for the tax rate applied to the invoice. Default is 19%.
Tax Text Custom text describing the tax applied on the invoice.
Dunning Level Level of payment reminder associated with the invoice. Options: No Dunning, First Reminder, Second Reminder, Final Notice. Default is First Reminder.

Output

The node outputs JSON data representing the created invoice object returned by the sevDesk API. This typically includes invoice identifiers, status, dates, amounts, tax details, and related metadata.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the sevDesk API.
  • The base URL for API requests is https://my.sevdesk.de/api/ appended with the API version configured in credentials.
  • Environment configuration validation is performed before execution.
  • Uses internal resource manager classes to handle API operations.

Troubleshooting

  • Common issues:

    • Missing or invalid Order ID will cause the API call to fail.
    • Incorrect date formats for invoice or delivery dates may result in errors.
    • Insufficient permissions or invalid API credentials will prevent invoice creation.
    • Setting incompatible combinations of properties (e.g., partial invoice with no unbilled positions) might lead to unexpected results.

  • Error messages:

    • Errors returned from the API are caught and can be output as JSON error objects if "Continue On Fail" is enabled.
    • Typical API error messages relate to authentication failures, missing required fields, or invalid parameter values.

  • Resolutions:

    • Verify the Order ID exists and is correct.
    • Ensure API credentials are valid and have necessary permissions.
    • Use proper ISO date-time formats for date fields.
    • Check the API documentation for allowed property combinations.

Links and References

Discussion