mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation allows you to terminate an existing contract by specifying its unique identifier. It is useful in scenarios where a contract needs to be ended before its natural expiration, such as when a project is canceled or no longer required. For example, if a client decides to stop using a service, this operation can be used to formally terminate the associated contract with a reason and an optional termination date.

Properties

Name Meaning
Contract Id The unique identifier (UUID) of the contract that you want to terminate. This is a required field.
Reason A plain text explanation for why the contract is being terminated. Defaults to "Projekt wird nicht mehr benötigt".
Termination Target Date The desired termination date for the contract. Must be a valid date respecting the contract's activation and period. 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, status, and any relevant metadata returned by the API. There is no indication that binary data is output by this node.

Dependencies

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

Troubleshooting

  • Invalid Contract Id: If the provided contract UUID does not exist or is malformed, the API may return an error indicating the contract cannot be found. Verify the contract ID is correct.
  • Invalid Termination Date: Providing a termination date outside the allowed range (before activation or after contract period) may cause errors. Ensure the date complies with contract terms or leave it blank to use the default next possible date.
  • Authentication Errors: Missing or invalid API credentials will prevent the node from executing successfully. Confirm that the API key is correctly set up in n8n.
  • API Rate Limits or Downtime: Temporary issues with the mittwald API could cause failures. Check API status and retry later if needed.

Links and References

Discussion