mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

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 change needs to be reverted or invalidated before it takes effect or after it has been applied mistakenly.

Practical examples include:

  • A customer requests to keep their current tariff instead of switching to a new one.
  • An administrative error caused a tariff change that must be undone.
  • Testing or rollback scenarios where tariff changes are trialed and then canceled.

Properties

Name Meaning
Contract Id The unique identifier (UUID) of the contract for which the tariff change cancellation is to be performed.
Contract Item Id The UUID of the active contract item (not the one replacing it after the tariff change). This identifies the specific contract item whose tariff change will be canceled. Only contract items with a stored tariff change can be targeted.

Output

The node outputs JSON data representing the result of the 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 by the source code.

Dependencies

  • Requires an API key credential for authentication with the mittwald mStudio API.
  • Connects to the mittwald API endpoint at https://api.mittwald.de.
  • Uses standard HTTP headers for JSON content (Accept: application/json, Content-Type: application/json).

Troubleshooting

  • Invalid Contract or Contract Item ID: If the provided UUIDs do not correspond to existing contracts or contract items, the API may return errors indicating not found or invalid identifiers. Verify the IDs before use.
  • No Tariff Change Found: Attempting to cancel a tariff change on a contract item without any stored tariff change will likely fail. Ensure the contract item has an active tariff change.
  • Authentication Errors: Missing or incorrect API credentials will cause authorization failures. Confirm that the API key credential is correctly configured.
  • Network Issues: Connectivity problems to the mittwald API endpoint will prevent execution. Check network access and endpoint availability.

Links and References

Discussion