> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Lexware Office (lexoffice)

The Lexware Office (lexoffice) connector lets your AI agent act in each user's Lexware Office (lexoffice) account. Each user connects their own Lexware Office (lexoffice) access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 38 tools.

**Authentication:** Bearer Token
**Categories:** Accounting & Finance
**Tools:** 38: 23 read, 13 write, 2 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=LEXOFFICE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Lexware Office (lexoffice) connection

   In **AgentKit > Connections**, create a Lexware Office (lexoffice) connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'lexoffice'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Lexware Office (lexoffice):', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'lexoffice_articles_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "lexoffice"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Lexware Office (lexoffice):", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="lexoffice_articles_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Lexware Office (lexoffice) credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'lexoffice_article_get',
  toolInput: {
    article_id: '<article_id>',
  },
  connector: 'lexoffice',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="lexoffice_article_get",
    tool_input={
        "article_id": "<article_id>",
    },
    connection_name="lexoffice",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `lexoffice_article_get`

Get Article · Read-only

Get one article by ID, including its current version. Returns the article object. Get IDs from lexoffice_articles_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `article_id` (`string`, required): ID (UUID) of the article. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"article_id":"<article_id>"}`

### `lexoffice_articles_list`

List Articles · Read-only

List articles (products and services) a page at a time, optionally filtered by article number, GTIN or type. Returns a page with content and paging info. Use lexoffice_article_get for one article.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `article_number` (`string`, optional): Only the article with this article number. Example: LXW-BUHA-2024-001.
- `gtin` (`string`, optional): Only articles with this Global Trade Item Number. Example: 9783648170632.
- `page` (`integer`, optional): Page to retrieve, starting at 0. Example: 0.
- `size` (`integer`, optional): Page size: 25 by default, up to 250. Example: 25.
- `type` (`string`, optional): Only articles of this type: PRODUCT or SERVICE. Example: PRODUCT. One of: `PRODUCT`, `SERVICE`.

Example input: `{}`

### `lexoffice_contact_get`

Get Contact · Read-only

Get one contact by ID with roles, addresses, emails, phone numbers and current version. Returns the contact object. Get IDs from lexoffice_contacts_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID (UUID) of the contact. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"contact_id":"<contact_id>"}`

### `lexoffice_contacts_list`

List Contacts · Read-only

List contacts (customers and vendors) a page at a time, filtered by email, name, contact number or role. Returns a page with content and paging info. Use lexoffice_contact_get for one contact.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer` (`boolean`, optional): true for contacts with the customer role, false for those without. Example: true.
- `email` (`string`, optional): Filter by email (substring, case-insensitive, _ and % wildcards; at least 3 characters). Example: max@example.com.
- `name` (`string`, optional): Filter by name (substring, case-insensitive; at least 3 characters). Example: Mustermann.
- `number` (`integer`, optional): Customer or vendor number. Example: 10308.
- `page` (`integer`, optional): Page to retrieve, starting at 0. Example: 0.
- `size` (`integer`, optional): Page size: 25 by default, up to 250. Example: 25.
- `vendor` (`boolean`, optional): true for contacts with the vendor role, false for those without. Example: false.

Example input: `{}`

### `lexoffice_countries_list`

List Countries · Read-only

List the countries Lexware knows with their country codes and tax classification (DE, intra-community, third party). Returns country objects. Use the codes in addresses.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `lexoffice_credit_note_get`

Get Credit Note · Read-only

Get one credit note by ID with its status, number, address, line items and totals. Returns the document object. Find IDs with lexoffice_voucherlist_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `credit_note_id` (`string`, required): ID (UUID) of the credit note. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"credit_note_id":"<credit_note_id>"}`

### `lexoffice_delivery_note_get`

Get Delivery Note · Read-only

Get one delivery note by ID with its status, number, address, line items and totals. Returns the document object. Find IDs with lexoffice_voucherlist_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `delivery_note_id` (`string`, required): ID (UUID) of the delivery note. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"delivery_note_id":"<delivery_note_id>"}`

### `lexoffice_down_payment_invoice_get`

Get Down Payment Invoice · Read-only

Get one down payment invoice by ID. Returns the document object. Find IDs with lexoffice_voucherlist_get (voucherType downpaymentinvoice).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `down_payment_invoice_id` (`string`, required): ID (UUID) of the down payment invoice. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"down_payment_invoice_id":"<down_payment_invoice_id>"}`

### `lexoffice_dunning_get`

Get Dunning · Read-only

Get one dunning by ID with its status, number, address, line items and totals. Returns the document object. Find IDs with lexoffice_voucherlist_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dunning_id` (`string`, required): ID (UUID) of the dunning. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"dunning_id":"<dunning_id>"}`

### `lexoffice_event_subscription_get`

Get Event Subscription · Read-only

Get one event subscription by ID. Returns the subscription.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `subscription_id` (`string`, required): ID of the event subscription. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"subscription_id":"<subscription_id>"}`

### `lexoffice_event_subscriptions_list`

List Event Subscriptions · Read-only

List the webhook event subscriptions of this API key. Returns subscriptions with event type and callback URL.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `lexoffice_invoice_get`

Get Invoice · Read-only

Get one invoice by ID with its status, number, address, line items and totals. Returns the document object. Find IDs with lexoffice_voucherlist_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `invoice_id` (`string`, required): ID (UUID) of the invoice. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"invoice_id":"<invoice_id>"}`

