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: [email protected]
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