Installation

Die BZSt-Node wird als Community Node in Ihre n8n-Instanz installiert.

Voraussetzungen


n8n	Version 2.0 oder neuer
Node.js	20.19 oder neuer (bei Docker bereits enthalten)
Netzwerk	ausgehender Zugriff auf `api.evatr.vies.bzst.de` (HTTPS)

Variante 1: Über die n8n-Oberfläche (empfohlen)

Der Weg für die meisten Installationen — kein Zugriff auf den Server nötig.

In n8n Einstellungen → Community Nodes öffnen.
Install a community node wählen.
Als Paketnamen eintragen:
```
@cotec-it-systeme/n8n-nodes-bzst
```
Die Risikohinweise bestätigen und installieren.
n8n lädt die Node nach. Danach erscheint BZSt API in der Node-Suche.

Variante 2: Docker

Läuft n8n als Container, überlebt eine Installation über die Oberfläche einen Neuaufbau des Containers nur, wenn das n8n-Datenverzeichnis persistent gemountet ist. Prüfen Sie, dass /home/node/.n8n auf ein Volume zeigt:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    volumes:
      - n8n_data:/home/node/.n8n
volumes:
  n8n_data:

Ist das gegeben, funktioniert Variante 1 unverändert — die Installation liegt im Volume.

Alternative: als Extension einbinden

Soll die Node fest zum Image gehören, etwa weil Sie Container ohne persistentes Datenverzeichnis betreiben, installieren Sie das Paket in ein eigenes Verzeichnis und geben es n8n über N8N_CUSTOM_EXTENSIONS mit:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    environment:
      - N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom
    volumes:
      - ./custom:/home/node/.n8n/custom

cd custom
npm install @cotec-it-systeme/n8n-nodes-bzst

Danach den Container neu starten.

Aktualisieren

Über Einstellungen → Community Nodes zeigt n8n verfügbare Updates an und installiert sie auf Klick. Bei der Extension-Variante stattdessen:

cd custom
npm update @cotec-it-systeme/n8n-nodes-bzst

Ein Neustart von n8n ist nötig, damit die neue Fassung geladen wird.

Weiter

Als nächstes die Anmeldedaten anlegen — für die eVatR-Schnittstelle ist das nur Ihre eigene USt-IdNr.