Monatsübersicht

Was passiert

Was passiert

• 1Liest die Belegliste und filtert auf den gewählten Monat (leer = Vormonat).
• 2Schreibt Berichte/Monatsuebersicht_JJJJ-MM.md und .csv.
• 3Optional: Versand per E-Mail an dich selbst (Node standardmäßig deaktiviert, ungetestet).

1. 1

   Eigene n8n-Instanz bereitstellen

   Grundeinrichtung

   Du brauchst eine selbst gehostete n8n-Instanz, Version 2.x (getestet: 2.44.6). Die Community Edition kostet selbst gehostet keine Lizenzgebühr – Server oder Rechner bezahlst du selbst.

   n8n Cloud passt nicht: Die Workflows arbeiten mit Dateien auf dem Rechner, auf dem n8n läuft. Danach http://localhost:5678 öffnen und das lokale Besitzerkonto anlegen.

   Windows / npm (Node.js 24+)

   npm install -g n8n
   $env:N8N_RESTRICT_FILE_ACCESS_TO = "C:\Users\DEINNAME\Papierkram"
   n8n start

   Docker

   docker volume create n8n_data
   docker run -it --rm --name n8n -p 5678:5678 \
     -e GENERIC_TIMEZONE=Europe/Berlin -e TZ=Europe/Berlin \
     -e N8N_RESTRICT_FILE_ACCESS_TO=/home/node/.n8n-files \
     -v n8n_data:/home/node/.n8n \
     -v /PFAD/ZU/Papierkram:/home/node/.n8n-files/Papierkram \
     docker.n8n.io/n8nio/n8n

   Gilt für alle Workflows – einmal erledigt, überall abgehakt.

2. 2

   n8n den Ordnerzugriff erlauben

   Grundeinrichtung

   Seit n8n 2.0 dürfen Datei-Nodes nur in freigegebenen Ordnern lesen und schreiben. Das steuert die Umgebungsvariable N8N_RESTRICT_FILE_ACCESS_TO (mehrere Ordner mit ; trennen, Standard: ~/.n8n-files).

   Ohne Freigabe meldet n8n „Access to the file is not allowed“.

   Gilt für alle Workflows – einmal erledigt, überall abgehakt.

3. 3

   Ordnerstruktur anlegen

   Grundeinrichtung

   n8n legt keine Ordner selbst an. Das Skript erzeugt Eingang, Berichte, Belege/_Pruefen und Belege/JJJJ/01–12 (Vorjahr bis vier Jahre voraus) und kopiert die Vorlage offene-rechnungen.csv.

   Windows

   powershell -ExecutionPolicy Bypass -File .\ordner-anlegen.ps1 -Ziel "C:\Users\DEINNAME\Papierkram"

   Linux / macOS / Docker-Host

   sh vorlagen/ordner-anlegen.sh ~/Papierkram

   Gilt für alle Workflows – einmal erledigt, überall abgehakt.

4. 4

   Workflow importieren

   In n8n einen neuen, leeren Workflow anlegen → oben rechts … → Import from File… → 3_monatsuebersicht.json wählen → Save.

   Alternative per Kommandozeile

   n8n import:workflow --input=workflows/3_monatsuebersicht.json

5. 5

   Basisordner und Monat eintragen

   Node Einstellungen → basisOrdner wie oben. monat leer lassen = Vormonat, oder z. B. 2026-09 eintragen.

6. 6

   Bericht erzeugen

   Test workflow → Bericht liegt in Berichte/Monatsuebersicht_JJJJ-MM.md und .csv.

7. 7

   Aktivieren

   Ungetestet

   Aktiv läuft der Workflow am 1. jedes Monats um 7 Uhr (Zeitzone deiner Instanz, z. B. GENERIC_TIMEZONE=Europe/Berlin).

8. 8

   Bericht per E-Mail (optional)

   OptionalUngetestet

   Node „… per E-Mail (optional)“ öffnen, SMTP-Zugang anlegen, Absender/Empfänger eintragen und den Node aktivieren (Taste D).

Ehrliche Grenzen

Ehrliche Grenzen

• Rechnet nur mit dem, was in der Belegliste steht – Prüffälle stehen separat im Bericht.
• Keine steuerliche Auswertung.