# Lexoffice

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

- **Category:** accounting
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 42
- **Triggers:** 0
- **Slug:** `LEXOFFICE`
- **Version:** 20260312_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("PRODUCT" | "SERVICE") | Yes | Type of article: PRODUCT for physical goods or SERVICE for services. |
| `price` | object | Yes | Price information including net/gross price, tax rate, and which price is leading. |
| `title` | string | Yes | The title/name of the article (product or service). |
| `unitName` | string | Yes | Unit of measurement for the article (e.g., piece, hour, kg, meter). This field is required by the Lexoffice API. |
| `articleNumber` | string | No | Optional article number for internal identification. If not provided, Lexoffice will auto-generate one. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | No | Additional notes about the contact (maximum 1000 characters) |
| `roles` | object | Yes | Contact roles - must contain at least one role (customer and/or vendor) |
| `person` | object | No | Person contact details - mutually exclusive with company. |
| `company` | object | No | Company contact details - mutually exclusive with person. |
| `version` | integer | No | Version number (must be 0 for new contacts) |
| `addresses` | object | No | Container for billing and shipping addresses. |
| `xRechnung` | object | No | XRechnung-specific fields for electronic invoicing. |
| `phoneNumbers` | object | No | Phone numbers organized by type. |
| `emailAddresses` | object | No | Email addresses organized by type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Title of the credit note. Organization default is used if omitted. |
| `remark` | string | No | Additional remarks. Organization default is used if omitted. |
| `address` | object | Yes | Recipient address information. Either contactId must be provided, or name/street/city/zip/countryCode. |
| `archived` | boolean | No | Whether the credit note should be archived. Defaults to false. |
| `finalize` | boolean | No | 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 | No | ISO 639-1 language code. Defaults to 'de'. |
| `lineItems` | array | Yes | List of line items in the credit note. Maximum 300 items per credit note. |
| `totalPrice` | object | Yes | Total price information with currency specification. |
| `voucherDate` | string | Yes | Date of the credit note in RFC 3339/ISO 8601 format (yyyy-MM-ddTHH:mm:ss.SSSXXX). |
| `introduction` | string | No | Introduction text. Organization default is used if omitted. Recommended to include invoice number if related to an invoice. |
| `printLayoutId` | string | No | UUID of the print layout to use. Organization default is used if omitted. |
| `taxConditions` | object | Yes | Tax conditions defining tax type and related settings. |
| `totalDiscountAbsolute` | number | No | Absolute discount amount. Maximum 2 decimal places. |
| `totalDiscountPercentage` | number | No | Percentage discount. Maximum 2 decimal places. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Title of the delivery note. Organization default is used if omitted. |
| `remark` | string | No | Additional remarks or notes for the delivery note. |
| `address` | object | Yes | Customer address. Either provide contactId for existing contact OR (name + countryCode) for one-time address. |
| `archived` | boolean | No | Whether to archive the delivery note immediately after creation. Defaults to false. |
| `finalize` | boolean | No | If true, creates a finalized delivery note with status 'open'. If false (default), creates in draft mode. |
| `language` | string ("de" | "en") | No | Language for the delivery note. |
| `lineItems` | array | Yes | List of items in the delivery note. Maximum 300 items allowed. |
| `voucherDate` | string | Yes | Date of the delivery note in ISO format (yyyy-MM-ddTHH:mm:ss.SSSXXX). |
| `introduction` | string | No | Introduction text shown at the beginning of the delivery note. |
| `deliveryTerms` | string | No | Delivery terms and conditions description. |
| `printLayoutId` | string | No | UUID of the print layout template to use. Organization default is used if omitted. |
| `taxConditions` | object | Yes | Tax settings for the delivery note. |
| `shippingConditions` | object | Yes | Shipping details including date and type. Required for delivery notes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `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") | Yes | The type of event to subscribe to. When this event occurs, a notification will be sent to the callback URL |
| `callbackUrl` | string | Yes | The HTTPS URL where Lexoffice will send webhook notifications when the specified event occurs |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Order Confirmation

**Slug:** `LEXOFFICE_CREATE_ORDER_CONFIRMATION`

Tool to create an Order Confirmation in Lexoffice/Lexware. Order confirmations are always created in draft mode and do not need to be finalized. Use when you need to confirm a customer order with line items, pricing, and shipping details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Document title/heading |
| `remark` | string | No | Closing remark or additional notes |
| `address` | object | Yes | Recipient address details |
| `archived` | boolean | No | Whether the order confirmation should be archived immediately after creation |
| `language` | string ("de" | "en") | No | Document language (de for German, en for English). Defaults to de if not specified. |
| `lineItems` | array | Yes | List of line items for the order confirmation (maximum 300 items) |
| `totalPrice` | object | Yes | Total price details |
| `voucherDate` | string | Yes | Document date in RFC 3339/ISO 8601 format (yyyy-MM-ddTHH:mm:ss.SSSXXX) |
| `introduction` | string | No | Introduction text that appears at the beginning of the document |
| `deliveryTerms` | string | No | Delivery terms description |
| `printLayoutId` | string | No | UUID of custom print template to use |
| `taxConditions` | object | Yes | Tax conditions for the order confirmation |
| `shippingConditions` | object | Yes | Shipping conditions for the order confirmation |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Quotation title |
| `remark` | string | No | Closing remark for the quotation |
| `address` | object | Yes | Recipient address details |
| `finalize` | boolean | No | Set to true to create a finalized quotation with status 'open'. If false, quotation is created in draft mode |
| `language` | string ("de" | "en") | No | Quotation language |
| `lineItems` | array | Yes | List of line items in the quotation (maximum 300 items) |
| `totalPrice` | object | Yes | Total pricing information |
| `voucherDate` | string | Yes | Quotation date in RFC 3339/ISO 8601 format (e.g., '2026-02-13T10:00:00.000+01:00') |
| `introduction` | string | No | Introduction text for the quotation |
| `deliveryTerms` | string | No | Delivery terms text |
| `printLayoutId` | string | No | UUID of the print layout to use |
| `taxConditions` | object | Yes | Tax conditions |
| `expirationDate` | string | Yes | Quotation expiration date in RFC 3339/ISO 8601 format (REQUIRED) |
| `shippingConditions` | string | No | Shipping conditions text |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("salesinvoice" | "salescreditnote" | "purchaseinvoice" | "purchasecreditnote" | "invoice" | "downpaymentinvoice" | "creditnote" | "orderconfirmation" | "quotation" | "deliverynote") | Yes | Type of voucher to create (e.g., salesinvoice, purchaseinvoice) |
| `remark` | string | No | Additional remarks or notes for the voucher |
| `dueDate` | string | No | Due date for the voucher in ISO 8601 format (YYYY-MM-DD) |
| `taxType` | string ("net" | "gross") | Yes | Tax calculation type - 'gross' for amounts including tax, 'net' for amounts excluding tax |
| `contactId` | string | No | UUID of the contact (customer or vendor) associated with this voucher |
| `voucherDate` | string | No | Date of the voucher in ISO 8601 format (YYYY-MM-DD) |
| `shippingDate` | string | No | Shipping date in ISO 8601 format (YYYY-MM-DD) |
| `voucherItems` | array | Yes | List of line items for the voucher with amounts and tax information (minimum 1 item required) |
| `voucherNumber` | string | No | Custom voucher number/reference |
| `voucherStatus` | string ("unchecked" | "open") | No | Status of the voucher |
| `totalTaxAmount` | number | No | Total tax amount of the voucher (sum of all item tax amounts) |
| `totalGrossAmount` | number | No | Total gross amount of the voucher (sum of all item amounts if taxType is gross) |
| `useCollectiveContact` | boolean | No | Whether to use a collective contact instead of a specific contact |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the article to delete. Use List Articles or Get Article actions to find valid article IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subscription_id` | string | Yes | The unique identifier of the event subscription to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download File

