Lexware icon

Lexware

Interact with the Lexware API
Join our community

Actions41

Overview

This node integrates with the Lexware API to create a new quotation by providing JSON data for line items and various quotation details. It is useful in scenarios where users want to automate the creation of quotations in Lexware from structured JSON input, such as generating quotes from CRM data or e-commerce platforms.

Practical examples include:

  • Automatically creating sales quotations based on customer orders.
  • Importing bulk quotation data from external systems via JSON.
  • Generating customized quotations with specific payment terms, tax conditions, and recipient addresses.

Properties

Name Meaning
Title The title of the quotation.
Introduction An introductory text or description for the quotation.
Remark Additional remarks or notes related to the quotation.
Voucher Date The date when the quotation voucher is issued.
Expiry Date The date until which the quotation remains valid.
Contact ID The identifier of the recipient contact in Lexware (alternative to specifying manual address).
Manual Address Manual address details as an alternative to Contact ID, including: Name, Supplement (e.g., department), Street, City, ZIP Code, and ISO Country Code (default "DE").
Total Price Currency code for the total price; amounts are automatically calculated by Lexware.
Tax Conditions Tax type options: "net" or "gross", plus an optional note describing the tax condition.
Payment Conditions Payment term label (e.g., "10 Tage - 3 %, 30 Tage netto"), duration in days, and optional discount conditions including discount percentage and discount eligibility period in days.
Line Items JSON A JSON array representing the line items of the quotation. Each item should be an object describing individual products or services included in the quotation.

Output

The node outputs an array of JSON objects representing the created quotation(s) as returned by the Lexware API. The exact structure depends on the API response but typically includes identifiers, status, and details of the created quotation.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Lexware API using an API key or authentication token configured in n8n credentials.
  • The node depends on the Lexware API being accessible and properly authenticated.
  • No additional external dependencies beyond the Lexware API and its credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Malformed JSON in the "Line Items JSON" property can lead to parsing errors.
    • Providing both Contact ID and Manual Address incorrectly may cause conflicts; only one should be used.
    • Missing required fields like currency in Total Price or invalid date formats can cause API rejections.

  • Error messages:

    • Authentication errors: Check that the API key/token is correctly set up in n8n credentials.
    • Validation errors from the API: Verify all required fields are provided and formatted correctly.
    • JSON parse errors: Ensure the "Line Items JSON" is valid JSON syntax.

Links and References

Discussion