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 Order Position resource with the Delete operation, it allows users to delete an existing order position by its unique identifier. This is useful in scenarios where an order position needs to be removed from an order due to changes or errors.

Practical examples include:

  • Removing a mistakenly added item from an order before finalizing.
  • Cleaning up order data by deleting obsolete or incorrect order positions.

Properties

Name Meaning
Order Position ID The unique identifier of the order position to delete. This is a required string input.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will confirm whether the deletion was successful or provide error information if it failed.

If the operation fails and "Continue On Fail" is enabled, the output JSON will contain an error field with the error message related to the failure.

No binary data output is involved in 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 necessary environment variables or settings are correct.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Order Position ID will cause the delete operation to fail.
    • Missing or incorrect API authentication credentials will prevent the node from connecting to the sevDesk API.
    • Network connectivity issues can cause request failures.
  • Error messages:

    • Errors returned from the API (e.g., "Order Position not found") will appear in the output JSON under the error field if "Continue On Fail" is enabled.
    • Validation errors related to environment configuration will be logged to the console during initialization.
  • Resolutions:

    • Verify that the Order Position ID is correct and exists in sevDesk.
    • Ensure the API key credential is properly configured and has sufficient permissions.
    • Check network connectivity and sevDesk service status.

Links and References

Discussion