sevDesk icon

sevDesk

Consume the sevDesk API
Join our community

Actions98

Overview

The node integrates with the sevDesk API to update an existing Order Position. It allows users to modify details such as discount, name, price, quantity, and text associated with a specific order position in sevDesk. This is useful for automating updates to order line items within accounting or invoicing workflows, ensuring that order data remains accurate and up-to-date without manual intervention.

Practical examples include:

  • Adjusting the quantity or price of an item in an order after receiving updated information.
  • Adding or modifying descriptive text or discounts on an order position programmatically.
  • Synchronizing order position changes from another system into sevDesk automatically.

Properties

Name Meaning
Order Position ID The unique identifier of the order position to update.
Additional Fields Optional fields to update on the order position. Can include:
- Discount Numeric value representing a discount applied to the order position.
- Name The name or title of the order position item.
- Price Numeric value representing the price of the order position item.
- Quantity Numeric value indicating how many units of the item are included.
- Text Additional descriptive text related to the order position.

Output

The node outputs JSON data representing the updated order position as returned by the sevDesk API. This typically includes all properties of the order position after the update, such as its ID, name, price, quantity, discount, and any other relevant metadata.

If an error occurs during the update, the output JSON will contain an error field with the error message, paired with the input item index.

The node does not output binary data.

Dependencies

  • Requires an active connection to the sevDesk API via an API key credential.
  • The node expects the environment configuration to be validated before execution.
  • No additional external dependencies beyond the sevDesk API and its authentication.

Troubleshooting

  • Common issues:

    • Invalid or missing Order Position ID will cause the update to fail.
    • Providing invalid data types (e.g., string instead of number for price) may result in API errors.
    • Network or authentication failures can prevent successful API calls.

  • Error messages:

    • Errors returned from the API will be surfaced in the output JSON under the error field.
    • If the node is set to continue on failure, it will return error details per item; otherwise, it will throw and stop execution.

  • Resolutions:

    • Ensure the Order Position ID is correct and exists in sevDesk.
    • Validate input data types and required fields before running the node.
    • Verify API credentials and network connectivity.

Links and References

Discussion