**Slug:** `LEXOFFICE_DOWNLOAD_FILE`

Download a file from lexoffice by its ID. Use this to retrieve PDF documents, images, or XML files associated with invoices, vouchers, or other records. The file format returned depends on the Accept header specified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `accept` | string ("*/*" | "application/xml" | "application/pdf" | "image/jpeg" | "image/png") | No | The desired content type for the downloaded file. Use this to specify the format you want to receive. |
| `file_id` | string | Yes | 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 | No | Optional filename for the downloaded file. If not provided, defaults to 'file_{file_id}' with appropriate extension based on content type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the article to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique ID of the contact to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the credit note to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credit Note Document

**Slug:** `LEXOFFICE_GET_CREDIT_NOTE_DOCUMENT`

Tool to render a credit note document (PDF). Use to trigger PDF document file rendering for credit notes in status 'open'. Note: This endpoint only works for credit notes that have been finalized (status 'open'), not for draft credit notes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the credit note. The credit note must be in 'open' status (not 'draft') for document rendering to work. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Delivery Note

**Slug:** `LEXOFFICE_GET_DELIVERY_NOTE`

Tool to retrieve a specific delivery note from Lexoffice by its ID. Use when you need to fetch complete details of a delivery note including address, line items, and tax information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the delivery note to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Delivery Note Document

