mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node interacts with the mittwald mStudio API to list customer orders related to contracts. Specifically, for the "Contract" resource and the "Order List Customer Orders" operation, it retrieves a paginated list of orders associated with a given customer ID. This is useful in scenarios where you want to automate fetching order data for customers, such as generating reports, syncing order information with other systems, or triggering workflows based on order statuses.

Practical examples include:

  • Fetching all orders for a specific customer to analyze purchasing behavior.
  • Filtering orders by status or template names to process only relevant contracts.
  • Paginating through large sets of orders to handle them in batches.

Properties

Name Meaning
Customer Id The unique identifier of the customer whose orders are to be listed.
Limit Maximum number of orders to retrieve per request (default 1000).
Skip Number of orders to skip before starting to collect the result set (used for pagination).
Page The page number of results to fetch (used for pagination).
Includes Status JSON array specifying which order statuses to include in the results.
Excludes Status JSON array specifying which order statuses to exclude from the results.
Template Names JSON array of template names to filter the orders by (default includes ["WH25-0001"]).

Output

The node outputs JSON data representing the list of customer orders retrieved from the mittwald mStudio API. Each item in the output corresponds to an individual order with its associated details as provided by the API response.

If binary data were involved (e.g., documents or files), it would be summarized here, but this operation focuses on JSON order data only.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de for API requests.
  • No additional external dependencies beyond the configured API authentication.

Troubleshooting

  • Missing or invalid Customer Id: The operation requires a valid customer ID; ensure this is provided and correctly formatted.
  • API authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Pagination issues: If not all orders appear, adjust the Limit, Skip, and Page parameters to navigate through the full dataset.
  • Filtering problems: Ensure that the Includes Status, Excludes Status, and Template Names JSON arrays are properly formatted and contain valid values recognized by the API.
  • Network or API downtime: Check connectivity and mittwald API status if requests fail unexpectedly.

Links and References

Discussion