mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation allows users to cancel a tariff change on an existing contract item within a contract. It is useful in scenarios where a previously scheduled or applied tariff modification needs to be reverted or annulled before it takes effect or after it has been applied but must be undone. For example, if a customer requested a tariff upgrade that was later canceled, this operation would reverse that change on the specified contract item.

Properties

Name Meaning
Contract Id The unique identifier of the contract containing the contract item whose tariff change is to be canceled.
Contract Item Id The UUID of the active contract item (not the one replacing it after the tariff change) for which the tariff change cancellation applies. This only works for contract items that have a stored tariff change.

Output

The node outputs JSON data representing the result of the tariff change cancellation request. This typically includes confirmation details such as status, updated contract item information, or error messages if the cancellation failed. No binary data output is indicated.

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 in n8n is necessary.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Contract Id or Contract Item Id will likely cause errors.
    • Attempting to cancel a tariff change on a contract item that does not have a tariff change stored will fail.
    • Network or authentication failures can prevent successful API calls.
  • Error messages and resolutions:

    • "Contract item not found" — Verify that the Contract Item Id is correct and corresponds to an active contract item.
    • "No tariff change to cancel" — Ensure the contract item actually has a tariff change pending or applied.
    • Authentication errors — Check that the API key credential is correctly configured and valid.
    • Network timeouts or unreachable API — Confirm network connectivity and API availability.

Links and References

Discussion