sevDesk

Consume the sevDesk API

Actions98

Contact Actions
- Get Many
- Check Customer Number Availability
- Create
- Delete
- Find By Custom Field Value
- Get
- Get Number of Items
- Is Deletable
- Update
AccountingContact Actions
- Create
- Delete
- Get
- Get Many
- Update
Category Actions
- Get Many
CheckAccount Actions
- Create Clearing Account
- Create File Import Account
- Delete
- Get
- Get Balance at Date
- Update
CheckAccountTransaction Actions
- Create
- Delete
- Get Many
- Update
CommunicationWay Actions
- Create
- Delete
- Get
- Get Many
- Update
Contact Address Actions
- Create
- Delete
- Get
- Update
Contact Custom Field Actions
- Create
- Delete
- Get
- Update
Contact Custom Field Setting Actions
- Create
- Delete
- Get
- Update
Credit Note Actions
- Book
- Create
- Create From Invoice
- Delete
- Enshrine
- Get
- Get Many
- Get PDF
- Mark As Sent
- Reset Status To Draft
- Reset Status To Open
- Send By Email
- Send By Printing
- Update
Credit Note Po Actions
- Get Many
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
- Get Many
- Create
- Get
- Get Stock
- Update
Invoice Actions
- Get Many
Invoice Position Actions
- Get Many
Order Actions
- Create
- Create Invoice
- Delete
- Download PDF
- Get
- Get Many
- Send By Email
- Update
Order Position Actions
- Get Many
- Get
- Update
- Delete
Report Actions
- Get Many
Tag Actions
- Create
- Delete
- Get
- Get Many
- Update
Voucher Actions
- Get Many
VoucherPo Actions
- Get Many

Overview

The node integrates with the sevDesk API to perform various operations on sevDesk resources. Specifically, for the Order resource with the Get operation, it retrieves detailed information about a specific order by its unique identifier. This is useful in scenarios where you need to fetch order details for processing, reporting, or synchronization with other systems.

Practical examples include:

Fetching an order's data to display in a dashboard.
Retrieving order details before updating or sending invoices.
Integrating order information into external accounting or CRM systems.

Properties

Name	Meaning
Order ID	The unique identifier of the order to retrieve. This is a required string input.

Output

The node outputs JSON data representing the retrieved order object from the sevDesk API. The structure typically includes all relevant order details such as customer info, order items, status, dates, and totals.

If the node encounters an error (e.g., invalid Order ID), the output will contain an error field with the error message.

No binary data output is produced by this operation.

Dependencies

Requires an active connection to the sevDesk API via an API key credential.
The node uses the base URL https://my.sevdesk.de/api/ combined with the configured API version.
Environment configuration validation is performed before execution to ensure proper setup.

Troubleshooting

Common issues:
- Invalid or missing Order ID will cause the API call to fail.
- Network connectivity problems or incorrect API credentials will prevent successful retrieval.
- If the API version environment variable is not set correctly, requests may fail.
Error messages:
- Errors returned from the API are passed through in the output under an error property.
- Initialization errors related to validation schemas are logged to the console but do not stop execution.
Resolutions:
- Verify that the Order ID is correct and exists in sevDesk.
- Ensure API credentials are valid and have sufficient permissions.
- Check network connectivity and API endpoint accessibility.
- Confirm environment variables for API version and other config are properly set.

Links and References

sevDesk API Documentation
n8n documentation on creating custom nodes

sevDeskInstall