Lexware icon

Lexware

Interact with the Lexware API
Join our community

Actions41

Overview

The node integrates with the Lexware API to manage various business resources, including vouchers. Specifically, for the Vouchers - Create operation, it allows users to create new voucher records in Lexware. This is useful for automating financial document creation workflows such as issuing payment vouchers or credit notes.

Typical use cases include:

  • Automatically generating vouchers from order or invoice data.
  • Creating vouchers linked to specific contacts and dates.
  • Adding detailed line items to vouchers for accurate accounting.

For example, a user could automate the creation of a voucher with multiple line items representing different products or services sold, specifying quantities, tax rates, discounts, and amounts.

Properties

Name Meaning
Title The title or name of the voucher being created.
Voucher Date The date associated with the voucher (e.g., issue date).
Contact ID Identifier of the contact (customer or vendor) related to the voucher.
Line Items A collection of individual line items included in the voucher. Each item includes:
  Type Type of line item, either "custom" or "text".
  Name Name or label of the line item.
  Description Description providing details about the line item.
  Quantity Number of units for this line item.
  Unit Name Unit of measurement for the quantity (e.g., pcs, hours).
  Net Amount Net amount before taxes and discounts.
  Gross Amount Gross amount including taxes.
  Tax Rate % Tax rate percentage applied to this line item (default 19%).
  Discount % Discount percentage applied to this line item (default 0%).
  Line Item Amount Total amount for the line item after calculations.

Output

The node outputs an array of JSON objects representing the created voucher(s). Each output item typically contains the full details of the newly created voucher as returned by the Lexware API, including assigned IDs, status, and all submitted fields.

If the node supports binary data output (not indicated here), it would represent attachments or documents related to the voucher, but this is not evident from the provided code.

Dependencies

  • Requires an active connection to the Lexware API via an API key credential configured in n8n.
  • The node depends on the Lexware API being accessible and properly authenticated.
  • No other external dependencies are indicated.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect or incomplete voucher data (e.g., missing required fields like Title or Contact ID) may result in API errors.
    • Network connectivity problems can prevent communication with the Lexware API.

  • Error messages:

    • "Unsupported resource: vouchers" — indicates the resource parameter was set incorrectly.
    • API error responses will typically relay validation errors or permission issues; ensure all required fields are correctly filled.

  • Resolutions:

    • Verify API credentials and permissions.
    • Double-check input property values, especially mandatory ones.
    • Ensure network access to Lexware API endpoints.

Links and References

Discussion