**Slug:** `LEXOFFICE_GET_DELIVERY_NOTE_DOCUMENT`

Tool to render a delivery note document (PDF) and retrieve its file ID. This endpoint triggers the PDF document file rendering and returns a documentFileId that can be used to download the actual PDF. Note: This endpoint is deprecated; consider using GET /v1/delivery-notes/{id}/file instead to directly download the PDF.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deliveryNoteId` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dunningsid` | string | Yes | The unique identifier of the dunning to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dunning Document

**Slug:** `LEXOFFICE_GET_DUNNING_DOCUMENT`

Tool to render and retrieve a dunning document (PDF) reference. Triggers the PDF document file rendering for newly created dunnings. Use when you need to get the document file ID for a specific dunning to download or reference the PDF.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dunningsid` | string | Yes | The unique identifier of the dunning for which to render the document. Must be a valid UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subscription_id` | string | Yes | The unique identifier of the event subscription to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the invoice to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Invoice Document

**Slug:** `LEXOFFICE_GET_INVOICE_DOCUMENT`

Tool to render an Invoice Document (PDF) by invoice ID. Use when you need to generate or retrieve the PDF document reference for an invoice that is in 'open' status. This triggers the PDF rendering process and returns a document file ID that can be used to download the actual PDF file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the invoice to render as PDF. This triggers the PDF document file rendering for invoices in 'open' status. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Order Confirmation

**Slug:** `LEXOFFICE_GET_ORDER_CONFIRMATION`

Tool to retrieve a specific order confirmation by its ID. Use when you need to fetch the complete details of an order confirmation including line items, pricing, addresses, and payment terms.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the order confirmation to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Render Order Confirmation Document

**Slug:** `LEXOFFICE_GET_ORDER_CONFIRMATION_DOCUMENT`

Tool to render an Order Confirmation Document as PDF. Use when you need to trigger PDF document rendering for a specific order confirmation by providing its ID. Returns a document file reference that can be used to retrieve the rendered PDF.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the order confirmation for which to render the PDF document. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `voucher_id` | string | Yes | Unique identifier of the voucher (invoice or credit note) to retrieve payment information for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the quotation to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the quotation for which to render the PDF document. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Voucher

**Slug:** `LEXOFFICE_GET_VOUCHER`

Tool to retrieve a specific voucher by its UUID. Use when you need to fetch detailed information about vouchers such as sales invoices, credit notes, and other financial documents.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the voucher to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `gtin` | string | No | Filter by Global Trade Item Number (GTIN) of the article. |
| `page` | integer | No | Specify the page number for pagination (zero-indexed). Default is 0. |
| `size` | integer | No | Specify the number of articles per page. Maximum is 25. |
| `sort` | string | No | Specify the sort order for results. Format: 'property,direction' (e.g., 'title,asc' or 'createdDate,desc'). |
| `type` | string ("PRODUCT" | "SERVICE") | No | Article type enumeration. |
| `article_number` | string | No | Filter by article number as given by the user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Contacts

**Slug:** `LEXOFFICE_LIST_CONTACTS`

Tool to retrieve all contacts from Lexoffice with optional filters. Use when you need to list contacts with filtering options for number, email, name, vendor status, or customer status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter by name |
| `page` | integer | No | Page number for pagination |
| `size` | integer | No | Number of records per page |
| `sort` | string | No | Sort field and direction (e.g., 'name,asc' or 'number,desc') |
| `email` | string | No | Filter by email address |
| `number` | integer | No | Filter by contact number |
| `vendor` | boolean | No | Filter by vendor status |
| `customer` | boolean | No | Filter by customer status |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (zero-indexed) |
| `size` | integer | No | Number of records per page |
| `sort` | string | No | Sort field and direction (e.g., 'title,asc' or 'createdDate,desc') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Voucherlist

