mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node interacts with the mittwald mStudio API to update invoice settings for a specific contract. It is designed to modify various invoice-related parameters such as customer identification, invoice period, payment details, recipient information, and preferences for printed invoices.

Typical use cases include automating updates to billing configurations when customer details change, adjusting invoice delivery options, or modifying payment methods programmatically within an n8n workflow.

For example, you could use this node to:

  • Change the invoice recipient address after a customer moves.
  • Add additional email recipients who should receive invoice copies.
  • Update payment settings like IBAN or account holder information.
  • Enable or disable printed invoices for a contract.

Properties

Name Meaning
Customer Id The unique identifier of the customer whose contract invoice settings are being updated.
Additional Email Recipients A JSON array of email addresses to receive additional copies of the invoice.
Invoice Period Number representing the billing cycle period (e.g., 1 for monthly).
Payment Settings An object containing payment details such as account holder name, BIC, IBAN, and payment method.
Printed Invoices Boolean flag indicating whether printed invoices should be generated (true) or not (false).
Recipient A JSON object describing the invoice recipient's contact details including address, company, and phone numbers.
Recipient Same As Owner Boolean flag indicating if the invoice recipient is the same as the contract owner.
Target Day A number representing the target day for invoicing; marked as deprecated and ignored by the API.

Output

The node outputs JSON data reflecting the response from the mittwald mStudio API after updating the invoice settings. This typically includes confirmation of the updated contract invoice configuration or error details if the update failed.

No binary data output is indicated in the source code or properties.

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.
  • The node depends on the @devlikeapro/n8n-openapi-node package and an OpenAPI specification (openapi.json) bundled with the node for request building.

Troubleshooting

  • Invalid Customer Id: If the provided customer ID does not exist or is incorrect, the API will likely return an error. Verify the customer ID before running the node.
  • Malformed JSON Inputs: Properties like additionalEmailRecipients and recipient expect valid JSON strings. Invalid JSON will cause parsing errors. Ensure these inputs are correctly formatted.
  • Deprecated Parameter Warning: The targetDay property is deprecated and ignored by the API. Including it has no effect but should not cause errors.
  • Authentication Errors: Missing or invalid API credentials will prevent successful API calls. Confirm that the API key credential is configured properly in n8n.
  • Network Issues: Connectivity problems to https://api.mittwald.de will cause request failures. Check network access and proxy settings if applicable.

Links and References

Discussion