### `lexoffice_order_confirmation_get`

Get Order Confirmation · Read-only

Get one order confirmation by ID with its status, number, address, line items and totals. Returns the document object. Find IDs with lexoffice_voucherlist_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_confirmation_id` (`string`, required): ID (UUID) of the order confirmation. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"order_confirmation_id":"<order_confirmation_id>"}`

### `lexoffice_payment_conditions_list`

List Payment Conditions · Read-only

List the organization's payment condition templates. Returns payment terms with labels, durations and discounts to use in paymentConditions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `lexoffice_payments_get`

Get Payment Information · Read-only

Get the payment status of a voucher (invoice, credit note, bookkeeping voucher...): open amount, payment status and the payment items. Returns the payment information. Find voucher IDs with lexoffice_voucherlist_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `voucher_id` (`string`, required): ID of the voucher. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"voucher_id":"<voucher_id>"}`

### `lexoffice_posting_categories_list`

List Posting Categories · Read-only

List the posting categories for bookkeeping vouchers. Returns category IDs, names and types to use as categoryId in voucher items.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `lexoffice_print_layouts_list`

List Print Layouts · Read-only

List the organization's print layouts. Returns layout IDs and names to use as printLayoutId on sales documents.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `lexoffice_profile_get`

Get Profile · Read-only

Get the connected organization's profile: company name, organization ID, user, tax type and business features. Returns the profile. Use it to test the connection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `lexoffice_quotation_get`

Get Quotation · Read-only

Get one quotation by ID with its status, number, address, line items and totals. Returns the document object. Find IDs with lexoffice_voucherlist_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `quotation_id` (`string`, required): ID (UUID) of the quotation. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"quotation_id":"<quotation_id>"}`

### `lexoffice_recurring_template_get`

Get Recurring Template · Read-only

Get one recurring invoice template by ID with its full invoice data and schedule. Returns the template.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `recurring_template_id` (`string`, required): ID (UUID) of the recurring template. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"recurring_template_id":"<recurring_template_id>"}`

### `lexoffice_recurring_templates_list`

List Recurring Templates · Read-only

List recurring invoice templates a page at a time, sortable by created, updated, last or next execution date. Returns templates with contact, total and schedule. Use lexoffice_recurring_template_get for one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page to retrieve, starting at 0. Example: 0.
- `size` (`integer`, optional): Page size: 25 by default, up to 250. Example: 25.
- `sort` (`string`, optional): Sort field and direction: createdDate, updatedDate, lastExecutionDate or nextExecutionDate, then ASC or DESC, for example nextExecutionDate,ASC. Example: updatedDate,DESC.

Example input: `{}`

### `lexoffice_voucher_get`

Get Bookkeeping Voucher · Read-only

Get one bookkeeping voucher by ID with items, totals, files and version. Returns the voucher. Find IDs with lexoffice_voucherlist_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `voucher_id` (`string`, required): ID (UUID) of the voucher. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"voucher_id":"<voucher_id>"}`

### `lexoffice_voucherlist_get`

List Vouchers (Voucherlist) · Read-only

List vouchers of any kind (invoices, credit notes, quotations, order confirmations, delivery notes, dunnings, bookkeeping vouchers) filtered by type, status, contact, dates or number. Returns a page of voucher metadata with IDs, numbers, dates, amounts and status. Use the type-specific get tools for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `voucher_status` (`string`, required): Comma-separated statuses, or any: draft, open, paid, paidoff, voided, transferred, sepadebit, overdue, accepted, rejected, unchecked. Example: open.
- `voucher_type` (`string`, required): Comma-separated voucher types, or any: salesinvoice, salescreditnote, purchaseinvoice, purchasecreditnote, invoice, downpaymentinvoice, creditnote, orderconfirmation, quotation, deliverynote, dunning. Example: invoice.
- `archived` (`boolean`, optional): true for archived vouchers only, false for unarchived. Example: false.
- `contact_id` (`string`, optional): Only vouchers for this contact. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `created_date_from` (`string`, optional): Only vouchers created on or after this day (yyyy-MM-dd). Example: 2026-01-01.
- `created_date_to` (`string`, optional): Only vouchers created on or before this day (yyyy-MM-dd). Example: 2026-01-31.
- `page` (`integer`, optional): Page to retrieve, starting at 0. Example: 0.
- `size` (`integer`, optional): Page size: 25 by default, up to 250. Example: 25.
- `sort` (`string`, optional): Sort field and direction, for example voucherDate,DESC. Example: updatedDate,DESC.
- `updated_date_from` (`string`, optional): Only vouchers changed on or after this day (yyyy-MM-dd). Example: 2026-01-01.
- `updated_date_to` (`string`, optional): Only vouchers changed on or before this day (yyyy-MM-dd). Example: 2026-01-31.
- `voucher_date_from` (`string`, optional): Only vouchers dated on or after this day (yyyy-MM-dd, CET). Example: 2026-01-01.
- `voucher_date_to` (`string`, optional): Only vouchers dated on or before this day (yyyy-MM-dd, CET). Example: 2026-01-31.
- `voucher_number` (`string`, optional): Only the voucher with this number. Example: RE1234.

Example input: `{"voucher_status":"<voucher_status>","voucher_type":"<voucher_type>"}`

### `lexoffice_article_create`

Create Article · Write

