mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node interacts with the "Marketplace" resource to list incoming invoices for a specific contributor. It is designed to fetch and filter invoice data related to contributors, which can be useful for financial tracking, accounting automation, or vendor management workflows.

Typical use cases include:

  • Retrieving all incoming invoices for a given contributor to automate payment processing.
  • Searching for specific invoices by number or ID to verify or audit transactions.
  • Paginating through large sets of invoices with sorting options to organize data efficiently.

For example, a user might configure this node to list the last 10 invoices for a contributor, sorted by invoice number in descending order, to review recent billing activity.

Properties

Name Meaning
Contributor Id The unique identifier of the contributor whose incoming invoices are to be listed.
Search A search string to filter invoices by invoice number or ID.
Limit Maximum number of invoices to return in the response.
Skip Number of invoices to skip; used for pagination and should be a multiple of limit.
Page Page number to display; functions similarly to skip. If both page and skip are set, skip takes precedence.
Sort JSON array specifying fields by which to sort the results (e.g., ["invoiceNumber"]).
Order JSON array specifying sort order for each field in Sort, e.g., ["desc"] for descending order.

Output

The node outputs a JSON object containing the list of incoming invoices matching the query parameters. Each invoice item typically includes details such as invoice number, date, amount, and status (though exact fields depend on the API response).

If binary data were involved (e.g., PDF attachments), it would be included in a separate binary property, but this node focuses on JSON invoice data only.

Dependencies

  • Requires an API key credential to authenticate requests against the mittwald mStudio API.
  • The base URL for API requests is https://api.mittwald.de.
  • Uses the n8n OpenAPI integration framework for request building and execution.

Troubleshooting

  • Empty results: Ensure the Contributor Id is correct and that invoices exist for that contributor. Also check if the search parameter is too restrictive.
  • Pagination issues: When using skip and limit, ensure skip is a multiple of limit to avoid unexpected results.
  • Authentication errors: Verify that the API key credential is valid and has necessary permissions.
  • Invalid JSON in Sort or Order: Make sure these fields contain valid JSON arrays; otherwise, the API may reject the request.

Links and References

Discussion