n8n-nodes-buchpilot

n8n Community Nodes fuer sevDesk und Lexoffice — die beliebtesten Buchhaltungstools im DACH-Raum.

Was ist das?

BuchPilot bringt sevDesk und Lexoffice als native Nodes in n8n. Damit kannst du deine DACH-Buchhaltung direkt in n8n-Workflows automatisieren — ohne Custom HTTP Requests.

Features

• 4 Nodes fuer sevDesk und Lexoffice (Action + Trigger)
• Kontakte erstellen, lesen, aktualisieren, loeschen
• Rechnungen erstellen, lesen, aktualisieren, loeschen, als PDF herunterladen
• Belege erstellen, lesen, auflisten
• Angebote erstellen, lesen (Lexoffice)
• sevDesk Trigger — Polling bei neuen Kontakten, Rechnungen oder Belegen
• Lexoffice Trigger — Webhook mit RSA-SHA512 Signaturpruefung
• Rate-Limiter eingebaut (Lexoffice: max 2 Requests/Sekunde)
• MIT-Lizenz — frei nutzbar, auch kommerziell

Enthaltene Nodes

sevDesk

Node	Funktion
sevDesk	Kontakte, Rechnungen und Belege verwalten (CRUD)
sevDesk Trigger	Workflow starten bei neuen Kontakten, Rechnungen oder Belegen (Polling)

Lexoffice

Node	Funktion
Lexoffice	Kontakte, Rechnungen, Belege und Angebote verwalten (CRUD)
Lexoffice Trigger	Workflow starten bei Lexoffice-Events (Webhook mit RSA-SHA512 Signatur)

Installation

n8n Community Nodes (empfohlen)

1. Gehe zu Settings > Community Nodes
2. Klicke Install a community node
3. Gib ein: n8n-nodes-buchpilot
4. Klicke Install

Manuell

cd ~/.n8n/nodes
npm install n8n-nodes-buchpilot

Docker

Wenn du n8n per Docker betreibst, fuege das Paket in deinem Dockerfile hinzu:

RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-buchpilot

Oder ueber die Umgebungsvariable:

# docker-compose.yml
environment:
  - N8N_COMMUNITY_PACKAGES=n8n-nodes-buchpilot

Konfiguration

sevDesk Credentials einrichten

1. Logge dich in sevDesk ein
2. Gehe zu Einstellungen > Benutzer > API-Token
3. Kopiere den Token
4. In n8n: Gehe zu Credentials > New Credential
5. Waehle sevDesk API
6. Fuege den Token ein und speichere

Lexoffice Credentials einrichten

1. Gehe zu Lexoffice Public API
2. Erstelle einen API-Key (oder nutze einen bestehenden)
3. In n8n: Gehe zu Credentials > New Credential
4. Waehle Lexoffice API
5. Fuege den Key ein und speichere

Nutzung

Beispiel: Neuen Kontakt in sevDesk erstellen

1. Ziehe den sevDesk-Node in deinen Workflow
2. Waehle die Ressource Kontakt und die Operation Create
3. Fuelle die Felder aus:
   • Typ: Person
   • Vorname: Max
   • Nachname: Mustermann
   • E-Mail: max@beispiel.de
4. Fuehre den Node aus

Beispiel: Rechnungen aus Lexoffice auflisten

1. Ziehe den Lexoffice-Node in deinen Workflow
2. Waehle die Ressource Rechnung und die Operation Get Many
3. Optional: Setze den Filter auf Status = open um nur offene Rechnungen zu sehen
4. Fuehre den Node aus

Beispiel: Trigger bei neuer Rechnung

1. Starte einen neuen Workflow mit dem Lexoffice Trigger-Node
2. Waehle das Event Invoice Created
3. Aktiviere den Workflow
4. Sobald eine neue Rechnung in Lexoffice erstellt wird, startet der Workflow automatisch

API/Ressourcen-Referenz

sevDesk

Ressource	Operationen
Kontakte	Create, Get, Get Many, Update, Delete
Rechnungen	Create, Get, Get Many, Update, Delete
Belege	Create, Get, Get Many

Lexoffice

Ressource	Operationen
Kontakte	Create, Get, Get Many, Update
Rechnungen	Create, Get, Get PDF, Update
Belege	Create, Get, Get Many
Angebote	Create, Get

sevDesk Trigger

Event	Beschreibung
Neuer Kontakt	Wird ausgeloest wenn ein neuer Kontakt angelegt wird
Neue Rechnung	Wird ausgeloest wenn eine neue Rechnung erstellt wird
Neuer Beleg	Wird ausgeloest wenn ein neuer Beleg hochgeladen wird

Lexoffice Trigger

Event	Beschreibung
Kontakt erstellt/aktualisiert	Webhook bei Kontakt-Aenderungen
Rechnung erstellt/finalisiert	Webhook bei Rechnungs-Events
Zahlungsstatus geaendert	Webhook bei Zahlungsstatus-Aenderungen

Fertige Workflow-Bundles

Du willst direkt loslegen? Das BuchPilot-Rechnungs-Bundle enthaelt 3 fertige Workflows:

• Kontakt-Sync (sevDesk -> Lexoffice)
• Rechnungs-Buchung (sevDesk -> Lexoffice Beleg)
• Woechentlicher Rechnungs-Report

Bald verfuegbar — Details folgen.

FAQ / Troubleshooting

Die Nodes erscheinen nicht in n8n

• Hast du n8n nach der Installation neu gestartet?
• Bei manueller Installation: Liegt das Paket im richtigen Ordner (~/.n8n/nodes/)?
• Pruefe mit n8n --version, ob du n8n >= 1.0.0 verwendest

Fehler "401 Unauthorized"

• sevDesk: Ist dein API-Token noch gueltig? Tokens koennen ablaufen oder deaktiviert werden.
• Lexoffice: Ist dein API-Key noch aktiv? Gehe zu Lexoffice Public API und pruefe den Status.

Lexoffice Rate-Limit (429 Too Many Requests)

• Lexoffice erlaubt max. 2 Requests pro Sekunde
• Die BuchPilot Nodes haben einen eingebauten Rate-Limiter
• Bei sehr vielen gleichzeitigen Operationen kann es trotzdem zu Verzoegerungen kommen
• Tipp: Verwende den Wait-Node zwischen Batch-Operationen

Rechnungs-PDF kann nicht heruntergeladen werden

• Die Rechnung muss finalisiert sein (Status "open" oder "paid")
• Entwuerfe ("draft") haben noch kein PDF

Lexoffice Trigger funktioniert nicht

• Ist der Workflow auf Active gestellt?
• Ist n8n von aussen erreichbar? (Lexoffice muss den Webhook aufrufen koennen)
• Pruefe ob der Webhook in Lexoffice registriert ist

sevDesk Trigger verpasst Events

• Der sevDesk Trigger arbeitet mit Polling (nicht Webhook)
• Standard-Intervall ist 1 Minute
• Events zwischen zwei Polls werden beim naechsten Poll nachgeholt

Lizenz

MIT — Frei nutzbar, auch kommerziell.

Autor

MaKri — GitHub