Create a new invoice in Lexware. Set finalize=true to immediately finalize (status "open"); omit or false to create as draft. The Lexware API does not support finalizing an existing draft — this is the only documented way to obtain a finalized invoice.

Retrieve an invoice by ID from Lexware.

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).

Create a new invoice as a follow-up to a preceding sales voucher (quotation, order confirmation, or delivery note). Maps to the documented POST /invoices?precedingSalesVoucherId={id}[&finalize=true] endpoint. Set finalize=true to immediately finalize the new invoice (status "open"); omit or false to create as draft.

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

Create a new credit note in Lexware.

Retrieve a credit note by ID 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).

Create a new credit note as a follow-up to a preceding invoice. Maps to the documented POST /credit-notes?precedingSalesVoucherId={id}[&finalize=true] endpoint. Set finalize=true to immediately finalize the credit note; omit or false to create as draft.

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

Create a new quotation in Lexware.

Retrieve a quotation by ID from Lexware.

Download the PDF file for a quotation.

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

Create a new order confirmation in Lexware.

Retrieve an order confirmation by ID from Lexware.

Download the PDF file for an order confirmation.

Create a new order confirmation as a follow-up to a preceding quotation. Maps to the documented POST /order-confirmations?precedingSalesVoucherId={id} endpoint.

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

Create a new delivery note in Lexware.

Retrieve a delivery note by ID from Lexware.

Download the PDF file for a delivery note.

Create a new delivery note as a follow-up to a preceding quotation or order confirmation. Maps to the documented POST /delivery-notes?precedingSalesVoucherId={id} endpoint.

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

Retrieve a down payment invoice by ID from Lexware.

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).

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

Create a new dunning as a follow-up to a preceding invoice via the documented POST /dunnings?precedingSalesVoucherId={id} endpoint. Dunnings are always created in draft mode and do not need to be finalized.

Retrieve a dunning by ID from Lexware.

Download the PDF file for a dunning.

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

List all articles with optional pagination.

Get a single article by ID.

Create a new article.

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

Delete an article by ID.

List all contacts with optional pagination and filters.

Get a single contact by ID.

Create a new contact.

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

Get a direct URL to view a contact in the Lexware web app.

List all available countries with their tax classifications.

List all available payment conditions.

List all available posting categories for bookkeeping.

Get the organization profile information.

List available print layout templates.

Create a new bookkeeping voucher in 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.

Update an existing bookkeeping voucher in Lexware. Requires version field for optimistic locking.

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.

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.

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

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

Get payment details for a specific voucher.

Create a new webhook event subscription in Lexware.

List all webhook event subscriptions in Lexware.

Retrieve a webhook event subscription by ID from Lexware.

Delete a webhook event subscription from Lexware.

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).

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.

Download a file from Lexware. Returns the file as base64-encoded content.

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.

Get a direct link to the bookkeeping inbox of newly-uploaded files in the Lexware web app.

List recurring invoice templates from Lexware.

Retrieve a recurring invoice template by ID from Lexware.

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