> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lexoffice

> Lexoffice is a cloud-based accounting software designed for freelancers and small businesses, offering invoicing, expense management, and integration with banks

![Lexoffice logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/lexoffice.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=ec9d6576d81e8129ed7e66b3c3a81ac5)

* **Category:** accounting
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 44
* **Triggers:** 0
* **Slug:** `LEXOFFICE`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Article
>
> **Slug:** `LEXOFFICE_CREATE_ARTICLE`
>
> Tool to create a new article (product or service) in Lexoffice. Use when you need to add items to the product/service catalog for invoicing or quotations. The leadingPrice field must be uppercase (NET or GROSS).
>
> #### Input Parameters
>
> **type** `string ("PRODUCT" | "SERVICE")` *required*
>
> Type of article: PRODUCT for physical goods or SERVICE for services.
>
> **price** `object` *required*
>
> Price information including net/gross price, tax rate, and which price is leading.
>
> **title** `string` *required*
>
> The title/name of the article (product or service).
>
> **unitName** `string` *required*
>
> Unit of measurement for the article (e.g., piece, hour, kg, meter). This field is required by the Lexoffice API.
>
> **articleNumber** `string`
>
> Optional article number for internal identification. If not provided, Lexoffice will auto-generate one.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create contact
>
> **Slug:** `LEXOFFICE_CREATE_CONTACT`
>
> Tool to create a new contact (customer or vendor) in Lexoffice. Use when you need to add a new business contact. Either company or person details must be provided, and at least one role (customer/vendor) must be assigned.
>
> #### Input Parameters
>
> **note** `string`
>
> Additional notes about the contact (maximum 1000 characters)
>
> **roles** `object` *required*
>
> Contact roles - must contain at least one role (customer and/or vendor)
>
> **person** `object`
>
> Person contact details - mutually exclusive with company.
>
> **company** `object`
>
> Company contact details - mutually exclusive with person.
>
> **version** `integer`
>
> Version number (must be 0 for new contacts)
>
> **addresses** `object`
>
> Container for billing and shipping addresses.
>
> **xRechnung** `object`
>
> XRechnung-specific fields for electronic invoicing.
>
> **phoneNumbers** `object`
>
> Phone numbers organized by type.
>
> **emailAddresses** `object`
>
> Email addresses organized by type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Credit Note
>
> **Slug:** `LEXOFFICE_CREATE_CREDIT_NOTE`
>
> Tool to create a credit note in Lexoffice. Credit notes are created in draft mode by default; set finalize=true to create with status 'open'. Use when you need to issue a refund or credit for an invoice. Maximum 300 line items per credit note.
>
> #### Input Parameters
>
> **title** `string`
>
> Title of the credit note. Organization default is used if omitted.
>
> **remark** `string`
>
> Additional remarks. Organization default is used if omitted.
>
> **address** `object` *required*
>
> Recipient address information. Either contactId must be provided, or name/street/city/zip/countryCode.
>
> **archived** `boolean`
>
> Whether the credit note should be archived. Defaults to false.
>
> **finalize** `boolean`
>
> If true, creates a finalized credit note with status 'open'. If false or omitted, creates a draft credit note. Note: Status cannot be changed via API after creation.
>
> **language** `string`
>
> ISO 639-1 language code. Defaults to 'de'.
>
> **lineItems** `array` *required*
>
> List of line items in the credit note. Maximum 300 items per credit note.
>
> **totalPrice** `object` *required*
>
> Total price information with currency specification.
>
> **voucherDate** `string` *required*
>
> Date of the credit note in RFC 3339/ISO 8601 format (yyyy-MM-ddTHH:mm:ss.SSSXXX).
>
> **introduction** `string`
>
> Introduction text. Organization default is used if omitted. Recommended to include invoice number if related to an invoice.
>
> **printLayoutId** `string`
>
> UUID of the print layout to use. Organization default is used if omitted.
>
> **taxConditions** `object` *required*
>
> Tax conditions defining tax type and related settings.
>
> **totalDiscountAbsolute** `number`
>
> Absolute discount amount. Maximum 2 decimal places.
>
> **totalDiscountPercentage** `number`
>
> Percentage discount. Maximum 2 decimal places.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Delivery Note
>
> **Slug:** `LEXOFFICE_CREATE_DELIVERY_NOTE`
>
> Create a delivery note in lexoffice. Delivery notes are created in draft mode by default (set finalize=true for open status). Use when shipping goods or providing services and need to document what was delivered without prices/payment terms. Maximum 300 line items allowed per delivery note.
>
> #### Input Parameters
>
> **title** `string`
>
> Title of the delivery note. Organization default is used if omitted.
>
> **remark** `string`
>
> Additional remarks or notes for the delivery note.
>
> **address** `object` *required*
>
> Customer address. Either provide contactId for existing contact OR (name + countryCode) for one-time address.
>
> **archived** `boolean`
>
> Whether to archive the delivery note immediately after creation. Defaults to false.
>
> **finalize** `boolean`
>
> If true, creates a finalized delivery note with status 'open'. If false (default), creates in draft mode.
>
> **language** `string ("de" | "en")`
>
> Language for the delivery note.
>
> **lineItems** `array` *required*
>
> List of items in the delivery note. Maximum 300 items allowed.
>
> **voucherDate** `string` *required*
>
> Date of the delivery note in ISO format (yyyy-MM-ddTHH:mm:ss.SSSXXX).
>
> **introduction** `string`
>
> Introduction text shown at the beginning of the delivery note.
>
> **deliveryTerms** `string`
>
> Delivery terms and conditions description.
>
> **printLayoutId** `string`
>
> UUID of the print layout template to use. Organization default is used if omitted.
>
> **taxConditions** `object` *required*
>
> Tax settings for the delivery note.
>
> **shippingConditions** `object` *required*
>
> Shipping details including date and type. Required for delivery notes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Event Subscription
>
> **Slug:** `LEXOFFICE_CREATE_EVENT_SUBSCRIPTION`
>
> Tool to register a new webhook for Lexoffice events. Use when you need to receive real-time notifications for specific events like invoice creation, contact changes, or payment updates.
>
> #### Input Parameters
>
> **eventType** `string ("article.created" | "article.changed" | "article.deleted" | "contact.created" | "contact.changed" | "contact.deleted" | "credit-note.created" | "credit-note.changed" | "credit-note.deleted" | "credit-note.status.changed" | "delivery-note.created" | "delivery-note.changed" | "delivery-note.deleted" | "down-payment-invoice.created" | "down-payment-invoice.changed" | "down-payment-invoice.deleted" | "down-payment-invoice.status.changed" | "dunning.created" | "dunning.changed" | "dunning.deleted" | "invoice.created" | "invoice.changed" | "invoice.deleted" | "invoice.status.changed" | "order-confirmation.created" | "order-confirmation.changed" | "order-confirmation.deleted" | "order-confirmation.status.changed" | "payment.changed" | "quotation.created" | "quotation.changed" | "quotation.deleted" | "quotation.status.changed" | "recurring-template.created" | "recurring-template.changed" | "recurring-template.deleted" | "token.revoked" | "voucher.created" | "voucher.changed" | "voucher.deleted" | "voucher.status.changed")` *required*
>
> The type of event to subscribe to. When this event occurs, a notification will be sent to the callback URL
>
> **callbackUrl** `string` *required*
>
> The HTTPS URL where Lexoffice will send webhook notifications when the specified event occurs
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Invoice
>
> **Slug:** `LEXOFFICE_CREATE_INVOICE`
>
> Create a Lexware invoice as an editable draft by default, or set finalize=true to irreversibly create it as open and no longer editable; finalization generates its document representation but does not email the invoice.
>
> #### Input Parameters
>
> **title** `string`
>
> Optional invoice title; the organization default applies if omitted.
>
> **remark** `string`
>
> Optional formatted closing remark; the organization default applies if omitted.
>
> **address** `object` *required*
>
> Referenced-contact or one-time billing address.
>
> **finalize** `boolean`
>
> Set true to create the invoice immediately as open/finalized and no longer editable. Omit it to create an editable draft. Finalization does not email the invoice.
>
> **language** `string ("de" | "en")`
>
> Invoice language; defaults to German (de).
>
> **line\_items** `array` *required*
>
> Invoice line-item list.
>
> **x\_rechnung** `object`
>
> Optional XRechnung settings for an XRechnung-enabled referenced contact.
>
> **total\_price** `object` *required*
>
> Invoice currency and optional overall discount; calculated totals are read-only and cannot be supplied.
>
> **introduction** `string`
>
> Optional formatted introductory text; the organization default applies if omitted.
>
> **voucher\_date** `string` *required*
>
> Invoice voucher timestamp in RFC3339 format (yyyy-MM-ddTHH:mm:ss.SSSXXX).
>
> **tax\_conditions** `object` *required*
>
> Tax treatment for the invoice.
>
> **print\_layout\_id** `string`
>
> Optional print-layout ID; the organization default applies if omitted.
>
> **payment\_conditions** `object`
>
> Optional payment terms; organization or contact defaults apply if omitted.
>
> **shipping\_conditions** `object` *required*
>
> Service or delivery timing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Order Confirmation
>
> **Slug:** `LEXOFFICE_CREATE_ORDER_CONFIRMATION`
>
> Create a draft order confirmation in Lexoffice with line items, pricing, and shipping details.
>
> #### Input Parameters
>
> **title** `string`
>
> Document title/heading
>
> **remark** `string`
>
> Closing remark or additional notes
>
> **address** `object` *required*
>
> Recipient address details
>
> **archived** `boolean`
>
> Whether the order confirmation should be archived immediately after creation
>
> **language** `string ("de" | "en")`
>
> Document language (de for German, en for English). Defaults to de if not specified.
>
> **lineItems** `array` *required*
>
> List of line items for the order confirmation (maximum 300 items)
>
> **totalPrice** `object` *required*
>
> Total price details
>
> **voucherDate** `string` *required*
>
> Document date in RFC 3339/ISO 8601 format (yyyy-MM-ddTHH:mm:ss.SSSXXX)
>
> **introduction** `string`
>
> Introduction text that appears at the beginning of the document
>
> **deliveryTerms** `string`
>
> Delivery terms description
>
> **printLayoutId** `string`
>
> UUID of custom print template to use
>
> **taxConditions** `object` *required*
>
> Tax conditions for the order confirmation
>
> **shippingConditions** `object` *required*
>
> Shipping conditions for the order confirmation
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Quotation
>
> **Slug:** `LEXOFFICE_CREATE_QUOTATION`
>
> Tool to create a quotation in Lexoffice. Quotations are created in draft mode by default. Use the finalize parameter to create a finalized quotation with status 'open'. Requires address with either contactId or name+countryCode, line items, total pricing, and tax conditions.
>
> #### Input Parameters
>
> **title** `string`
>
> Quotation title
>
> **remark** `string`
>
> Closing remark for the quotation
>
> **address** `object` *required*
>
> Recipient address details
>
> **finalize** `boolean`
>
> Set to true to create a finalized quotation with status 'open'. If false, quotation is created in draft mode
>
> **language** `string ("de" | "en")`
>
> Quotation language
>
> **lineItems** `array` *required*
>
> List of line items in the quotation (maximum 300 items)
>
> **totalPrice** `object` *required*
>
> Total pricing information
>
> **voucherDate** `string` *required*
>
> Quotation date in RFC 3339/ISO 8601 format (e.g., '2026-02-13T10:00:00.000+01:00')
>
> **introduction** `string`
>
> Introduction text for the quotation
>
> **deliveryTerms** `string`
>
> Delivery terms text
>
> **printLayoutId** `string`
>
> UUID of the print layout to use
>
> **taxConditions** `object` *required*
>
> Tax conditions
>
> **expirationDate** `string` *required*
>
> Quotation expiration date in RFC 3339/ISO 8601 format (REQUIRED)
>
> **shippingConditions** `string`
>
> Shipping conditions text
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Voucher
>
> **Slug:** `LEXOFFICE_CREATE_VOUCHER`
>
> Tool to create a bookkeeping voucher in Lexoffice. Use when you need to create expense receipts, sales invoices, purchase invoices, or other accounting vouchers. The voucher requires line items with amounts, tax rates, and posting category IDs.
>
> #### Input Parameters
>
> **type** `string ("salesinvoice" | "salescreditnote" | "purchaseinvoice" | "purchasecreditnote" | "invoice" | "downpaymentinvoice" | "creditnote" | "orderconfirmation" | "quotation" | "deliverynote")` *required*
>
> Type of voucher to create (e.g., salesinvoice, purchaseinvoice)
>
> **remark** `string`
>
> Additional remarks or notes for the voucher
>
> **dueDate** `string`
>
> Due date for the voucher in ISO 8601 format (YYYY-MM-DD)
>
> **taxType** `string ("net" | "gross")` *required*
>
> Tax calculation type - 'gross' for amounts including tax, 'net' for amounts excluding tax
>
> **contactId** `string`
>
> UUID of the contact (customer or vendor) associated with this voucher
>
> **voucherDate** `string`
>
> Date of the voucher in ISO 8601 format (YYYY-MM-DD)
>
> **shippingDate** `string`
>
> Shipping date in ISO 8601 format (YYYY-MM-DD)
>
> **voucherItems** `array` *required*
>
> List of line items for the voucher with amounts and tax information (minimum 1 item required)
>
> **voucherNumber** `string`
>
> Custom voucher number/reference
>
> **voucherStatus** `string ("unchecked" | "open")`
>
> Status of the voucher
>
> **totalTaxAmount** `number`
>
> Total tax amount of the voucher (sum of all item tax amounts)
>
> **totalGrossAmount** `number`
>
> Total gross amount of the voucher (sum of all item amounts if taxType is gross)
>
> **useCollectiveContact** `boolean`
>
> Whether to use a collective contact instead of a specific contact
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Article
>
> **Slug:** `LEXOFFICE_DELETE_ARTICLE`
>
> Tool to permanently delete an article by its ID. Returns success confirmation on 204, or raises error if article not found (404).
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the article to delete. Use List Articles or Get Article actions to find valid article IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Event Subscription
>
> **Slug:** `LEXOFFICE_DELETE_EVENT_SUBSCRIPTION`
>
> Tool to delete an event subscription by its ID. Use when you need to remove an existing event subscription from Lexoffice.
>
> #### Input Parameters
>
> **subscription\_id** `string` *required*
>
> The unique identifier of the event subscription to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download File
>
> **Slug:** `LEXOFFICE_DOWNLOAD_FILE`
>
> Download a file by ID from Lexoffice, with the returned format depending on the requested Accept type. This endpoint is intended for bookkeeping voucher documents and is deprecated for sales voucher documents.
>
> #### Input Parameters
>
> **accept** `string ("*/*" | "application/xml" | "application/pdf" | "image/jpeg" | "image/png")`
>
> The desired content type for the downloaded file. Use this to specify the format you want to receive.
>
> **file\_id** `string` *required*
>
> The unique identifier of the file to download. This ID is typically obtained from invoice, voucher, or other document endpoints that return file references.
>
> **file\_name** `string`
>
> Optional filename for the downloaded file. If not provided, defaults to 'file\_\{file\_id}' with appropriate extension based on content type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Article
>
> **Slug:** `LEXOFFICE_GET_ARTICLE`
>
> Tool to retrieve an article by ID from Lexoffice. Use when you need to fetch details of a specific article including its price, type, and other metadata.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the article to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact
>
> **Slug:** `LEXOFFICE_GET_CONTACT`
>
> Tool to retrieve a specific contact by its ID. Use when you need to fetch detailed information about a contact.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique ID of the contact to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credit Note
>
> **Slug:** `LEXOFFICE_GET_CREDIT_NOTE`
>
> Tool to retrieve a credit note by its UUID from Lexoffice. Use when you need to fetch details of a specific credit note. Credit notes can be in draft or finalized (open) mode.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the credit note to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credit Note Document
>
> **Slug:** `LEXOFFICE_GET_CREDIT_NOTE_DOCUMENT`
>
> Render a finalized credit note PDF and retrieve its document file ID using the deprecated credit note document endpoint. Draft credit notes cannot be rendered.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier (UUID) of the credit note. The credit note must be in 'open' status (not 'draft') for document rendering to work.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Delivery Note
>
> **Slug:** `LEXOFFICE_GET_DELIVERY_NOTE`
>
> Retrieve a delivery note by ID from Lexoffice, including available address, line item and tax information.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier (UUID) of the delivery note to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Delivery Note Document
>
> **Slug:** `LEXOFFICE_GET_DELIVERY_NOTE_DOCUMENT`
>
> Render a finalized delivery note PDF and retrieve its file ID using the deprecated delivery note document endpoint. Draft delivery notes cannot be rendered.
>
> #### Input Parameters
>
> **deliveryNoteId** `string` *required*
>
> Unique identifier (UUID format) of the delivery note to render. The delivery note must be finalized (not in draft status) for the document endpoint to work.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Dunning
>
> **Slug:** `LEXOFFICE_GET_DUNNING`
>
> Tool to retrieve a dunning document by its ID. Use when you need to fetch details of a specific dunning from Lexoffice.
>
> #### Input Parameters
>
> **dunningsid** `string` *required*
>
> The unique identifier of the dunning to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Dunning Document
>
> **Slug:** `LEXOFFICE_GET_DUNNING_DOCUMENT`
>
> Render a dunning PDF by ID and retrieve its document file reference for downloading. The document-rendering endpoint is deprecated.
>
> #### Input Parameters
>
> **dunningsid** `string` *required*
>
> The unique identifier of the dunning for which to render the document. Must be a valid UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Event Subscription
>
> **Slug:** `LEXOFFICE_GET_EVENT_SUBSCRIPTION`
>
> Tool to retrieve a specific event subscription by its ID. Use when you need to get details about an existing event subscription.
>
> #### Input Parameters
>
> **subscription\_id** `string` *required*
>
> The unique identifier of the event subscription to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Invoice
>
> **Slug:** `LEXOFFICE_GET_INVOICE`
>
> Tool to retrieve a specific invoice by its UUID. Use when you need to fetch detailed information about an invoice including line items, pricing, and payment terms.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the invoice to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Invoice Document
>
> **Slug:** `LEXOFFICE_GET_INVOICE_DOCUMENT`
>
> Render an invoice PDF by invoice ID and retrieve its document file reference for downloading. The document-rendering endpoint is deprecated and does not support draft invoices.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier (UUID) of the invoice to render as PDF. This triggers the PDF document file rendering for invoices in 'open' status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Order Confirmation
>
> **Slug:** `LEXOFFICE_GET_ORDER_CONFIRMATION`
>
> Retrieve an order confirmation by ID, including line items, pricing, recipient address, and payment terms.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier (UUID) of the order confirmation to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Render Order Confirmation Document
>
> **Slug:** `LEXOFFICE_GET_ORDER_CONFIRMATION_DOCUMENT`
>
> Render an order confirmation PDF by ID and return its document file reference for downloading. The document-rendering endpoint is deprecated and does not support draft order confirmations.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier (UUID) of the order confirmation for which to render the PDF document.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Payment Information
>
> **Slug:** `LEXOFFICE_GET_PAYMENT`
>
> Tool to retrieve payment information for a specific voucher (invoice or credit note) from Lexoffice. Use when you need to check payment status, outstanding amounts, or view payment transaction details for bookkeeping or sales vouchers.
>
> #### Input Parameters
>
> **voucher\_id** `string` *required*
>
> Unique identifier of the voucher (invoice or credit note) to retrieve payment information for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Profile
>
> **Slug:** `LEXOFFICE_GET_PROFILE`
>
> Retrieves the user and company profile information from Lexoffice. Use this action to get account details, enabled features, subscription status, and company information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Quotation
>
> **Slug:** `LEXOFFICE_GET_QUOTATION`
>
> Tool to retrieve a quotation by its ID. Use when you need to fetch details of a specific quotation including line items, pricing, and payment terms.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the quotation to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Quotation Document
>
> **Slug:** `LEXOFFICE_GET_QUOTATION_DOCUMENT`
>
> Tool to render a quotation document as a PDF file. Triggers the PDF document file rendering for newly created quotations in status open. Returns a document file ID that can be used to download the PDF.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier (UUID) of the quotation for which to render the PDF document.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Voucher
>
> **Slug:** `LEXOFFICE_GET_VOUCHER`
>
> Retrieve a bookkeeping voucher by UUID, including its financial and item details. This covers bookkeeping sales and purchase invoices and credit notes.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the voucher to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Articles
>
> **Slug:** `LEXOFFICE_LIST_ARTICLES`
>
> Tool to list articles from Lexoffice using filters and pagination. Use when you need to retrieve articles filtered by articleNumber, gtin, or type (PRODUCT/SERVICE). Supports pagination with page and size parameters.
>
> #### Input Parameters
>
> **gtin** `string`
>
> Filter by Global Trade Item Number (GTIN) of the article.
>
> **page** `integer`
>
> Specify the page number for pagination (zero-indexed). Default is 0.
>
> **size** `integer`
>
> Specify the number of articles per page. Maximum is 25.
>
> **sort** `string`
>
> Specify the sort order for results. Format: 'property,direction' (e.g., 'title,asc' or 'createdDate,desc').
>
> **type** `string ("PRODUCT" | "SERVICE")`
>
> Article type enumeration.
>
> **article\_number** `string`
>
> Filter by article number as given by the user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `LEXOFFICE_LIST_CONTACTS`
>
> List a page of Lexoffice contacts with optional filters for number, email, name, vendor status, or customer status. Use pagination to retrieve additional pages.
>
> #### Input Parameters
>
> **name** `string`
>
> Filter by name
>
> **page** `integer`
>
> Page number for pagination
>
> **size** `integer`
>
> Number of records per page
>
> **sort** `string`
>
> Sort field and direction (e.g., 'name,asc' or 'number,desc')
>
> **email** `string`
>
> Filter by email address
>
> **number** `integer`
>
> Filter by contact number
>
> **vendor** `boolean`
>
> Filter by vendor status
>
> **customer** `boolean`
>
> Filter by customer status
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Countries
>
> **Slug:** `LEXOFFICE_LIST_COUNTRIES`
>
> Tool to retrieve the list of all available countries with tax classifications from Lexoffice. Use when you need to get country information for invoicing, tax calculations, or address validation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Event Subscriptions
>
> **Slug:** `LEXOFFICE_LIST_EVENT_SUBSCRIPTIONS`
>
> Tool to retrieve all event subscriptions for the current access token. Use when you need to inspect configured webhook subscriptions for events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Payment Conditions
>
> **Slug:** `LEXOFFICE_LIST_PAYMENT_CONDITIONS`
>
> Tool to retrieve list of currently configured payment conditions from Lexoffice. Use when you need to view all payment terms and conditions set up in the organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Posting Categories
>
> **Slug:** `LEXOFFICE_LIST_POSTING_CATEGORIES`
>
> Tool to retrieve the list of posting categories for bookkeeping vouchers (revenue or expense) supported in lexoffice. Use when you need to get available posting categories for creating or updating vouchers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Print Layouts
>
> **Slug:** `LEXOFFICE_LIST_PRINT_LAYOUTS`
>
> Tool to retrieve all print layouts for invoices and other documents. Use when you need to list available print layouts that can be referenced when creating sales vouchers (invoices, delivery notes, credit notes, etc.).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Recurring Templates
>
> **Slug:** `LEXOFFICE_LIST_RECURRING_TEMPLATES`
>
> Tool to retrieve all recurring templates from Lexoffice. Use when you need to list recurring invoice templates with pagination and sorting options.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (zero-indexed)
>
> **size** `integer`
>
> Number of records per page
>
> **sort** `string`
>
> Sort field and direction (e.g., 'title,asc' or 'createdDate,desc')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Voucherlist
>
> **Slug:** `LEXOFFICE_LIST_VOUCHERLIST`
>
> Retrieve a page of Lexoffice voucher metadata, including bookkeeping vouchers, invoices, credit notes, order confirmations, quotations, and delivery notes. Filter by type, status, archive state, contact, dates, or voucher number, and control sorting and pagination. Pages are zero-indexed and contain up to 250 entries.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (zero-indexed). Default is 0.
>
> **size** `integer`
>
> Number of vouchers per page. Maximum is 250.
>
> **sort** `string`
>
> Sort field and direction (e.g., 'voucherNumber,DESC' or 'voucherDate,ASC').
>
> **archived** `boolean`
>
> Filter by archived status. Set to true for archived vouchers, false for non-archived.
>
> **contactId** `string`
>
> Filter by contact ID (UUID format).
>
> **voucherType** `string ("any" | "salesinvoice" | "salescreditnote" | "purchaseinvoice" | "purchasecreditnote" | "invoice" | "creditnote" | "orderconfirmation" | "quotation" | "downpaymentinvoice" | "deliverynote")`
>
> Filter by voucher type (salesinvoice, invoice, creditnote, etc.).
>
> **createdDateTo** `string`
>
> Filter by created date to (ISO date format: YYYY-MM-DD).
>
> **updatedDateTo** `string`
>
> Filter by updated date to (ISO date format: YYYY-MM-DD).
>
> **voucherDateTo** `string`
>
> Filter by voucher date to (ISO date format: YYYY-MM-DD).
>
> **voucherNumber** `string`
>
> Filter by specific voucher number.
>
> **voucherStatus** `string ("any" | "draft" | "open" | "overdue" | "paid" | "paidoff" | "voided" | "transferred" | "sepadebit" | "accepted" | "rejected" | "uncheked")`
>
> Filter by voucher status (draft, open, paid, etc.).
>
> **createdDateFrom** `string`
>
> Filter by created date from (ISO date format: YYYY-MM-DD).
>
> **updatedDateFrom** `string`
>
> Filter by updated date from (ISO date format: YYYY-MM-DD).
>
> **voucherDateFrom** `string`
>
> Filter by voucher date from (ISO date format: YYYY-MM-DD).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Vouchers
>
> **Slug:** `LEXOFFICE_LIST_VOUCHERS`
>
> Tool to filter vouchers by voucher number from Lexoffice. Use when you need to retrieve vouchers with a specific voucher number.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, defaults to 0
>
> **size** `integer`
>
> Number of items per page
>
> **voucherNumber** `string` *required*
>
> Filter vouchers by voucher number (REQUIRED)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Article
>
> **Slug:** `LEXOFFICE_UPDATE_ARTICLE`
>
> Tool to update an existing article in Lexoffice with new data. Use when you need to modify article details such as price, title, type, or other attributes. Requires the article ID and version number for optimistic locking.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier (UUID) of the article to update.
>
> **gtin** `string`
>
> Global Trade Item Number (GTIN) for the article.
>
> **note** `string`
>
> Additional notes or description for the article.
>
> **type** `string ("PRODUCT" | "SERVICE")` *required*
>
> Type of the article. Must be either 'PRODUCT' for physical goods or 'SERVICE' for services.
>
> **price** `object` *required*
>
> Price information including leading price type, gross price, net price, and tax rate.
>
> **title** `string`
>
> Title or name of the article.
>
> **version** `integer` *required*
>
> Version number of the article for optimistic locking. Must match the current version to prevent conflicts.
>
> **unitName** `string` *required*
>
> Unit name for the article (e.g., 'Stunden' for hours, 'Stück' for pieces).
>
> **articleNumber** `string`
>
> Custom article number for identification.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update lexoffice contact
>
> **Slug:** `LEXOFFICE_UPDATE_CONTACT`
>
> Tool to update an existing contact in lexoffice. Use when modifying customer or vendor information. Requires the contact ID and current version number for optimistic locking.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> UUID of the contact to update
>
> **note** `string`
>
> Notes about the contact
>
> **roles** `object` *required*
>
> Contact roles (customer and/or vendor). At least one role is required.
>
> **person** `object`
>
> Person contact details. Use this for individual contacts (mutually exclusive with company).
>
> **company** `object`
>
> Company contact details. Use this for business contacts (mutually exclusive with person).
>
> **version** `integer` *required*
>
> Current version number of the contact for optimistic locking. Get this from the contact details before updating.
>
> **addresses** `object`
>
> Contact addresses (billing and/or shipping).
>
> **phoneNumbers** `object`
>
> Phone number information.
>
> **emailAddresses** `object`
>
> Email address information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Voucher
>
> **Slug:** `LEXOFFICE_UPDATE_VOUCHER`
>
> Update a currently open voucher after checking its version, or finalize a currently unchecked voucher by explicitly transitioning it to open. Other current statuses are non-writable. Files are preserved when omitted or null; supplying a full retention list permanently deletes every omitted attachment.
>
> #### Input Parameters
>
> **type** `string ("salesinvoice" | "salescreditnote" | "purchaseinvoice" | "purchasecreditnote")`
>
> Replacement voucher type; omit or pass null to preserve the current type.
>
> **files** `array`
>
> DESTRUCTIVE FULL RETENTION LIST: if supplied, this entire list replaces the voucher's retained file IDs and every currently attached file omitted from it is permanently deleted. Omit this parameter or pass null to preserve every current file. An explicit empty list removes all attachments.
>
> **remark** `string`
>
> Replacement voucher remark; omit or pass null to preserve it.
>
> **due\_date** `string`
>
> Replacement due date in YYYY-MM-DD format; omit or pass null to preserve it. Lexware uses voucher\_date if absent for a checked voucher.
>
> **tax\_type** `string ("net" | "gross")`
>
> Replacement tax calculation mode; omit or pass null to preserve it.
>
> **contact\_id** `string`
>
> Replacement existing Customer contact ID, required in the merged payload unless collective contact is enabled. Omit or pass null to preserve it.
>
> **voucher\_id** `string` *required*
>
> ID of the existing voucher to update.
>
> **contact\_name** `string`
>
> Replacement displayed collective-contact name; omit or pass null to preserve it.
>
> **voucher\_date** `string`
>
> Replacement voucher date in YYYY-MM-DD format; omit or pass null to preserve it. Required in the merged payload when status is not unchecked.
>
> **shipping\_date** `string`
>
> Replacement shipping date in YYYY-MM-DD format; valid only for sales invoices and sales credit notes. Omit or pass null to preserve it.
>
> **voucher\_items** `array`
>
> Complete replacement item list; omit or pass null to preserve all current items. Required and non-empty in the merged payload when status is not unchecked.
>
> **voucher\_number** `string`
>
> Replacement voucher number; omit or pass null to preserve it. Required in the merged payload when status is not unchecked.
>
> **voucher\_status** `string ("open" | "unchecked")`
>
> Requested status. The only allowed change is unchecked to open; omit or pass null to preserve status. An unchecked voucher cannot otherwise be updated.
>
> **current\_version** `integer` *required*
>
> Version the caller last read. The action aborts before updating if Lexware now reports a different version; re-read and reconsider the intended merge instead of blindly retrying.
>
> **total\_tax\_amount** `string`
>
> Replacement tax total with two decimal places. It must equal the exact sum of merged item tax amounts and is required when status is not unchecked. Omit or pass null to preserve the current total.
>
> **total\_gross\_amount** `string`
>
> Replacement gross total with two decimal places. It must match the merged voucher items and taxes and is required when status is not unchecked. Omit or pass null to preserve the current total.
>
> **clear\_shipping\_date** `boolean`
>
> Set true to remove the current shipping date from the merged PUT body. Use this explicit clear when changing a sales voucher with a shipping date to a purchase voucher. Omit or set false to preserve the current shipping date. This does not affect attached files.
>
> **use\_collective\_contact** `boolean`
>
> Set true to use the collective contact, in which case contact\_id is ignored; omit or pass null to preserve the current value.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Voucher File
>
> **Slug:** `LEXOFFICE_UPLOAD_VOUCHER_FILE`
>
> Upload and assign a PDF, image, or XML file to an existing bookkeeping voucher as a supporting document or receipt. File processing is asynchronous.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the voucher to which the file will be uploaded.
>
> **file** `object` *required*
>
> File (PDF or image) to upload to the voucher. Only PDF and image files are accepted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
