mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

Overview

This node allows you to terminate a contract in the mittwald mStudio system by specifying the contract's unique identifier. It is useful for automating contract management workflows, such as ending service agreements or subscriptions programmatically when they are no longer needed. For example, if a project associated with a contract is discontinued, this node can be used to trigger the termination process automatically.

Properties

Name Meaning
Contract Id The UUID of the contract that you want to terminate.
Reason A plain text explanation for why the contract is being terminated.
Termination Target Date The desired termination date. Must be valid according to the contract’s activation and period rules. If left empty, the next possible termination date will be used automatically.

Output

The node outputs JSON data representing the result of the contract termination request. This typically includes confirmation details about the terminated contract, such as its ID and status after termination. There is no binary data output.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node sends requests to the mittwald API endpoint at https://api.mittwald.de.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Invalid Contract Id: If the provided contract UUID does not exist or is malformed, the API will likely return an error. Verify the contract ID before running the node.
  • Invalid Termination Date: Providing a termination date that does not comply with the contract’s activation or period rules may cause the request to fail. Either leave it blank to use the next valid date or ensure the date is valid.
  • Authentication Errors: Missing or incorrect API credentials will prevent successful communication with the mittwald API. Ensure the API key credential is correctly set up.
  • API Rate Limits or Downtime: Temporary issues with the mittwald API could cause failures. Check API status or retry later.

Links and References

Discussion