sevDesk icon

sevDesk

Consume the sevDesk API

Overview

This node integrates with the sevDesk API to perform various operations on sevDesk resources. Specifically, for the AccountingContact - Get operation, it retrieves detailed information about a single accounting contact by its unique ID. This is useful in scenarios where you need to fetch up-to-date contact details from your accounting system for further processing, reporting, or synchronization with other tools.

Practical examples include:

  • Fetching an accounting contact's data before updating related invoices.
  • Retrieving contact details to display or use in automated workflows.
  • Integrating sevDesk contact data into CRM or ERP systems.

Properties

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

Output

The node outputs JSON data representing the retrieved accounting contact object from the sevDesk API. The structure typically includes all fields associated with the accounting contact, such as name, address, contact details, and any custom fields defined in sevDesk.

If the node encounters an error (e.g., invalid ID), the output JSON 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 configured in n8n.
  • The node uses the base URL https://my.sevdesk.de/api/ combined with the API version specified in credentials.
  • Environment configuration validation is performed at runtime to ensure proper setup.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent accounting contact ID will result in an error response.
    • Missing or incorrect API credentials will cause authentication failures.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • "error": "Not Found" indicates the specified accounting contact ID does not exist.
    • Authentication errors suggest checking the API key credential.
    • Validation warnings may appear if environment variables or configurations are missing or incorrect.

To resolve these:

  • Verify the accounting contact ID is correct and exists in sevDesk.
  • Ensure the API key credential is properly set up and has necessary permissions.
  • Check network access and proxy settings if applicable.

Links and References

Discussion