Create an article (product or service) with title, type, unit name and price. Returns the new article's id and version.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `price` (`object`, required): Price object: netPrice or grossPrice, leadingPrice (NET or GROSS) and taxRate. Example: {"netPrice": 61.90, "leadingPrice": "NET", "taxRate": 19}
- `title` (`string`, required): Title of the article. Example: Rechnung.
- `type` (`string`, required): PRODUCT or SERVICE. Example: PRODUCT. One of: `PRODUCT`, `SERVICE`.
- `unit_name` (`string`, required): Unit name, for example Piece or Hour. Example: Piece.
- `article_number` (`string`, optional): Your article number. Example: LXW-BUHA-2024-001.
- `description` (`string`, optional): Description of the article. For this property, text formatting is supported. For details, see Text Formatting . Example: Monthly subscription, multi-user bookkeeping.
- `gtin` (`string`, optional): Global Trade Item Number; validated if given. Example: 9783648170632.
- `note` (`string`, optional): Internal note. Example: Internal note.

Example input: `{"price":{"netPrice":61.9,"leadingPrice":"NET","taxRate":19},"title":"<title>","type":"PRODUCT","unit_name":"<unit_name>"}`

### `lexoffice_article_update`

Update Article · Write

Replace an article's data. Send the current version from lexoffice_article_get (optimistic locking). Returns the id and new version.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `article_id` (`string`, required): ID (UUID) of the record. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `price` (`object`, required): Price object: netPrice or grossPrice, leadingPrice (NET or GROSS) and taxRate. Example: {"netPrice": 61.90, "leadingPrice": "NET", "taxRate": 19}
- `title` (`string`, required): Title of the article. Example: Rechnung.
- `type` (`string`, required): PRODUCT or SERVICE. Example: PRODUCT. One of: `PRODUCT`, `SERVICE`.
- `unit_name` (`string`, required): Unit name, for example Piece or Hour. Example: Piece.
- `version` (`integer`, required): Version of the record for optimistic locking: 0 when creating, the current version from the matching get tool when updating. Example: 2.
- `article_number` (`string`, optional): Your article number. Example: LXW-BUHA-2024-001.
- `description` (`string`, optional): Description of the article. For this property, text formatting is supported. For details, see Text Formatting . Example: Monthly subscription, multi-user bookkeeping.
- `gtin` (`string`, optional): Global Trade Item Number; validated if given. Example: 9783648170632.
- `note` (`string`, optional): Internal note. Example: Internal note.

Example input: `{"article_id":"<article_id>","price":{"netPrice":61.9,"leadingPrice":"NET","taxRate":19},"title":"<title>","type":"PRODUCT","unit_name":"<unit_name>","version":2}`

### `lexoffice_contact_create`

Create Contact · Write

Create a contact (a company or a person) with its roles (customer and/or vendor), addresses, email addresses and phone numbers. Returns the new contact's id and version.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `roles` (`object`, required): Roles of the contact as an object with customer and/or vendor keys, for example {"customer": {}}. Example: {"customer": {}}
- `version` (`integer`, required): Version of the record for optimistic locking: 0 when creating, the current version from the matching get tool when updating. Example: 0.
- `addresses` (`object`, optional): Addresses as lists under billing and shipping, each with street, zip, city and countryCode. Example: {"billing": [{"street": "Musterstraße 1", "zip": "10115", "city": "Berlin", "countryCode": "DE"}]}
- `company` (`object`, optional): Company details (name, taxNumber, vatRegistrationId, contactPersons). Send company or person. Example: {"name": "Musterfirma GmbH", "taxNumber": "12345/12345", "vatRegistrationId": "DE123456789"}
- `email_addresses` (`object`, optional): Email addresses as lists under business, office, private and other. Example: {"business": ["inge@example.com"]}
- `note` (`string`, optional): Note about the contact (max 1000 characters). Example: Internal note.
- `person` (`object`, optional): Person details (salutation, firstName, lastName). Send company or person. Example: {"salutation": "Frau", "firstName": "Inge", "lastName": "Musterfrau"}
- `phone_numbers` (`object`, optional): Phone numbers as lists under business, office, mobile, private, fax and other. Example: {"business": ["+49 30 1234567"]}
- `x_rechnung` (`object`, optional): XRechnung data, for example the buyerReference (Leitweg-ID) for public-sector recipients. Example: {"buyerReference": "04011000-1234512345-35"}

Example input: `{"roles":{},"version":0}`

### `lexoffice_contact_update`

Update Contact · Write

Replace a contact's data. Send the current version from lexoffice_contact_get. Contacts with more than one entry in any address, email, phone or contact-person list cannot be updated through the API. Returns the id and new version.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID (UUID) of the record. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `roles` (`object`, required): Roles of the contact as an object with customer and/or vendor keys. Example: {"customer": {}}
- `version` (`integer`, required): Version of the record for optimistic locking: 0 when creating, the current version from the matching get tool when updating. Example: 2.
- `addresses` (`object`, optional): Addresses as lists under billing and shipping. Example: {"billing": [{"street": "Musterstraße 1", "zip": "10115", "city": "Berlin", "countryCode": "DE"}]}
- `company` (`object`, optional): Company details. Send company or person. Example: {"name": "Musterfirma GmbH", "taxNumber": "12345/12345", "vatRegistrationId": "DE123456789"}
- `email_addresses` (`object`, optional): Email addresses as lists under business, office, private and other. Example: {"business": ["inge@example.com"]}
- `note` (`string`, optional): Note about the contact. Example: Internal note.
- `person` (`object`, optional): Person details. Send company or person. Example: {"salutation": "Frau", "firstName": "Inge", "lastName": "Musterfrau"}
- `phone_numbers` (`object`, optional): Phone numbers as lists by type. Example: {"business": ["+49 30 1234567"]}
- `x_rechnung` (`object`, optional): XRechnung data, for example the buyerReference (Leitweg-ID) for public-sector recipients. Example: {"buyerReference": "04011000-1234512345-35"}

