mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

Overview

This node operation allows users to cancel a termination of a specific contract item within a contract. In practical terms, if a contract item was previously marked for termination, this operation reverses that action, effectively restoring the contract item to an active state. This is useful in scenarios where a termination was initiated by mistake or circumstances have changed, requiring the contract item to remain valid.

For example, a company managing multiple service contracts might accidentally schedule a termination for a service line item. Using this node operation, they can cancel that termination without needing to recreate the contract item from scratch.

Properties

Name Meaning
Contract Id The unique identifier (UUID) of the contract containing the contract item to be restored.
Contract Item Id The unique identifier (UUID) of the contract item whose termination is to be cancelled. Only works if a termination record exists for this item.

Output

The node outputs JSON data representing the result of the cancellation request. Typically, this will include confirmation details such as the updated status of the contract item and any relevant metadata returned by the API indicating that the termination has been successfully cancelled.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential to authenticate with the mittwald mStudio API.
  • The node uses the mittwald mStudio API endpoint at https://api.mittwald.de.
  • Proper configuration of the API authentication credentials within n8n is necessary for successful execution.

Troubleshooting

  • Common Issues:

    • Providing invalid or non-existent UUIDs for either the contract or contract item will likely cause errors.
    • Attempting to cancel a termination on a contract item that does not have a termination record will fail.
    • Network or authentication issues with the mittwald API can prevent the operation from completing.
  • Error Messages:

    • Errors related to "not found" typically indicate incorrect contract or contract item IDs.
    • Authentication errors suggest missing or invalid API credentials.
    • API rate limits or server errors may also occur; retrying after some time or checking API status is recommended.

Links and References

Discussion