sevDesk icon

sevDesk

Consume the sevDesk API

Overview

The node integrates with the sevDesk API to perform various operations on sevDesk resources. Specifically, for the Credit Note resource and the Mark As Sent operation, it marks a specified credit note as sent within the sevDesk system. This is useful in accounting workflows where you want to update the status of a credit note after dispatching it to a customer.

Practical examples include:

  • Automatically marking credit notes as sent after generating and emailing them.
  • Updating credit note statuses in bulk during financial reconciliation processes.

Properties

Name Meaning
Credit Note ID The unique identifier of the credit note to mark as sent. This is required.
Send Data Additional data related to sending the credit note. Contains:
  Send Type A string indicating the type or method of sending (e.g., email, print). Optional field.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON object contains the response from the sevDesk API after attempting to mark the credit note as sent. If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message for that particular item.

No binary data output is indicated by the source code.

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.
  • The node depends on internal modules managing resource operations and validation schemas, which handle communication with sevDesk endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing Credit Note ID will cause the API call to fail.
    • Incorrect or expired API authentication token will result in authorization errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Errors returned from the API are captured and included in the output if "Continue On Fail" is enabled.
    • Typical error messages might include "Credit Note not found" or "Unauthorized access".
  • Resolutions:

    • Verify the Credit Note ID is correct and exists in sevDesk.
    • Ensure the API key credential is valid and has necessary permissions.
    • Check network connectivity and retry.

Links and References

Discussion