Example input: `{"contact_id":"<contact_id>","roles":{},"version":2}`

### `lexoffice_credit_note_create`

Create Credit Note · Write

Create a credit note with recipient address, line items, tax, payment and shipping conditions; it is a draft unless finalize is true. Pass precedingSalesVoucherId to pursue from an invoice. Returns the new document's id and version. Get contact IDs from lexoffice_contacts_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `address` (`object`, required): Recipient: {"contactId": ""} for an existing contact, or an address with name, street, zip, city and countryCode. Example: {"contactId": "e9066f04-8cc7-4616-93f8-ac9ecc8479c8"}
- `line_items` (`array`, required): Line items: each has a type (custom, material, service or text), name, quantity, unitName and unitPrice (currency, netAmount or grossAmount, taxRatePercentage); material and service items reference an article id. Example: [{"type": "custom", "name": "Consulting", "quantity": 2, "unitName": "Hour", "unitPrice": {"currency": "EUR", "netAmount": 100.0, "taxRatePercentage": 19}}]
- `tax_conditions` (`object`, required): Tax conditions: taxType (net, gross, vatfree, intraCommunitySupply, constructionService13b, externalService13b, thirdPartyCountryService, thirdPartyCountryDelivery), plus taxTypeNote where needed. Example: {"taxType": "net"}
- `total_price` (`object`, required): Total price object; send {"currency": "EUR"} and Lexware calculates the amounts. Example: {"currency": "EUR"}
- `voucher_date` (`string`, required): Date of the document (RFC 3339), for example 2026-01-15T00:00:00.000+01:00. Example: 2026-01-15T00:00:00.000+01:00.
- `finalize` (`boolean`, optional): true creates the document finalized (status open, no longer editable); false or empty creates a draft. Example: false.
- `introduction` (`string`, optional): Introductory text above the line items. Example: Thank you for your order.
- `language` (`string`, optional): Language of the document: de or en. Example: de.
- `preceding_sales_voucher_id` (`string`, optional): ID of the preceding sales voucher to pursue from (for example the quotation or invoice this document follows); Lexware links them and copies its data. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `print_layout_id` (`string`, optional): ID of the print layout to use. Get IDs from lexoffice_print_layouts_list. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `remark` (`string`, optional): Closing text below the line items. Example: We look forward to working with you again.
- `title` (`string`, optional): Title of the document. Defaults to the organization's setting. Example: Rechnung.

Example input: `{"address":{"contactId":"e9066f04-8cc7-4616-93f8-ac9ecc8479c8"},"line_items":[{"type":"custom","name":"Consulting","quantity":2,"unitName":"Hour","unitPrice":{"currency":"EUR","netAmount":100,"taxRatePercentage":19}}],"tax_conditions":{"taxType":"net"},"total_price":{"currency":"EUR"},"voucher_date":"<voucher_date>"}`

### `lexoffice_delivery_note_create`

Create Delivery Note · Write

Create a delivery note with recipient address, line items, tax, payment and shipping conditions; it is a draft unless finalize is true. Pass precedingSalesVoucherId to pursue from an invoice or order confirmation. Returns the new document's id and version. Get contact IDs from lexoffice_contacts_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `address` (`object`, required): Recipient: {"contactId": ""} for an existing contact, or an address with name, street, zip, city and countryCode. Example: {"contactId": "e9066f04-8cc7-4616-93f8-ac9ecc8479c8"}
- `line_items` (`array`, required): Line items: each has a type (custom, material, service or text), name, quantity, unitName and unitPrice (currency, netAmount or grossAmount, taxRatePercentage); material and service items reference an article id. Example: [{"type": "custom", "name": "Consulting", "quantity": 2, "unitName": "Hour", "unitPrice": {"currency": "EUR", "netAmount": 100.0, "taxRatePercentage": 19}}]
- `shipping_conditions` (`object`, required): Shipping conditions: shippingType (service, delivery, serviceperiod, deliveryperiod or none) and shippingDate, plus shippingEndDate for periods. Example: {"shippingType": "delivery", "shippingDate": "2026-01-15T00:00:00.000+01:00"}
- `tax_conditions` (`object`, required): Tax conditions: taxType (net, gross, vatfree, intraCommunitySupply, constructionService13b, externalService13b, thirdPartyCountryService, thirdPartyCountryDelivery), plus taxTypeNote where needed. Example: {"taxType": "net"}
- `voucher_date` (`string`, required): Date of the document (RFC 3339), for example 2026-01-15T00:00:00.000+01:00. Example: 2026-01-15T00:00:00.000+01:00.
- `delivery_terms` (`string`, optional): (Optional) Describes the terms for delivery. The organization's (or contact-specific) default is used if no value was sent. Example: Delivery within 3 days.
- `finalize` (`boolean`, optional): true creates the document finalized (status open, no longer editable); false or empty creates a draft. Example: false.
- `introduction` (`string`, optional): Introductory text above the line items. Example: Thank you for your order.
- `language` (`string`, optional): Language of the document: de or en. Example: de.
- `preceding_sales_voucher_id` (`string`, optional): ID of the preceding sales voucher to pursue from (for example the quotation or invoice this document follows); Lexware links them and copies its data. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `print_layout_id` (`string`, optional): ID of the print layout to use. Get IDs from lexoffice_print_layouts_list. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `remark` (`string`, optional): Closing text below the line items. Example: We look forward to working with you again.
- `title` (`string`, optional): Title of the document. Defaults to the organization's setting. Example: Rechnung.

Example input: `{"address":{"contactId":"e9066f04-8cc7-4616-93f8-ac9ecc8479c8"},"line_items":[{"type":"custom","name":"Consulting","quantity":2,"unitName":"Hour","unitPrice":{"currency":"EUR","netAmount":100,"taxRatePercentage":19}}],"shipping_conditions":{"shippingType":"delivery","shippingDate":"2026-01-15T00:00:00.000+01:00"},"tax_conditions":{"taxType":"net"},"voucher_date":"<voucher_date>"}`

### `lexoffice_dunning_create`

Create Dunning · Write

Create a dunning (payment reminder) for an invoice with recipient address, line items, tax, payment and shipping conditions; it is a draft unless finalize is true. precedingSalesVoucherId (the invoice) is required. Returns the new document's id and version. Get contact IDs from lexoffice_contacts_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `address` (`object`, required): Recipient: {"contactId": ""} for an existing contact, or an address with name, street, zip, city and countryCode. Example: {"contactId": "e9066f04-8cc7-4616-93f8-ac9ecc8479c8"}
- `line_items` (`array`, required): Line items: each has a type (custom, material, service or text), name, quantity, unitName and unitPrice (currency, netAmount or grossAmount, taxRatePercentage); material and service items reference an article id. Example: [{"type": "custom", "name": "Consulting", "quantity": 2, "unitName": "Hour", "unitPrice": {"currency": "EUR", "netAmount": 100.0, "taxRatePercentage": 19}}]
- `preceding_sales_voucher_id` (`string`, required): ID of the preceding sales voucher to pursue from (for example the quotation or invoice this document follows); Lexware links them and copies its data. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `shipping_conditions` (`object`, required): Shipping conditions: shippingType (service, delivery, serviceperiod, deliveryperiod or none) and shippingDate, plus shippingEndDate for periods. Example: {"shippingType": "delivery", "shippingDate": "2026-01-15T00:00:00.000+01:00"}
- `tax_conditions` (`object`, required): Tax conditions: taxType (net, gross, vatfree, intraCommunitySupply, constructionService13b, externalService13b, thirdPartyCountryService, thirdPartyCountryDelivery), plus taxTypeNote where needed. Example: {"taxType": "net"}
- `total_price` (`object`, required): Total price object; send {"currency": "EUR"} and Lexware calculates the amounts. Example: {"currency": "EUR"}
- `voucher_date` (`string`, required): Date of the document (RFC 3339), for example 2026-01-15T00:00:00.000+01:00. Example: 2026-01-15T00:00:00.000+01:00.
- `introduction` (`string`, optional): Introductory text above the line items. Example: Thank you for your order.
- `language` (`string`, optional): Language of the document: de or en. Example: de.
- `print_layout_id` (`string`, optional): ID of the print layout to use. Get IDs from lexoffice_print_layouts_list. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `remark` (`string`, optional): Closing text below the line items. Example: We look forward to working with you again.
- `title` (`string`, optional): Title of the document. Defaults to the organization's setting. Example: Rechnung.

Example input: `{"address":{"contactId":"e9066f04-8cc7-4616-93f8-ac9ecc8479c8"},"line_items":[{"type":"custom","name":"Consulting","quantity":2,"unitName":"Hour","unitPrice":{"currency":"EUR","netAmount":100,"taxRatePercentage":19}}],"preceding_sales_voucher_id":"<preceding_sales_voucher_id>","shipping_conditions":{"shippingType":"delivery","shippingDate":"2026-01-15T00:00:00.000+01:00"},"tax_conditions":{"taxType":"net"},"total_price":{"currency":"EUR"},"voucher_date":"<voucher_date>"}`

### `lexoffice_event_subscription_create`

Create Event Subscription · Write

Subscribe a callback URL to a Lexware event, such as invoice.created or contact.changed; Lexware then POSTs a signed notification to the URL. Returns the subscription ID. Use lexoffice_event_subscriptions_list to see existing ones.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `callback_url` (`string`, required): HTTPS URL Lexware notifies when the event happens. Example: https://example.com/webhooks/lexware.
- `event_type` (`string`, required): Event to subscribe to, as resource.event, for example invoice.created, invoice.status.changed or contact.changed. Example: invoice.created.

Example input: `{"callback_url":"<callback_url>","event_type":"<event_type>"}`

### `lexoffice_invoice_create`

Create Invoice · Write

Create an invoice with recipient address, line items, tax, payment and shipping conditions; it is a draft unless finalize is true. Pass precedingSalesVoucherId to pursue from a quotation or order confirmation. Returns the new document's id and version. Get contact IDs from lexoffice_contacts_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `address` (`object`, required): Recipient: {"contactId": ""} for an existing contact, or an address with name, street, zip, city and countryCode. Example: {"contactId": "e9066f04-8cc7-4616-93f8-ac9ecc8479c8"}
- `line_items` (`array`, required): Line items: each has a type (custom, material, service or text), name, quantity, unitName and unitPrice (currency, netAmount or grossAmount, taxRatePercentage); material and service items reference an article id. Example: [{"type": "custom", "name": "Consulting", "quantity": 2, "unitName": "Hour", "unitPrice": {"currency": "EUR", "netAmount": 100.0, "taxRatePercentage": 19}}]
- `shipping_conditions` (`object`, required): Shipping conditions: shippingType (service, delivery, serviceperiod, deliveryperiod or none) and shippingDate, plus shippingEndDate for periods. Example: {"shippingType": "delivery", "shippingDate": "2026-01-15T00:00:00.000+01:00"}
- `tax_conditions` (`object`, required): Tax conditions: taxType (net, gross, vatfree, intraCommunitySupply, constructionService13b, externalService13b, thirdPartyCountryService, thirdPartyCountryDelivery), plus taxTypeNote where needed. Example: {"taxType": "net"}
- `total_price` (`object`, required): Total price object; send {"currency": "EUR"} and Lexware calculates the amounts. Example: {"currency": "EUR"}
- `voucher_date` (`string`, required): Date of the document (RFC 3339), for example 2026-01-15T00:00:00.000+01:00. Example: 2026-01-15T00:00:00.000+01:00.
- `finalize` (`boolean`, optional): true creates the document finalized (status open, no longer editable); false or empty creates a draft. Example: false.
- `introduction` (`string`, optional): Introductory text above the line items. Example: Thank you for your order.
- `language` (`string`, optional): Language of the document: de or en. Example: de.
- `payment_conditions` (`object`, optional): Payment terms: paymentTermLabel, paymentTermDuration (days) and optional paymentDiscountConditions. Defaults to the organization's or contact's terms. Example: {"paymentTermLabel": "10 Tage - 3 %, 30 Tage netto", "paymentTermDuration": 30}
- `preceding_sales_voucher_id` (`string`, optional): ID of the preceding sales voucher to pursue from (for example the quotation or invoice this document follows); Lexware links them and copies its data. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `print_layout_id` (`string`, optional): ID of the print layout to use. Get IDs from lexoffice_print_layouts_list. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `recurring_template_id` (`string`, optional): The id of the recurring template, if this is a recurring invoice deduced from a template. Null otherwise. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `remark` (`string`, optional): Closing text below the line items. Example: We look forward to working with you again.
- `title` (`string`, optional): Title of the document. Defaults to the organization's setting. Example: Rechnung.
- `x_rechnung` (`object`, optional): XRechnung data, for example the buyerReference (Leitweg-ID) for public-sector recipients. Example: {"buyerReference": "04011000-1234512345-35"}

Example input: `{"address":{"contactId":"e9066f04-8cc7-4616-93f8-ac9ecc8479c8"},"line_items":[{"type":"custom","name":"Consulting","quantity":2,"unitName":"Hour","unitPrice":{"currency":"EUR","netAmount":100,"taxRatePercentage":19}}],"shipping_conditions":{"shippingType":"delivery","shippingDate":"2026-01-15T00:00:00.000+01:00"},"tax_conditions":{"taxType":"net"},"total_price":{"currency":"EUR"},"voucher_date":"<voucher_date>"}`

### `lexoffice_order_confirmation_create`

Create Order Confirmation · Write

Create an order confirmation with recipient address, line items, tax, payment and shipping conditions; it is a draft unless finalize is true. Pass precedingSalesVoucherId to pursue from a quotation. Returns the new document's id and version. Get contact IDs from lexoffice_contacts_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `address` (`object`, required): Recipient: {"contactId": ""} for an existing contact, or an address with name, street, zip, city and countryCode. Example: {"contactId": "e9066f04-8cc7-4616-93f8-ac9ecc8479c8"}
- `line_items` (`array`, required): Line items: each has a type (custom, material, service or text), name, quantity, unitName and unitPrice (currency, netAmount or grossAmount, taxRatePercentage); material and service items reference an article id. Example: [{"type": "custom", "name": "Consulting", "quantity": 2, "unitName": "Hour", "unitPrice": {"currency": "EUR", "netAmount": 100.0, "taxRatePercentage": 19}}]
- `shipping_conditions` (`object`, required): Shipping conditions: shippingType (service, delivery, serviceperiod, deliveryperiod or none) and shippingDate, plus shippingEndDate for periods. Example: {"shippingType": "delivery", "shippingDate": "2026-01-15T00:00:00.000+01:00"}
- `tax_conditions` (`object`, required): Tax conditions: taxType (net, gross, vatfree, intraCommunitySupply, constructionService13b, externalService13b, thirdPartyCountryService, thirdPartyCountryDelivery), plus taxTypeNote where needed. Example: {"taxType": "net"}
- `total_price` (`object`, required): Total price object; send {"currency": "EUR"} and Lexware calculates the amounts. Example: {"currency": "EUR"}
- `voucher_date` (`string`, required): Date of the document (RFC 3339), for example 2026-01-15T00:00:00.000+01:00. Example: 2026-01-15T00:00:00.000+01:00.
- `delivery_terms` (`string`, optional): (Optional) Describes the terms for delivery. The organization's (or contact-specific) default is used if no value was sent. For this property, text formatting is supported. For details, see Text Formatting . Example: Delivery within 3 days.
- `finalize` (`boolean`, optional): true creates the document finalized (status open, no longer editable); false or empty creates a draft. Example: false.
- `introduction` (`string`, optional): Introductory text above the line items. Example: Thank you for your order.
- `language` (`string`, optional): Language of the document: de or en. Example: de.
- `payment_conditions` (`object`, optional): Payment terms: paymentTermLabel, paymentTermDuration (days) and optional paymentDiscountConditions. Defaults to the organization's or contact's terms. Example: {"paymentTermLabel": "10 Tage - 3 %, 30 Tage netto", "paymentTermDuration": 30}
- `preceding_sales_voucher_id` (`string`, optional): ID of the preceding sales voucher to pursue from (for example the quotation or invoice this document follows); Lexware links them and copies its data. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `print_layout_id` (`string`, optional): ID of the print layout to use. Get IDs from lexoffice_print_layouts_list. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `remark` (`string`, optional): Closing text below the line items. Example: We look forward to working with you again.
- `title` (`string`, optional): Title of the document. Defaults to the organization's setting. Example: Rechnung.

Example input: `{"address":{"contactId":"e9066f04-8cc7-4616-93f8-ac9ecc8479c8"},"line_items":[{"type":"custom","name":"Consulting","quantity":2,"unitName":"Hour","unitPrice":{"currency":"EUR","netAmount":100,"taxRatePercentage":19}}],"shipping_conditions":{"shippingType":"delivery","shippingDate":"2026-01-15T00:00:00.000+01:00"},"tax_conditions":{"taxType":"net"},"total_price":{"currency":"EUR"},"voucher_date":"<voucher_date>"}`

### `lexoffice_quotation_create`

Create Quotation · Write

Create a quotation (offer) with an expiration date with recipient address, line items, tax, payment and shipping conditions; it is a draft unless finalize is true.  Returns the new document's id and version. Get contact IDs from lexoffice_contacts_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `address` (`object`, required): Recipient: {"contactId": ""} for an existing contact, or an address with name, street, zip, city and countryCode. Example: {"contactId": "e9066f04-8cc7-4616-93f8-ac9ecc8479c8"}
- `expiration_date` (`string`, required): The instant of time when the quotation will expire. Value in format yyyy-MM-ddTHH:mm:ss.SSSXXX as described in RFC 3339/ISO 8601 (e.g. 2023-02-21T00:00:00.000+01:00 ). Example: 2026-02-15T00:00:00.000+01:00.
- `line_items` (`array`, required): Line items: each has a type (custom, material, service or text), name, quantity, unitName and unitPrice (currency, netAmount or grossAmount, taxRatePercentage); material and service items reference an article id. Example: [{"type": "custom", "name": "Consulting", "quantity": 2, "unitName": "Hour", "unitPrice": {"currency": "EUR", "netAmount": 100.0, "taxRatePercentage": 19}}]
- `tax_conditions` (`object`, required): Tax conditions: taxType (net, gross, vatfree, intraCommunitySupply, constructionService13b, externalService13b, thirdPartyCountryService, thirdPartyCountryDelivery), plus taxTypeNote where needed. Example: {"taxType": "net"}
- `total_price` (`object`, required): Total price object; send {"currency": "EUR"} and Lexware calculates the amounts. Example: {"currency": "EUR"}
- `voucher_date` (`string`, required): Date of the document (RFC 3339), for example 2026-01-15T00:00:00.000+01:00. Example: 2026-01-15T00:00:00.000+01:00.
- `finalize` (`boolean`, optional): true creates the document finalized (status open, no longer editable); false or empty creates a draft. Example: false.
- `introduction` (`string`, optional): Introductory text above the line items. Example: Thank you for your order.
- `language` (`string`, optional): Language of the document: de or en. Example: de.
- `payment_conditions` (`object`, optional): Payment terms: paymentTermLabel, paymentTermDuration (days) and optional paymentDiscountConditions. Defaults to the organization's or contact's terms. Example: {"paymentTermLabel": "10 Tage - 3 %, 30 Tage netto", "paymentTermDuration": 30}
- `print_layout_id` (`string`, optional): ID of the print layout to use. Get IDs from lexoffice_print_layouts_list. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `remark` (`string`, optional): Closing text below the line items. Example: We look forward to working with you again.
- `title` (`string`, optional): Title of the document. Defaults to the organization's setting. Example: Rechnung.

Example input: `{"address":{"contactId":"e9066f04-8cc7-4616-93f8-ac9ecc8479c8"},"expiration_date":"<expiration_date>","line_items":[{"type":"custom","name":"Consulting","quantity":2,"unitName":"Hour","unitPrice":{"currency":"EUR","netAmount":100,"taxRatePercentage":19}}],"tax_conditions":{"taxType":"net"},"total_price":{"currency":"EUR"},"voucher_date":"<voucher_date>"}`

### `lexoffice_voucher_create`

Create Bookkeeping Voucher · Write

