Lexware icon

Lexware

Interact with the Lexware API
Join our community

Actions41

Overview

This node integrates with the Lexware API to manage invoices, specifically supporting operations such as updating existing invoices. The "Update Invoice" operation allows users to modify details of an invoice by specifying its ID and providing new values for various fields like title, introduction text, line items, payment conditions, and more.

Common scenarios where this node is beneficial include:

  • Automating invoice updates in accounting workflows.
  • Synchronizing invoice data between Lexware and other systems.
  • Adjusting invoice details programmatically based on business logic or external triggers.

For example, a user might update an invoice's line items after receiving additional order information or change payment terms dynamically based on customer agreements.

Properties

Name Meaning
Invoice ID The unique identifier of the invoice to update (required).
Title The title or subject of the invoice.
Introduction Introductory text shown on the invoice, typically describing the purpose or context.
Remark A remark or footer note displayed on the invoice.
Voucher Date The date associated with the invoice voucher.
Contact ID The recipient contact's unique identifier.
Line Items A collection of invoice line items. Each item includes:
- Type: "Custom" or "Text"
- Name: Item name
- Description: Item description
- Quantity: Number of units
- Unit Name: Unit label
- Unit Price: Currency, net amount, gross amount, tax rate percentage
- Discount %: Discount applied to the item
Total Price Overall pricing summary including:
- Currency
- Total Net Amount
- Total Gross Amount
- Total Tax Amount
Tax Conditions Tax-related settings:
- Tax Type: "net" or "gross"
- Tax Type Note: Additional notes about tax
Payment Conditions Payment terms and discounts:
- Payment Term Label: Description of payment term
- Payment Term Duration: Duration in days
- Discount Conditions: Discount percentage and applicable day range
Shipping Conditions Shipping details:
- Shipping Date
- Shipping End Date
- Shipping Type (e.g., delivery)
xRechnung (JSON) Optional JSON object to override buyer reference for electronic invoicing compliance (xRechnung standard).

Output

The node outputs an array of JSON objects representing the updated invoice(s) returned from the Lexware API. Each output item contains the full invoice data reflecting the changes made, including updated fields and metadata.

If the node supports binary data output (not indicated here), it would typically represent files such as PDF versions of invoices or related documents.

Dependencies

  • Requires an active connection to the Lexware API via an API key credential configured in n8n.
  • The node depends on the Lexware service being accessible and the API credentials having sufficient permissions to update invoices.
  • No additional external dependencies are indicated beyond the Lexware API.

Troubleshooting

  • Common Issues:

    • Invalid or missing Invoice ID will cause the update to fail.
    • Providing invalid field formats (e.g., incorrect date format) may result in API errors.
    • Insufficient permissions or expired API credentials can lead to authentication errors.
    • Network connectivity issues may prevent communication with the Lexware API.

  • Error Messages:

    • "Unsupported resource: invoices" — This indicates a misconfiguration of the resource parameter; ensure "invoices" is selected.
    • API error responses typically include messages about invalid input or authorization failures; verify all required fields and credentials.

  • Resolution Tips:

    • Double-check that the Invoice ID corresponds to an existing invoice.
    • Validate all input fields against expected types and formats.
    • Refresh or reconfigure API credentials if authentication errors occur.
    • Test network connectivity to the Lexware API endpoint.

Links and References

Discussion