n8n-nodes-lexware-office-full

The complete Lexware Office (formerly lexoffice) API as an
n8n community node — every resource, plus a webhook trigger. Create invoices,
quotations, delivery notes, contacts, vouchers, download PDFs, react to events — all from n8n.

This is an unofficial, community-built integration for https://api.lexware.io. Not affiliated with Lexware / Haufe-Lexware.

✨ Features

• All 20 API resources in one node — see the table below.
• Trigger node that auto-registers a Lexware event subscription (webhook) and cleans it up again.
• Hybrid design: read/list/PDF/file operations are fully structured; create/update take the full
  Lexware JSON body → 100 % field coverage from day one.
• Built-in handling for the tricky parts:
  • Rate limiting (2 req/s) with automatic HTTP 429 backoff
  • Pagination via a simple Return All toggle
  • Optimistic locking (Auto Version fetches the current version before updating)
  • Two-step PDF (/document → /files/{id}) as a single Get PDF operation (PDF or e-invoice XML)
  • Binary upload & download

📦 Installation

Option A — Community Nodes GUI (recommended, self-hosted)

1. Start n8n with community packages enabled: N8N_COMMUNITY_PACKAGES_ENABLED=true
2. In n8n: Settings → Community Nodes → Install and enter:

   n8n-nodes-lexware-office-full
   

Option B — Docker image

FROM n8nio/n8n
RUN npm install -g n8n-nodes-lexware-office-full

Option C — Manual (custom extensions)

npm install n8n-nodes-lexware-office-full
# point n8n at it via N8N_CUSTOM_EXTENSIONS=/path/to/node_modules

🔑 Credentials

Create a Lexware Office API credential and paste your public API key
(Lexware Office → Settings → Public API → Generate key). The base URL defaults to
https://api.lexware.io (legacy https://api.lexoffice.io also works). The credential is verified
against GET /v1/profile.

🧩 Resources & operations

🚀 Examples

Create a draft invoice — Resource Invoice, Operation Create, Data (JSON):

{
  "voucherDate": "2026-06-11T12:00:00.000+02:00",
  "address": { "contactId": "<contact-uuid>" },
  "lineItems": [
    { "type": "custom", "name": "Consulting", "quantity": 1, "unitName": "hour",
      "unitPrice": { "currency": "EUR", "netAmount": 100, "taxRatePercentage": 19 } }
  ],
  "totalPrice": { "currency": "EUR" },
  "taxConditions": { "taxType": "net" },
  "shippingConditions": { "shippingType": "none" }
}

Set Finalize = true to issue it instead of saving a draft.

Download a PDF — Resource Invoice, Operation Get PDF, the invoice ID. Returns the PDF as binary
(draft vouchers have no PDF yet and return 406).

React to events — add the Lexware Office Trigger, set e.g. invoice.changed. It registers the
subscription automatically and emits each event (toggle Resolve Resource to also fetch the full record).

🛠️ Development

npm install
npm run build      # tsc + copy icons -> dist/

🤝 Contributing

Issues and PRs welcome. The create/update operations accept raw JSON so the node already covers every
field; structured fields per resource can be added incrementally.

📄 License

MIT © Adrian Awad / Kneissl Messtechnik GmbH