sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions41

Overview

This node integrates with the sevDesk API to retrieve category data filtered by a specific object type. The "Get by ObjectType" operation under the "Category" resource allows users to fetch categories associated with particular object types such as "Contact Address" or "Part". This is useful in scenarios where you want to organize or filter categories based on their related business objects, for example, retrieving all categories relevant to contact addresses for customer management or parts for inventory control.

Practical examples:

  • Fetching all categories linked to contact addresses to display or process customer location data.
  • Retrieving categories related to parts to manage product classifications or inventory groupings.

Properties

Name Meaning
ObjectType Specific object type to filter categories by. Options: "Contact Address", "Part".

Output

The node outputs JSON data representing the categories retrieved from the sevDesk API filtered by the selected object type. Each item in the output typically contains details about a category such as its ID, name, and any other metadata provided by the API.

If the node supports binary data output (not indicated here), it would represent attachments or files related to categories, but this is not evident from the provided code.

Dependencies

  • Requires an active connection to the sevDesk API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for API requests is https://my.sevdesk.de/api/v1/.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Selecting an unsupported object type may result in empty responses or errors.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • Authentication failures usually indicate invalid or expired API tokens; reconfigure credentials.
    • API rate limits or server errors will return HTTP error codes; retry after some time or check API status.
    • If no categories are returned, verify that the selected object type has associated categories in sevDesk.

Links and References

Discussion