sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to retrieve multiple "Part" records based on specified filters. It is useful for scenarios where you need to fetch a list of parts from your sevDesk account, such as inventory management, reporting, or synchronization with other systems.

For example, you can use this node to:

  • Retrieve all parts matching a specific part number.
  • Search parts by their name to find relevant items quickly.
  • Pull filtered lists of parts to update stock levels or generate reports.

Properties

Name Meaning
Filters A collection of optional filters to narrow down the parts retrieved. Options include:
- Part Number: Filter parts by their unique part number (string).
- Name: Filter parts by their name (string).

Output

The node outputs an array of JSON objects representing the parts that match the filter criteria. Each object contains the data fields returned by the sevDesk API for a part, such as identifiers, names, and other part details.

If any error occurs during execution and the node is set to continue on failure, the output will include an error object with the message describing the issue, paired with the input item index.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the sevDesk API.
  • The node uses the base URL https://my.sevdesk.de/api/ combined with the API version specified in credentials.
  • Environment configuration validation is performed before execution to ensure proper setup.

Troubleshooting

  • Common issues:

    • Invalid or missing API authentication token may cause authorization errors.
    • Incorrect filter values might result in empty responses.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Errors thrown by the API or network failures are caught and can be output as error objects if "Continue On Fail" is enabled.
    • Typical error messages include authentication failures, invalid parameters, or rate limiting notices.
  • Resolution tips:

    • Verify that the API key credential is correctly configured and has necessary permissions.
    • Double-check filter inputs for correct formatting.
    • Ensure stable internet connection and that the sevDesk API service is operational.

Links and References

Discussion