Lexware

Get a direct link to view/edit an invoice in the Lexware web app.

Get a direct link to view/edit an order confirmation in the Lexware web app.

Get a direct link to view/edit a quotation in the Lexware web app.

Get a direct link to view/edit a recurring invoice template in the Lexware web app.

Get a direct link to view/edit a bookkeeping voucher in the Lexware web app.

Delete an article by ID.

Delete a webhook event subscription from Lexware.

Download the file for a credit note. Defaults to PDF; pass format="xml" to request the XRechnung XML e-invoice when available (the API returns whatever representation it can render).

Download the PDF file for a delivery note.

Download the file for a down payment invoice. Defaults to PDF; pass format="xml" to request the XRechnung XML e-invoice when available (the API returns whatever representation it can render).

Download the PDF file for a dunning.

Download a file from Lexware as base64-encoded content. Choose pdf (default) or xml for an available e-invoice XML original.

Download the file for an invoice. Defaults to PDF; pass format="xml" to request the XRechnung XML e-invoice when available (the API returns whatever representation it can render).

Download the PDF file for an order confirmation.

Download the PDF file for a quotation.

Get a single article by ID.

Get a single contact by ID.

Retrieve a credit note by ID from Lexware.

Retrieve a delivery note by ID from Lexware.

Retrieve a down payment invoice by ID from Lexware.

Retrieve a dunning by ID from Lexware.

Retrieve a webhook event subscription by ID from Lexware.

Get the processing status of an uploaded file from Lexware. Requires an API key with the file-status scope; keys without it get an access_denied error from Lexware.

Retrieve an invoice by ID from Lexware.

Retrieve an order confirmation by ID from Lexware.

Get payment details for a specific voucher.

Get the organization profile information.

Retrieve a quotation by ID from Lexware.

Retrieve a recurring invoice template by ID from Lexware.

Retrieve a bookkeeping voucher by ID from Lexware. The voucherStatus field in the response is normalized to its canonical lowercase form. Known values: unchecked, open, paid, paidoff, voided, transferred, sepadebit. Retries up to 3 times (1 s / 2 s / 4 s) on 404 to absorb the indexing delay after an upload; if the voucher is still missing, returns { voucherId, status: "processing", message } rather than an error. Other failures are reported as errors.

List all articles with optional pagination.

List all contacts with optional pagination and filters.

List all available countries with their tax classifications.

List all webhook event subscriptions in Lexware.

List all available payment conditions.

List all available posting categories for bookkeeping.

List available print layout templates.

List recurring invoice templates from Lexware.

Search and filter across all voucher types in Lexware. This is the main way to find invoices, credit notes, quotations, and other voucher types.

Look up bookkeeping vouchers by voucher number. GET /vouchers is a LOOKUP endpoint, not a browsable collection: the Lexware API rejects any call without voucherNumber with HTTP 400 "voucherNumber parameter is required". To browse or filter vouchers, use lexware_list_voucherlist, which is the collection endpoint and carries the summary fields (contactName, openAmount) that /vouchers does not.

Create a new credit note from an invoice via `POST /credit-notes?precedingSalesVoucherId={id}[&finalize=true]`; finalize=true finalizes the credit note, false or omitted creates a draft. In introduction, lineItems[].description, and remark, use only Lexware formatting: **bold**, __italic__, and dash-prefixed list items separated by newlines.

Create a new delivery note from a quotation or order confirmation via `POST /delivery-notes?precedingSalesVoucherId={id}`. In introduction, lineItems[].description, and remark, use only Lexware formatting: **bold**, __italic__, and dash-prefixed list items separated by newlines.

Create a new dunning from an invoice via `POST /dunnings?precedingSalesVoucherId={id}`; dunnings are always created as drafts and do not need finalization. In introduction, lineItems[].description, and remark, use only Lexware formatting: **bold**, __italic__, and dash-prefixed list items separated by newlines.

Create a new invoice from a quotation, order confirmation, or delivery note via `POST /invoices?precedingSalesVoucherId={id}[&finalize=true]`; finalize=true creates status "open", false or omitted creates a draft. In introduction, lineItems[].description, and remark, use only Lexware formatting: **bold**, __italic__, and dash-prefixed list items separated by newlines.

Create a new order confirmation from a quotation via `POST /order-confirmations?precedingSalesVoucherId={id}`. In introduction, lineItems[].description, and remark, use only Lexware formatting: **bold**, __italic__, and dash-prefixed list items separated by newlines.

Update an article with the current version field for optimistic locking. Only description supports Lexware formatting (**bold**, __italic__, and dash-prefixed list items separated by newlines); article title does not support formatting.

Update an existing contact. The body must include the version field for optimistic locking.

Update a bookkeeping voucher with the current version for optimistic locking. If the existing voucher is unchecked, the update must transition voucherStatus to open.

Upload a file to Lexware. Provide either filePath (absolute path on the MCP server host) or contentBase64 (base64-encoded content) — not both. When using filePath, fileName is optional (derived from the file name) and contentType is auto-detected for common image extensions. When using contentBase64, fileName is required.

Upload a file attachment to a bookkeeping voucher. Provide either filePath (absolute path on the MCP server host) or contentBase64 (base64-encoded content) — not both. When using filePath, fileName is optional (derived from the file name) and contentType is auto-detected for common image extensions. When using contentBase64, fileName is required.

Verify a Lexware webhook X-Lxo-Signature (RSA-SHA512, base64) against the raw request body. Pass the EXACT raw HTTP body bytes you received — do not JSON.parse/stringify round-trip, as Lexware signs the compact JSON as transmitted (whitespace and key order matter). On first call the public key is fetched once from developers.lexware.io and cached for the process lifetime; set LEXWARE_WEBHOOK_PUBLIC_KEY (PEM) to override (recommended for production where you cannot tolerate one-time TLS-substitution risk on the public-key fetch).