Package Information
Downloads: 6 weekly / 28 monthly
Latest Version: 0.1.2
Author: MaKri
Available Nodes
Documentation
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)
- Gehe zu Settings > Community Nodes
- Klicke Install a community node
- Gib ein:
n8n-nodes-buchpilot - 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
- Logge dich in sevDesk ein
- Gehe zu Einstellungen > Benutzer > API-Token
- Kopiere den Token
- In n8n: Gehe zu Credentials > New Credential
- Waehle sevDesk API
- Fuege den Token ein und speichere
Lexoffice Credentials einrichten
- Gehe zu Lexoffice Public API
- Erstelle einen API-Key (oder nutze einen bestehenden)
- In n8n: Gehe zu Credentials > New Credential
- Waehle Lexoffice API
- Fuege den Key ein und speichere
Nutzung
Beispiel: Neuen Kontakt in sevDesk erstellen
- Ziehe den sevDesk-Node in deinen Workflow
- Waehle die Ressource Kontakt und die Operation Create
- Fuelle die Felder aus:
- Typ: Person
- Vorname: Max
- Nachname: Mustermann
- E-Mail: max@beispiel.de
- Fuehre den Node aus
Beispiel: Rechnungen aus Lexoffice auflisten
- Ziehe den Lexoffice-Node in deinen Workflow
- Waehle die Ressource Rechnung und die Operation Get Many
- Optional: Setze den Filter auf Status = open um nur offene Rechnungen zu sehen
- Fuehre den Node aus
Beispiel: Trigger bei neuer Rechnung
- Starte einen neuen Workflow mit dem Lexoffice Trigger-Node
- Waehle das Event Invoice Created
- Aktiviere den Workflow
- 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