**Slug:** `LEXOFFICE_LIST_VOUCHERLIST`

Tool to retrieve voucherlist from Lexoffice including bookkeeping vouchers (salesinvoices, salescreditnotes), invoices, credit notes, order confirmations, quotations, and delivery notes. Use when you need to list vouchers with filtering options for type, status, dates, or contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (zero-indexed). Default is 0. |
| `size` | integer | No | Number of vouchers per page. Maximum is 250. |
| `sort` | string | No | Sort field and direction (e.g., 'voucherNumber,DESC' or 'voucherDate,ASC'). |
| `archived` | boolean | No | Filter by archived status. Set to true for archived vouchers, false for non-archived. |
| `contactId` | string | No | Filter by contact ID (UUID format). |
| `voucherType` | string ("any" | "salesinvoice" | "salescreditnote" | "purchaseinvoice" | "purchasecreditnote" | "invoice" | "creditnote" | "orderconfirmation" | "quotation" | "downpaymentinvoice" | "deliverynote") | No | Filter by voucher type (salesinvoice, invoice, creditnote, etc.). |
| `createdDateTo` | string | No | Filter by created date to (ISO date format: YYYY-MM-DD). |
| `updatedDateTo` | string | No | Filter by updated date to (ISO date format: YYYY-MM-DD). |
| `voucherDateTo` | string | No | Filter by voucher date to (ISO date format: YYYY-MM-DD). |
| `voucherNumber` | string | No | Filter by specific voucher number. |
| `voucherStatus` | string ("any" | "draft" | "open" | "overdue" | "paid" | "paidoff" | "voided" | "transferred" | "sepadebit" | "accepted" | "rejected" | "uncheked") | No | Filter by voucher status (draft, open, paid, etc.). |
| `createdDateFrom` | string | No | Filter by created date from (ISO date format: YYYY-MM-DD). |
| `updatedDateFrom` | string | No | Filter by updated date from (ISO date format: YYYY-MM-DD). |
| `voucherDateFrom` | string | No | Filter by voucher date from (ISO date format: YYYY-MM-DD). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, defaults to 0 |
| `size` | integer | No | Number of items per page |
| `voucherNumber` | string | Yes | Filter vouchers by voucher number (REQUIRED) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier (UUID) of the article to update. |
| `gtin` | string | No | Global Trade Item Number (GTIN) for the article. |
| `note` | string | No | Additional notes or description for the article. |
| `type` | string ("PRODUCT" | "SERVICE") | Yes | Type of the article. Must be either 'PRODUCT' for physical goods or 'SERVICE' for services. |
| `price` | object | Yes | Price information including leading price type, gross price, net price, and tax rate. |
| `title` | string | No | Title or name of the article. |
| `version` | integer | Yes | Version number of the article for optimistic locking. Must match the current version to prevent conflicts. |
| `unitName` | string | Yes | Unit name for the article (e.g., 'Stunden' for hours, 'Stück' for pieces). |
| `articleNumber` | string | No | Custom article number for identification. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the contact to update |
| `note` | string | No | Notes about the contact |
| `roles` | object | Yes | Contact roles (customer and/or vendor). At least one role is required. |
| `person` | object | No | Person contact details. Use this for individual contacts (mutually exclusive with company). |
| `company` | object | No | Company contact details. Use this for business contacts (mutually exclusive with person). |
| `version` | integer | Yes | Current version number of the contact for optimistic locking. Get this from the contact details before updating. |
| `addresses` | object | No | Contact addresses (billing and/or shipping). |
| `phoneNumbers` | object | No | Phone number information. |
| `emailAddresses` | object | No | Email address information. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Voucher File

**Slug:** `LEXOFFICE_UPLOAD_VOUCHER_FILE`

Tool to upload and assign files (PDF or image) to a specific voucher in lexoffice. Use when you need to attach supporting documents or receipts to an existing voucher. The file upload is asynchronous and returns HTTP 202 (Accepted) when the file is accepted for processing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the voucher to which the file will be uploaded. |
| `file` | object | No | File (PDF or image) to upload to the voucher. Only PDF and image files are accepted. |
| `local_file_path` | string | No | Optional local file path to read the file content from. If provided, this will be used instead of the file reference. Useful for testing or when the file is available locally. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |