# Lexware Office

Create and find contacts and articles, write invoices (Rechnungen), quotations (Angebote), order confirmations, delivery notes, credit notes and dunnings as drafts or finalized and download their PDF, record bookkeeping vouchers (Belege) with their files, and read payments in Lexware Office (formerly lexoffice).

## Connect Lexware Office

1. In the sidebar, open **Connections** and press **Add connection**.
2. Type `lexware office` and choose **Lexware Office**.
3. Fill in the fields. Each one says **Required** or **Optional**.
4. Press **Test and save**. GoRunner checks the connection before it saves anything.

The sheet asks for:

- **API Key · Required**: The Public API key from Lexware Office (Add-ons → Public API).

Paste a Lexware Office Public API key: in Lexware Office open Add-ons → Public API (app.lexware.de/addons/public-api) and create a key. The key acts with the rights of the person who made it; a key that is renewed or deleted stops this connection.

[Connections](https://docs.gorunner.io/build/connections) says how to sign in again, rename or delete it. In a product that embeds GoRunner, **Add connection** can be missing: then [your provider makes connections](https://docs.gorunner.io/embed/customer-connections) for you.

## Start a workflow

Add a trigger and choose **Lexware Office**. The trigger uses the same connection as the steps.

### On Lexware Office Event

Starts a run each time Lexware Office reports one of the events below. Publishing the workflow registers an event subscription per event in Lexware Office; unpublishing removes them. Every delivery is checked against Lexware's signature (X-Lxo-Signature) and the connected organization, and a repeated delivery starts no second run. The run gets the record's id (resourceId); read the record itself with the Lexware Office step. Renewing or deleting the connection's API key in Lexware removes the subscriptions: they are registered again within a day, or at once on the next publish.

- **Events · Required**: What starts a run. Options: Invoice created to Recurring invoice template deleted (41 options).

A later step can use its data, such as `{{trigger.event}}`, `{{trigger.eventDate}}`, `{{trigger.eventType}}` and 4 more. See [Use data from earlier steps](https://docs.gorunner.io/build/use-data-from-earlier-steps).

## Do things in Lexware Office

Add a **Lexware Office** step, choose a **Resource**, then an **Operation**. Choose a row to see its fields.

- [Contact](https://docs.gorunner.io/apps/lexware-office#fields-f-contact): Create · Get · Get Many · Update
- [Article](https://docs.gorunner.io/apps/lexware-office#fields-f-article): Create · Get · Get Many · Update · Delete
- [Invoice](https://docs.gorunner.io/apps/lexware-office#fields-f-invoice): Create · Get · Get Many · Download Document
- [Quotation](https://docs.gorunner.io/apps/lexware-office#fields-f-quotation): Create · Get · Get Many · Download Document
- [Order Confirmation](https://docs.gorunner.io/apps/lexware-office#fields-f-orderconfirmation): Create · Get · Get Many · Download Document
- [Delivery Note](https://docs.gorunner.io/apps/lexware-office#fields-f-deliverynote): Create · Get · Get Many · Download Document
- [Credit Note](https://docs.gorunner.io/apps/lexware-office#fields-f-creditnote): Create · Get · Get Many · Download Document
- [Dunning](https://docs.gorunner.io/apps/lexware-office#fields-f-dunning): Create · Get · Download Document
- [Bookkeeping Voucher](https://docs.gorunner.io/apps/lexware-office#fields-f-voucher): Create · Get · Get Many · Upload Receipt · Attach File
- [Payment](https://docs.gorunner.io/apps/lexware-office#fields-f-payment): Get
- [Voucher List](https://docs.gorunner.io/apps/lexware-office#fields-f-voucherlist): Get Many
- [Posting Category](https://docs.gorunner.io/apps/lexware-office#fields-f-postingcategory): Get Many
- [Profile](https://docs.gorunner.io/apps/lexware-office#fields-f-profile): Get

Later steps read a step’s output by its name: see [Use data from earlier steps](https://docs.gorunner.io/build/use-data-from-earlier-steps).

## Limits

- A reply from Lexware Office can be up to 16 MB (a file download can have its own limit). A larger one fails the step; it is never cut short.
- When Lexware Office says to slow down (429), the step waits as long as it asks, if the step’s time allows. Otherwise it fails and says when to try again.

Not in your list? See [When an app isn’t here](https://docs.gorunner.io/apps/when-an-app-isnt-here#q-not-in-list).

## For developers

In the API, which calls apps pieces, Lexware Office is `pieceId: "lexoffice"` with `actionId: "lexoffice"`, set by `resource` and an `operation_…` field, such as `operation_article`. Its trigger is `lexofficetrigger` / `lexoffice_event`. [Get an app](https://docs.gorunner.io/api/apps/get-app) returns every field.

It can change something outside the run (`writes_external`). See [How versions and side effects work](https://docs.gorunner.io/apps#q-versions).

### Lexware Office › Contact

### Create

- **Role · Optional**: Whether the contact is a customer (Kunde), a vendor (Lieferant), or both. Every contact needs one. Options: Customer, Vendor, Customer and vendor. Default: Customer.
- **Type · Optional**: A company, or a private person. Options: Company, Person. Default: Company.
- **Company Name · Optional**: The company's name (a company contact).
- **Salutation · Optional**: Herr, Frau … (at most 25 characters). For a company, the contact person's.
- **First Name · Optional**: The person's first name: for a company, its contact person's.
- **Last Name · Optional**: The person's last name: for a company, its contact person's (needed for a contact person).
- **Email · Optional**: A business email address.
- **Phone · Optional**: A business phone number.
- **Street · Optional**: Street and number of the billing address.
- **ZIP Code · Optional**
- **City · Optional**
- **Country · Optional**: ISO country code of the billing address (DE, AT, CH …). Taken as DE when an address is given without one.
- **VAT ID · Optional**: The company's VAT registration id (USt-IdNr.), such as DE123456789.
- **Tax Number · Optional**: The company's tax number (Steuernummer).
- **Note · Optional**: An internal note (at most 1,000 characters).

### Get

- **Contact · Required**: The contact to read or change.

### Get Many

- **Name · Optional**: Contacts whose name contains this text (at least 3 characters).
- **Email · Optional**: Contacts with an email address containing this text (at least 3 characters).
- **Customer or Vendor Number · Optional**: The contact with this customer or vendor number.
- **Role · Optional**: Only customers, only vendors, or every contact. Options: Every contact, Customers, Vendors. Default: Every contact.
- **Return All · Optional**: Read every contact, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many contacts to return (1–5000). Default: 50. Shows when **Return All** is off.

### Update

- **Contact · Required**: The contact to read or change.
- **Company Name · Optional**: The company's name (a company contact).
- **Salutation · Optional**: Herr, Frau … (at most 25 characters). For a company, the contact person's.
- **First Name · Optional**: The person's first name: for a company, its contact person's.
- **Last Name · Optional**: The person's last name: for a company, its contact person's (needed for a contact person).
- **Email · Optional**: A business email address.
- **Phone · Optional**: A business phone number.
- **Street · Optional**: Street and number of the billing address.
- **ZIP Code · Optional**
- **City · Optional**
- **Country · Optional**: ISO country code of the billing address (DE, AT, CH …). Taken as DE when an address is given without one.
- **VAT ID · Optional**: The company's VAT registration id (USt-IdNr.), such as DE123456789.
- **Tax Number · Optional**: The company's tax number (Steuernummer).
- **Note · Optional**: An internal note (at most 1,000 characters).

### Lexware Office › Article

### Create

- **Title · Optional**: The article's name. Required to create.
- **Type · Optional**: A product or a service. Empty: a product when creating, unchanged when updating. Options: Product, Service.
- **Unit · Optional**: The unit it is sold in: Stück, Stunde, Pauschal … Required to create.
- **Price · Optional**: The price, net or gross as Price Is says. Required to create.
- **Price Is · Optional**: Whether Price is the net or the gross price (empty: net); Lexware works out the other from the tax rate. Options: Net, Gross.
- **Tax Rate · Optional**: The VAT rate in percent. Empty: 19 % when creating, unchanged when updating. Options: 19 %, 7 %, 0 %.
- **Article Number · Optional**: Your own number for it.
- **GTIN · Optional**: GTIN-8, -12, -13 or -14 (EAN).
- **Description · Optional**: Shown on vouchers.
- **Internal Note · Optional**

### Get and Delete

- **Article · Required**: The article.

### Get Many

- **Article Number · Optional**: The article with this number.
- **GTIN · Optional**: Articles with this GTIN.
- **Type · Optional**: Only products, only services, or both. Options: Both, Products, Services. Default: Both.
- **Return All · Optional**: Read every article, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many articles to return (1–5000). Default: 50. Shows when **Return All** is off.

### Update

- **Article · Required**: The article.
- **Title · Optional**: The article's name. Required to create.
- **Type · Optional**: A product or a service. Empty: a product when creating, unchanged when updating. Options: Product, Service.
- **Unit · Optional**: The unit it is sold in: Stück, Stunde, Pauschal … Required to create.
- **Price · Optional**: The price, net or gross as Price Is says. Required to create.
- **Price Is · Optional**: Whether Price is the net or the gross price (empty: net); Lexware works out the other from the tax rate. Options: Net, Gross.
- **Tax Rate · Optional**: The VAT rate in percent. Empty: 19 % when creating, unchanged when updating. Options: 19 %, 7 %, 0 %.
- **Article Number · Optional**: Your own number for it.
- **GTIN · Optional**: GTIN-8, -12, -13 or -14 (EAN).
- **Description · Optional**: Shown on vouchers.
- **Internal Note · Optional**

### Lexware Office › Invoice

### Create

- **Create From · Optional**: The id of a quotation, order confirmation or delivery note to turn into this invoice (Lexware's "pursue"); its contact and items are taken over unless set here.
- **Contact · Optional**: The customer the invoice is for. Leave empty to write a one-time address below instead.
- **Recipient Name · Optional**: For a one-time address (no contact): the recipient's name. Required with Country when no contact is picked.
- **Street · Optional**: One-time address: street and number.
- **ZIP Code · Optional**: One-time address.
- **City · Optional**: One-time address.
- **Country · Optional**: One-time address: ISO country code (DE, AT, CH …). Empty: DE.
- **Date · Optional**: The invoice's date: 2026-11-01 or 2026-11-01T10:00:00+01:00. Empty: now.
- **Line Items · Optional**: The invoice's positions (at most 300). A custom line needs a name, quantity, unit and price; a service or material line names its article; a text line only a name.
- **Tax Type · Optional**: How VAT is applied (Steuerart). Options: Net (prices plus VAT), Gross (prices include VAT), VAT-free (steuerfrei), Intra-community supply (§13b UStG), Construction services (§13b UStG), External services in the EU (§13b UStG), Services to non-EU countries, Deliveries to non-EU countries, Photovoltaic equipment (0 %). Default: Net (prices plus VAT).
- **Total Discount (%) · Optional**: A discount on the whole voucher.
- **Delivery · Optional**: When the goods or services are delivered (Leistungsdatum), which Lexware requires. Options: No delivery date, Service on a date, Service over a period, Delivery on a date, Delivery over a period. Default: No delivery date.
- **Delivery Date · Optional**: The delivery or service date (the start of a period). Empty: the voucher's date. Shows when **Delivery** is **Service on a date**, **Service over a period**, **Delivery on a date** or **Delivery over a period**.
- **Delivery End Date · Required**: The end of the period. Shows when **Delivery** is **Service over a period** or **Delivery over a period**.
- **Payment Term (days) · Optional**: Days to pay. Empty: the contact's or the organization's default.
- **Title · Optional**: The heading on the document. Empty: the organization's default.
- **Introduction · Optional**: The text above the items. Empty: the organization's default.
- **Closing Text · Optional**: The text below the items. Empty: the organization's default.
- **Language · Optional**: The document's language. Options: German, English. Default: German.
- **Print Layout · Optional**: The layout to print with. Empty: the default layout.
- **Finalize · Optional**: Create the invoice finalized (open, numbered, its document made) instead of as a draft. A finalized voucher can no longer be changed. Off by default.
- **Other Fields · Optional**: More of Lexware's fields as JSON, such as {"xRechnung": {"buyerReference": "04011000-1234512345-35"}}. A field set above wins.

### Get

- **Invoice · Required**: The invoice's id, or its link from Lexware Office.

### Get Many

- **Status · Optional**: Only invoices in these states. Empty: every state. Overdue cannot be combined with another state. Options: draft, open, paid, voided, overdue.
- **Contact · Optional**: Only vouchers of this contact.
- **Voucher Number · Optional**: Only the voucher with this number.
- **Dated From · Optional**: Vouchers dated on or after this day (2026-11-01).
- **Dated Until · Optional**: Vouchers dated on or before this day.
- **Changed From · Optional**: Vouchers last changed on or after this day.
- **Changed Until · Optional**: Vouchers last changed on or before this day.
- **Archived · Optional**: Archived vouchers, the others, or both. Options: Both, Not archived, Archived only. Default: Both.
- **Order · Optional**: How the list is sorted. Options: Date, newest first, Date, oldest first, Number, highest first, Number, lowest first, Created, newest first, Created, oldest first, Changed, newest first, Changed, oldest first. Default: Date, newest first.
- **Return All · Optional**: Read every invoice, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many invoices to return (1–5000). Default: 50. Shows when **Return All** is off.

### Download Document

- **Invoice · Required**: The invoice's id, or its link from Lexware Office.
- **Format · Optional**: The PDF, or the XML of an XRechnung e-invoice (only invoices and credit notes sent as XRechnung have one). Options: PDF, XRechnung XML. Default: PDF.

### Lexware Office › Quotation

### Create

- **Contact · Optional**: The customer the quotation is for. Leave empty to write a one-time address below instead.
- **Recipient Name · Optional**: For a one-time address (no contact): the recipient's name. Required with Country when no contact is picked.
- **Street · Optional**: One-time address: street and number.
- **ZIP Code · Optional**: One-time address.
- **City · Optional**: One-time address.
- **Country · Optional**: One-time address: ISO country code (DE, AT, CH …). Empty: DE.
- **Date · Optional**: The quotation's date: 2026-11-01 or 2026-11-01T10:00:00+01:00. Empty: now.
- **Valid Until · Optional**: The date the quotation expires. Empty: 30 days after its date.
- **Line Items · Required**: The quotation's positions (at most 300). A custom line needs a name, quantity, unit and price; a service or material line names its article; a text line only a name.
- **Tax Type · Optional**: How VAT is applied (Steuerart). Options: Net (prices plus VAT), Gross (prices include VAT), VAT-free (steuerfrei), Intra-community supply (§13b UStG), Construction services (§13b UStG), External services in the EU (§13b UStG), Services to non-EU countries, Deliveries to non-EU countries, Photovoltaic equipment (0 %). Default: Net (prices plus VAT).
- **Total Discount (%) · Optional**: A discount on the whole voucher.
- **Payment Term (days) · Optional**: Days to pay. Empty: the contact's or the organization's default.
- **Title · Optional**: The heading on the document. Empty: the organization's default.
- **Introduction · Optional**: The text above the items. Empty: the organization's default.
- **Closing Text · Optional**: The text below the items. Empty: the organization's default.
- **Language · Optional**: The document's language. Options: German, English. Default: German.
- **Print Layout · Optional**: The layout to print with. Empty: the default layout.
- **Finalize · Optional**: Create the quotation finalized (open, numbered, its document made) instead of as a draft. A finalized voucher can no longer be changed. Off by default.
- **Other Fields · Optional**: More of Lexware's fields as JSON, such as {"xRechnung": {"buyerReference": "04011000-1234512345-35"}}. A field set above wins.

### Get

- **Quotation · Required**: The quotation's id, or its link from Lexware Office.

### Get Many

- **Status · Optional**: Only quotations in these states. Empty: every state. Overdue cannot be combined with another state. Options: draft, open, accepted, rejected.
- **Contact · Optional**: Only vouchers of this contact.
- **Voucher Number · Optional**: Only the voucher with this number.
- **Dated From · Optional**: Vouchers dated on or after this day (2026-11-01).
- **Dated Until · Optional**: Vouchers dated on or before this day.
- **Changed From · Optional**: Vouchers last changed on or after this day.
- **Changed Until · Optional**: Vouchers last changed on or before this day.
- **Archived · Optional**: Archived vouchers, the others, or both. Options: Both, Not archived, Archived only. Default: Both.
- **Order · Optional**: How the list is sorted. Options: Date, newest first, Date, oldest first, Number, highest first, Number, lowest first, Created, newest first, Created, oldest first, Changed, newest first, Changed, oldest first. Default: Date, newest first.
- **Return All · Optional**: Read every quotation, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many quotations to return (1–5000). Default: 50. Shows when **Return All** is off.

### Download Document

- **Quotation · Required**: The quotation's id, or its link from Lexware Office.
- **Format · Optional**: The PDF, or the XML of an XRechnung e-invoice (only invoices and credit notes sent as XRechnung have one). Options: PDF, XRechnung XML. Default: PDF.

### Lexware Office › Order Confirmation

### Create

- **Create From · Optional**: The id of a quotation to turn into this order confirmation (Lexware's "pursue"); its contact and items are taken over unless set here.
- **Contact · Optional**: The customer the order confirmation is for. Leave empty to write a one-time address below instead.
- **Recipient Name · Optional**: For a one-time address (no contact): the recipient's name. Required with Country when no contact is picked.
- **Street · Optional**: One-time address: street and number.
- **ZIP Code · Optional**: One-time address.
- **City · Optional**: One-time address.
- **Country · Optional**: One-time address: ISO country code (DE, AT, CH …). Empty: DE.
- **Date · Optional**: The order confirmation's date: 2026-11-01 or 2026-11-01T10:00:00+01:00. Empty: now.
- **Line Items · Optional**: The order confirmation's positions (at most 300). A custom line needs a name, quantity, unit and price; a service or material line names its article; a text line only a name.
- **Tax Type · Optional**: How VAT is applied (Steuerart). Options: Net (prices plus VAT), Gross (prices include VAT), VAT-free (steuerfrei), Intra-community supply (§13b UStG), Construction services (§13b UStG), External services in the EU (§13b UStG), Services to non-EU countries, Deliveries to non-EU countries, Photovoltaic equipment (0 %). Default: Net (prices plus VAT).
- **Total Discount (%) · Optional**: A discount on the whole voucher.
- **Delivery · Optional**: When the goods or services are delivered (Leistungsdatum), which Lexware requires. Options: No delivery date, Service on a date, Service over a period, Delivery on a date, Delivery over a period. Default: No delivery date.
- **Delivery Date · Optional**: The delivery or service date (the start of a period). Empty: the voucher's date. Shows when **Delivery** is **Service on a date**, **Service over a period**, **Delivery on a date** or **Delivery over a period**.
- **Delivery End Date · Required**: The end of the period. Shows when **Delivery** is **Service over a period** or **Delivery over a period**.
- **Payment Term (days) · Optional**: Days to pay. Empty: the contact's or the organization's default.
- **Title · Optional**: The heading on the document. Empty: the organization's default.
- **Introduction · Optional**: The text above the items. Empty: the organization's default.
- **Closing Text · Optional**: The text below the items. Empty: the organization's default.
- **Language · Optional**: The document's language. Options: German, English. Default: German.
- **Print Layout · Optional**: The layout to print with. Empty: the default layout.
- **Finalize · Optional**: Create the order confirmation finalized (open, numbered, its document made) instead of as a draft. A finalized voucher can no longer be changed. Off by default.
- **Other Fields · Optional**: More of Lexware's fields as JSON, such as {"xRechnung": {"buyerReference": "04011000-1234512345-35"}}. A field set above wins.

### Get

- **Order Confirmation · Required**: The order confirmation's id, or its link from Lexware Office.

### Get Many

- **Status · Optional**: Only order confirmations in these states. Empty: every state. Overdue cannot be combined with another state. Options: draft, open.
- **Contact · Optional**: Only vouchers of this contact.
- **Voucher Number · Optional**: Only the voucher with this number.
- **Dated From · Optional**: Vouchers dated on or after this day (2026-11-01).
- **Dated Until · Optional**: Vouchers dated on or before this day.
- **Changed From · Optional**: Vouchers last changed on or after this day.
- **Changed Until · Optional**: Vouchers last changed on or before this day.
- **Archived · Optional**: Archived vouchers, the others, or both. Options: Both, Not archived, Archived only. Default: Both.
- **Order · Optional**: How the list is sorted. Options: Date, newest first, Date, oldest first, Number, highest first, Number, lowest first, Created, newest first, Created, oldest first, Changed, newest first, Changed, oldest first. Default: Date, newest first.
- **Return All · Optional**: Read every order confirmation, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many order confirmations to return (1–5000). Default: 50. Shows when **Return All** is off.

### Download Document

- **Order Confirmation · Required**: The order confirmation's id, or its link from Lexware Office.
- **Format · Optional**: The PDF, or the XML of an XRechnung e-invoice (only invoices and credit notes sent as XRechnung have one). Options: PDF, XRechnung XML. Default: PDF.

### Lexware Office › Delivery Note

### Create

- **Create From · Optional**: The id of a quotation, order confirmation or invoice to turn into this delivery note (Lexware's "pursue"); its contact and items are taken over unless set here.
- **Contact · Optional**: The customer the delivery note is for. Leave empty to write a one-time address below instead.
- **Recipient Name · Optional**: For a one-time address (no contact): the recipient's name. Required with Country when no contact is picked.
- **Street · Optional**: One-time address: street and number.
- **ZIP Code · Optional**: One-time address.
- **City · Optional**: One-time address.
- **Country · Optional**: One-time address: ISO country code (DE, AT, CH …). Empty: DE.
- **Date · Optional**: The delivery note's date: 2026-11-01 or 2026-11-01T10:00:00+01:00. Empty: now.
- **Line Items · Optional**: The positions delivered (at most 300). Prices are optional on a delivery note.
- **Tax Type · Optional**: How VAT is applied (Steuerart). Options: Net (prices plus VAT), Gross (prices include VAT), VAT-free (steuerfrei), Intra-community supply (§13b UStG), Construction services (§13b UStG), External services in the EU (§13b UStG), Services to non-EU countries, Deliveries to non-EU countries, Photovoltaic equipment (0 %). Default: Net (prices plus VAT).
- **Delivery · Optional**: When the goods or services are delivered (Leistungsdatum), which Lexware requires. Options: No delivery date, Service on a date, Service over a period, Delivery on a date, Delivery over a period. Default: No delivery date.
- **Delivery Date · Optional**: The delivery or service date (the start of a period). Empty: the voucher's date. Shows when **Delivery** is **Service on a date**, **Service over a period**, **Delivery on a date** or **Delivery over a period**.
- **Delivery End Date · Required**: The end of the period. Shows when **Delivery** is **Service over a period** or **Delivery over a period**.
- **Title · Optional**: The heading on the document. Empty: the organization's default.
- **Introduction · Optional**: The text above the items. Empty: the organization's default.
- **Closing Text · Optional**: The text below the items. Empty: the organization's default.
- **Language · Optional**: The document's language. Options: German, English. Default: German.
- **Print Layout · Optional**: The layout to print with. Empty: the default layout.
- **Finalize · Optional**: Create the delivery note finalized (open, numbered, its document made) instead of as a draft. A finalized voucher can no longer be changed. Off by default.
- **Other Fields · Optional**: More of Lexware's fields as JSON, such as {"xRechnung": {"buyerReference": "04011000-1234512345-35"}}. A field set above wins.

### Get

- **Delivery Note · Required**: The delivery note's id, or its link from Lexware Office.

### Get Many

- **Status · Optional**: Only delivery notes in these states. Empty: every state. Overdue cannot be combined with another state. Options: draft, open.
- **Contact · Optional**: Only vouchers of this contact.
- **Voucher Number · Optional**: Only the voucher with this number.
- **Dated From · Optional**: Vouchers dated on or after this day (2026-11-01).
- **Dated Until · Optional**: Vouchers dated on or before this day.
- **Changed From · Optional**: Vouchers last changed on or after this day.
- **Changed Until · Optional**: Vouchers last changed on or before this day.
- **Archived · Optional**: Archived vouchers, the others, or both. Options: Both, Not archived, Archived only. Default: Both.
- **Order · Optional**: How the list is sorted. Options: Date, newest first, Date, oldest first, Number, highest first, Number, lowest first, Created, newest first, Created, oldest first, Changed, newest first, Changed, oldest first. Default: Date, newest first.
- **Return All · Optional**: Read every delivery note, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many delivery notes to return (1–5000). Default: 50. Shows when **Return All** is off.

### Download Document

- **Delivery Note · Required**: The delivery note's id, or its link from Lexware Office.
- **Format · Optional**: The PDF, or the XML of an XRechnung e-invoice (only invoices and credit notes sent as XRechnung have one). Options: PDF, XRechnung XML. Default: PDF.

### Lexware Office › Credit Note

### Create

- **Create From · Optional**: The id of an invoice to turn into this credit note (Lexware's "pursue"); its contact and items are taken over unless set here.
- **Contact · Optional**: The customer the credit note is for. Leave empty to write a one-time address below instead.
- **Recipient Name · Optional**: For a one-time address (no contact): the recipient's name. Required with Country when no contact is picked.
- **Street · Optional**: One-time address: street and number.
- **ZIP Code · Optional**: One-time address.
- **City · Optional**: One-time address.
- **Country · Optional**: One-time address: ISO country code (DE, AT, CH …). Empty: DE.
- **Date · Optional**: The credit note's date: 2026-11-01 or 2026-11-01T10:00:00+01:00. Empty: now.
- **Line Items · Optional**: The credit note's positions (at most 300). A custom line needs a name, quantity, unit and price; a service or material line names its article; a text line only a name.
- **Tax Type · Optional**: How VAT is applied (Steuerart). Options: Net (prices plus VAT), Gross (prices include VAT), VAT-free (steuerfrei), Intra-community supply (§13b UStG), Construction services (§13b UStG), External services in the EU (§13b UStG), Services to non-EU countries, Deliveries to non-EU countries, Photovoltaic equipment (0 %). Default: Net (prices plus VAT).
- **Total Discount (%) · Optional**: A discount on the whole voucher.
- **Title · Optional**: The heading on the document. Empty: the organization's default.
- **Introduction · Optional**: The text above the items. Empty: the organization's default.
- **Closing Text · Optional**: The text below the items. Empty: the organization's default.
- **Language · Optional**: The document's language. Options: German, English. Default: German.
- **Print Layout · Optional**: The layout to print with. Empty: the default layout.
- **Finalize · Optional**: Create the credit note finalized (open, numbered, its document made) instead of as a draft. A finalized voucher can no longer be changed. Off by default.
- **Other Fields · Optional**: More of Lexware's fields as JSON, such as {"xRechnung": {"buyerReference": "04011000-1234512345-35"}}. A field set above wins.

### Get

- **Credit Note · Required**: The credit note's id, or its link from Lexware Office.

### Get Many

- **Status · Optional**: Only credit notes in these states. Empty: every state. Overdue cannot be combined with another state. Options: draft, open, paidoff, voided.
- **Contact · Optional**: Only vouchers of this contact.
- **Voucher Number · Optional**: Only the voucher with this number.
- **Dated From · Optional**: Vouchers dated on or after this day (2026-11-01).
- **Dated Until · Optional**: Vouchers dated on or before this day.
- **Changed From · Optional**: Vouchers last changed on or after this day.
- **Changed Until · Optional**: Vouchers last changed on or before this day.
- **Archived · Optional**: Archived vouchers, the others, or both. Options: Both, Not archived, Archived only. Default: Both.
- **Order · Optional**: How the list is sorted. Options: Date, newest first, Date, oldest first, Number, highest first, Number, lowest first, Created, newest first, Created, oldest first, Changed, newest first, Changed, oldest first. Default: Date, newest first.
- **Return All · Optional**: Read every credit note, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many credit notes to return (1–5000). Default: 50. Shows when **Return All** is off.

### Download Document

- **Credit Note · Required**: The credit note's id, or its link from Lexware Office.
- **Format · Optional**: The PDF, or the XML of an XRechnung e-invoice (only invoices and credit notes sent as XRechnung have one). Options: PDF, XRechnung XML. Default: PDF.

### Lexware Office › Dunning

### Create

- **Invoice · Required**: The id of the open invoice this dunning is for.
- **Contact · Optional**: The customer the dunning is for. Leave empty to write a one-time address below instead.
- **Recipient Name · Optional**: For a one-time address (no contact): the recipient's name. Required with Country when no contact is picked.
- **Street · Optional**: One-time address: street and number.
- **ZIP Code · Optional**: One-time address.
- **City · Optional**: One-time address.
- **Country · Optional**: One-time address: ISO country code (DE, AT, CH …). Empty: DE.
- **Date · Optional**: The dunning's date: 2026-11-01 or 2026-11-01T10:00:00+01:00. Empty: now.
- **Line Items · Optional**: The dunning's positions (at most 300). A custom line needs a name, quantity, unit and price; a service or material line names its article; a text line only a name.
- **Tax Type · Optional**: How VAT is applied (Steuerart). Options: Net (prices plus VAT), Gross (prices include VAT), VAT-free (steuerfrei), Intra-community supply (§13b UStG), Construction services (§13b UStG), External services in the EU (§13b UStG), Services to non-EU countries, Deliveries to non-EU countries, Photovoltaic equipment (0 %). Default: Net (prices plus VAT).
- **Total Discount (%) · Optional**: A discount on the whole voucher.
- **Title · Optional**: The heading on the document. Empty: the organization's default.
- **Introduction · Optional**: The text above the items. Empty: the organization's default.
- **Closing Text · Optional**: The text below the items. Empty: the organization's default.
- **Language · Optional**: The document's language. Options: German, English. Default: German.
- **Print Layout · Optional**: The layout to print with. Empty: the default layout.
- **Other Fields · Optional**: More of Lexware's fields as JSON, such as {"xRechnung": {"buyerReference": "04011000-1234512345-35"}}. A field set above wins.

### Get

- **Dunning · Required**: The dunning's id, or its link from Lexware Office.

### Download Document

- **Dunning · Required**: The dunning's id, or its link from Lexware Office.
- **Format · Optional**: The PDF, or the XML of an XRechnung e-invoice (only invoices and credit notes sent as XRechnung have one). Options: PDF, XRechnung XML. Default: PDF.

### Lexware Office › Bookkeeping Voucher

### Create

- **Type · Optional**: What the voucher records. Options: Purchase invoice (Eingangsrechnung), Purchase credit note, Sales invoice (Ausgangsrechnung), Sales credit note. Default: Purchase invoice (Eingangsrechnung).
- **Status · Optional**: Open: complete and ready to book (number, date, amounts and items required). Unchecked: Lexware's "Zu prüfen". Details may be missing (gross vouchers only). Options: Open, Unchecked (Zu prüfen). Default: Open.
- **Voucher Date · Optional**: The receipt's date (2026-11-01).
- **Due Date · Optional**: When it is to be paid. Empty: the voucher date.
- **Delivery Date · Optional**: Sales vouchers only: the delivery or service date.
- **Contact · Optional**: The vendor or customer. Leave empty to book to the collective contact (Sammelkontakt) under Contact Name.
- **Contact Name · Optional**: With no contact picked: the name shown for the collective contact.
- **Amounts Are · Optional**: Whether the item amounts are gross (VAT included) or net. Options: Gross, Net. Default: Gross.
- **Items · Optional**: The amounts by tax rate and posting category (Buchungskategorie). Totals are added up from them.
- **Remark · Optional**: A note, searchable in Lexware Office.
- **Receipt File · Optional**: Upload a file, or switch to an expression to use one from an earlier step (such as {{steps.download.result}}). PDF, JPG, PNG or XML (e-invoice), at most 5 MB. Attached after the voucher is created.

### Get

- **Voucher · Required**: The voucher's id, or its link from Lexware Office.

### Get Many

- **Types · Optional**: Which kinds of bookkeeping voucher. Empty: all four. Options: Purchase invoice (Eingangsrechnung), Purchase credit note, Sales invoice (Ausgangsrechnung), Sales credit note.
- **Status · Optional**: Only vouchers in these states. Empty: every state. Options: open, paid, paidoff, voided, transferred, sepadebit, unchecked, overdue.
- **Contact · Optional**: Only vouchers of this contact.
- **Voucher Number · Optional**: Only the voucher with this number.
- **Dated From · Optional**: Vouchers dated on or after this day (2026-11-01).
- **Dated Until · Optional**: Vouchers dated on or before this day.
- **Changed From · Optional**: Vouchers last changed on or after this day.
- **Changed Until · Optional**: Vouchers last changed on or before this day.
- **Archived · Optional**: Archived vouchers, the others, or both. Options: Both, Not archived, Archived only. Default: Both.
- **Order · Optional**: How the list is sorted. Options: Date, newest first, Date, oldest first, Number, highest first, Number, lowest first, Created, newest first, Created, oldest first, Changed, newest first, Changed, oldest first. Default: Date, newest first.
- **Return All · Optional**: Read every voucher, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many vouchers to return (1–5000). Default: 50. Shows when **Return All** is off.

### Upload Receipt

- **File · Required**: Upload a file, or switch to an expression to use one from an earlier step (such as {{steps.download.result}}). PDF, JPG, PNG or XML (e-invoice), at most 5 MB.

### Attach File

- **Voucher · Required**: The voucher's id, or its link from Lexware Office.
- **File · Required**: Upload a file, or switch to an expression to use one from an earlier step (such as {{steps.download.result}}). PDF, JPG, PNG or XML (e-invoice), at most 5 MB.

### Lexware Office › Payment

### Get

- **Voucher · Required**: The id of an invoice, credit note, down payment invoice or bookkeeping voucher (not a draft).

### Lexware Office › Voucher List

### Get Many

- **Types · Optional**: Which kinds of voucher. Empty: every kind. Options: invoice, downpaymentinvoice, creditnote, orderconfirmation, quotation, deliverynote, salesinvoice, salescreditnote, purchaseinvoice, purchasecreditnote.
- **Status · Optional**: Only vouchers in these states. Empty: every state. Overdue cannot be combined with another state. Options: draft, open, overdue, paid, paidoff, voided, transferred, sepadebit, accepted, rejected, unchecked.
- **Contact · Optional**: Only vouchers of this contact.
- **Voucher Number · Optional**: Only the voucher with this number.
- **Dated From · Optional**: Vouchers dated on or after this day (2026-11-01).
- **Dated Until · Optional**: Vouchers dated on or before this day.
- **Changed From · Optional**: Vouchers last changed on or after this day.
- **Changed Until · Optional**: Vouchers last changed on or before this day.
- **Archived · Optional**: Archived vouchers, the others, or both. Options: Both, Not archived, Archived only. Default: Both.
- **Order · Optional**: How the list is sorted. Options: Date, newest first, Date, oldest first, Number, highest first, Number, lowest first, Created, newest first, Created, oldest first, Changed, newest first, Changed, oldest first. Default: Date, newest first.
- **Return All · Optional**: Read every voucher, page by page (at most 5000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many vouchers to return (1–5000). Default: 50. Shows when **Return All** is off.

### Lexware Office › Posting Category

### Get Many

- **Type · Optional**: Income or expense categories, or both. Options: Both, Income, Expense. Default: Both.

### Lexware Office › Profile

### Get

Nothing to fill in.

Source: https://docs.gorunner.io/apps/lexware-office