Package Information
Documentation
n8n-nodes-taxmetall
n8n Community Node für die TaxMetall ERP Integration von Vectotax Software GmbH.
Ermöglicht die Anbindung von TaxMetall ERP an n8n-Workflows: Artikel, Kunden, Angebote und Akquise direkt aus n8n heraus abfragen und erstellen — sowie gespeicherte Statistiken und Auswertungen dynamisch abrufen und in Workflows weiterverarbeiten.
Installation
In deiner n8n-Instanz:
- Gehe zu Settings > Community Nodes
- Klicke auf Install a community node
- Trage ein:
@vectotaxsoftwaregmbh/n8n-nodes-taxmetall - Klicke auf Install
Oder per CLI:
npm install @vectotaxsoftwaregmbh/n8n-nodes-taxmetall
Credentials
Du benötigst:
- API Key — Der TaxMetall API-Key (wird im TaxMetall-API-Dienst pro Mandant vergeben)
- Basis URL — Die URL deines TaxMetall-API-Dienstes (z.B.
https://meine-domain:8443)
Verfügbare Nodes
Node 1: TaxMetall
Allgemeine ERP-Operationen für Stammdaten und Vorgänge.
Ressourcen & Operationen
Artikel
| Operation | Beschreibung |
|---|---|
| Nach Artikel-ID suchen | Artikel anhand der internen ID abrufen |
| Nach Artikelnummer suchen | Artikel anhand der Artikelnummer finden |
| Nach Bezeichnung suchen | Artikel anhand des Namens suchen |
| Nach Zeichnungsnummer suchen | Artikel anhand der Zeichnungsnummer finden |
Kunde
| Operation | Beschreibung |
|---|---|
| Nach Name suchen | Kunde anhand des Namens finden |
| Nach ID suchen | Kunde anhand der ID abrufen |
| Nach OrderID suchen | Kunde anhand einer Bestell-ID finden |
Angebot
| Operation | Beschreibung |
|---|---|
| Erstellen | Neues Angebot mit Kunden-ID, Artikel-ID und Menge anlegen |
Akquise
| Operation | Beschreibung |
|---|---|
| Erstellen | Neuen Akquise-Eintrag mit Firma, E-Mail und optionalen Feldern anlegen |
Node 2: TaxMetall: Statistik ausführen
Führt eine gespeicherte Statistik- oder Auswertungsabfrage aus und gibt die Ergebnisse als JSON zurück. Damit lassen sich alle in TaxMetall angelegten individuellen Auswertungen und Business-Cockpit-Auswertungen direkt in n8n-Workflows nutzen.
Funktionsweise
Das Node lädt beim Öffnen automatisch alle für den Mandanten verfügbaren Auswertungen aus der Datenbank und zeigt sie in einem Dropdown-Menü an. Neben dem Namen jeder Auswertung steht direkt, welche Parameter sie erwartet.
Felder
| Feld | Typ | Beschreibung |
|---|---|---|
| Statistik / Auswertung | Dropdown | Wählt die auszuführende Auswertung. Die Beschreibung der Option zeigt welche Parameter benötigt werden. |
| Datum Von | Datum | Startdatum des Auswertungszeitraums (SQL-Parameter: DatumVon) |
| Datum Bis | Datum | Enddatum des Auswertungszeitraums (SQL-Parameter: DatumBis) |
| Weitere Parameter | Collection | Optionale Filterparameter je nach Auswertung (siehe unten) |
Verfügbare weitere Parameter
| Parameter | SQL-Name | Beschreibung |
|---|---|---|
| Artikel-Nr | Artikel |
Artikelnummer |
| Auftragsart | AuftragsArt |
Auftragsart-Kürzel |
| Geschäftsbereich | GeschBereich |
Geschäftsbereich |
| Kunden-Nr | Kunden |
Kundennummer |
| Lagerort | Lagerort |
Lagerort-Kürzel |
| Lieferanten-Nr | Lieferanten |
Lieferantennummer |
| Mitarbeiter | Mitarbeiter |
Mitarbeiterkürzel |
| Projekt | Projekt |
Projekt-ID |
| Wertebereich Bis | WertebereichBis |
Numerischer Endwert für Bereichsfilter |
| Wertebereich Von | WertebereichVon |
Numerischer Startwert für Bereichsfilter |
Beispiel-Workflow
[Trigger]
↓
[TaxMetall: Statistik ausführen]
Statistik: "Umsatzliste nach Kunden" ← aus Dropdown gewählt
Datum Von: 2024-01-01
Datum Bis: 2024-12-31
Weitere Parameter:
Kunden-Nr: 1001
↓
[Ergebnis: JSON-Array mit allen Treffern]
↓
[Weiterverarbeitung, z.B. E-Mail / Google Sheets / HTTP Request]
Rückgabe
{
"success": true,
"statisticId": "SQLButton3",
"statisticName": "Umsatzliste nach Kunden",
"rowCount": 42,
"data": [
{ "KundenNr": "1001", "Umsatz": 15000.00, "..." : "..." },
"..."
]
}
Hinweis zu Auswertungstypen
Das Node unterstützt zwei in TaxMetall gespeicherte Auswertungstypen:
- Individuelle Auswertungen — vom Mandanten selbst definierte SQL-Abfragen (Tab "Individuell" in TaxMetall)
- Business-Cockpit-Auswertungen — Auswertungen aus dem BC-Modul (Tab "BC" in TaxMetall)
Hardcodierte Systemauswertungen (Typ "Statisch") sind nicht verfügbar, da ihr SQL-Code nicht in der Datenbank gespeichert ist.
Kompatibilität
- n8n Version: >= 1.0.0
- Node.js Version: >= 18