Create a bookkeeping voucher (a sales or purchase invoice or credit note recorded for accounting, not a document Lexware renders) with totals, tax type and voucher items. Returns the id and version. Get posting category IDs from lexoffice_posting_categories_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `tax_type` (`string`, required): net or gross. Example: net.
- `type` (`string`, required): Voucher type: salesinvoice, salescreditnote, purchaseinvoice or purchasecreditnote. Example: salesinvoice.
- `contact_id` (`string`, optional): ID of an existing contact. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `contact_name` (`string`, optional): Name shown when the collective contact is used. Example: Musterfirma GmbH.
- `due_date` (`string`, optional): Payment due date (yyyy-MM-dd). Example: 2026-02-14.
- `remark` (`string`, optional): Closing text below the line items. Example: We look forward to working with you again.
- `shipping_date` (`string`, optional): Delivery date (yyyy-MM-dd). Example: 2026-01-15.
- `total_gross_amount` (`number`, optional): Total gross amount (sum of the items plus tax). Example: 119.5.
- `total_tax_amount` (`number`, optional): Total tax amount. Example: 19.5.
- `use_collective_contact` (`boolean`, optional): true books against the collective customer/vendor instead of contactId. Example: false.
- `version` (`integer`, optional): 0 when creating. Example: 0.
- `voucher_date` (`string`, optional): Date of the voucher (yyyy-MM-dd). Example: 2026-01-15.
- `voucher_items` (`array`, optional): Items grouped by tax rate: amount, taxAmount, taxRatePercent and categoryId (posting category). Example: [{"amount": 100.0, "taxAmount": 19.0, "taxRatePercent": 19, "categoryId": "8f8664a8-fd86-11e1-a21f-0800200c9a66"}]
- `voucher_number` (`string`, optional): Your reference number of the voucher. Example: RE1234.
- `voucher_status` (`string`, optional): Billing state, for example open or unchecked. Example: open.

Example input: `{"tax_type":"<tax_type>","type":"<type>"}`

### `lexoffice_voucher_update`

Update Bookkeeping Voucher · Write

Replace a bookkeeping voucher's data, sending the current version from lexoffice_voucher_get. Returns the id and new version.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tax_type` (`string`, required): net or gross. Example: net.
- `type` (`string`, required): Voucher type: salesinvoice, salescreditnote, purchaseinvoice or purchasecreditnote. Example: salesinvoice.
- `version` (`integer`, required): Current version from lexoffice_voucher_get. Example: 3.
- `voucher_id` (`string`, required): ID (UUID) of the record. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `contact_id` (`string`, optional): If not using the collective contact option, an existing contact id must be provided. This must exist within Lexware before and can be created via the Contacts endpoint. If a contact is assigned to a voucher, its role must either be Customer , or both Customer and Vendor . Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.
- `contact_name` (`string`, optional): Name of the recipient or invoicing party if the collective contact is used. Please note that if you change the contact name, the voucher will have an individual contact name but is still assigned to the collective contact. Also, changing the contact name does not result in the name of the collective contact being changed. Example: Musterfirma GmbH.
- `due_date` (`string`, optional): Date when the voucher's payment has to be settled. Format must be yyyy-MM-dd (e.g. 2023-06-28 ). Example: 2026-02-14.
- `remark` (`string`, optional): Closing text below the line items. Example: We look forward to working with you again.
- `shipping_date` (`string`, optional): Date when the purchased item/service has to be shipped/supplied. If it is a period of time, the end date must be given. Format must be yyyy-MM-dd (e.g. 2023-07-02 ). Please note: ShippingDate can only be specified for voucher types salesinvoice and salescreditnote . Example: 2026-01-15.
- `total_gross_amount` (`number`, optional): Total gross amount of the voucher. Must match the sum of all positions with added/calculated tax amounts. Format must be ##.00 (119.00) . Example: 119.5.
- `total_tax_amount` (`number`, optional): Total tax amount of the voucher. Must match the sum of all positions' tax amounts. Format must be ##.00 (19.00) . Example: 19.5.
- `use_collective_contact` (`boolean`, optional): Set to true if the Collective Contact (customer/vendor) within Lexware should be used. If used, the optional contactId will be ignored. Example: false.
- `voucher_date` (`string`, optional): Date of the document (RFC 3339), for example 2026-01-15T00:00:00.000+01:00. Example: 2026-01-15.
- `voucher_items` (`array`, optional): Items grouped by tax rate: amount, taxAmount, taxRatePercent and categoryId. Example: [{"amount": 100.0, "taxAmount": 19.0, "taxRatePercent": 19, "categoryId": "8f8664a8-fd86-11e1-a21f-0800200c9a66"}]
- `voucher_number` (`string`, optional): Number of the voucher. Should be the order's identification/reference number. Example: RE1234.
- `voucher_status` (`string`, optional): Billing state of the voucher. Possible values are blank , open , paid , paidoff , voided , transferred , sepadebit , or unchecked . Only open and unchecked are writeable leveraging the Lexware API. Vouchers with status blank are read-only and to be ignored until unchecked or open. Example: open.

Example input: `{"tax_type":"<tax_type>","type":"<type>","version":3,"voucher_id":"<voucher_id>"}`

### `lexoffice_article_delete`

Delete Article · Destructive

Delete an article. Returns an empty response. Get IDs from lexoffice_articles_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `article_id` (`string`, required): ID (UUID) of the article. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"article_id":"<article_id>"}`

### `lexoffice_event_subscription_delete`

Delete Event Subscription · Destructive

Delete an event subscription so Lexware stops calling its URL. Returns an empty response.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `subscription_id` (`string`, required): ID of the event subscription. Example: e9066f04-8cc7-4616-93f8-ac9ecc8479c8.

Example input: `{"subscription_id":"<subscription_id>"}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
