sevDesk icon

sevDesk

Consume the sevDesk API

Overview

The node integrates with the sevDesk API to manage various resources, including Credit Notes. Specifically, the "Reset Status To Draft" operation for the Credit Note resource allows users to revert a credit note's status back to draft. This is useful in scenarios where a credit note has been finalized or processed but needs to be edited or reviewed again before finalization.

Practical examples:

  • A user mistakenly marked a credit note as sent or booked and wants to revert it to draft to make corrections.
  • Automating workflows where credit notes are reset to draft based on certain conditions or triggers in an accounting process.

Properties

Name Meaning
Credit Note ID The unique identifier of the credit note whose status you want to reset to draft.

Output

The node outputs JSON data representing the result of the operation performed on the credit note. Typically, this will include confirmation of the status reset or details of the updated credit note object returned by the sevDesk API.

If an error occurs during execution, the output JSON will contain an error field with the error message describing what went wrong.

No binary data output is indicated.

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 at runtime to ensure necessary environment variables or settings are correct.

Troubleshooting

  • Common issues:

    • Invalid or missing Credit Note ID: The operation requires a valid credit note identifier; otherwise, the API call will fail.
    • Authentication errors: Ensure the API key credential is correctly configured and has sufficient permissions.
    • Network or API downtime: Connectivity issues with sevDesk API can cause failures.
  • Error messages:

    • Errors returned from the API will be captured and included in the output under the error field if "Continue On Fail" is enabled.
    • Validation warnings may appear if environment configuration is incorrect or incomplete.

To resolve errors:

  • Verify the Credit Note ID is correct and exists in sevDesk.
  • Check API credentials and permissions.
  • Confirm network connectivity and sevDesk service status.

Links and References

Discussion