n8n-nodes-taxmetall

An n8n community node package that integrates TaxMetall ERP into your workflows. Query customers, articles, orders, invoices, suppliers, delivery notes, offers, dunning records, and execute custom statistics reports — all directly from n8n.

TaxMetall is an ERP system for metal trading and processing companies, developed by Vectotax Software GmbH.

Table of Contents

• Installation
• Credentials
• Nodes
  • TaxMetall
• Compatibility
• Resources
• License

Installation

Follow the n8n community nodes installation guide.

Via the n8n UI:

1. Go to Settings → Community Nodes
2. Click Install a community node
3. Enter @vectotaxsoftwaregmbh/n8n-nodes-taxmetall
4. Click Install

Via CLI:

npm install @vectotaxsoftwaregmbh/n8n-nodes-taxmetall

Credentials

Create a TaxMetall API credential in n8n (Settings → Credentials → New).

| Field | Description | Example | |---|---|---| | Base URL | URL of your TaxMetall API service | https://api.example.com:8443 | | API Key | The tax-api-key configured in your TaxMetall API service | your-secret-api-key | | Use ngrok Tunnel | Enable if your TaxMetall instance is accessed via an ngrok tunnel (default: off) | — | | Allow Self-Signed Certificates | Disable TLS certificate validation — enable only for on-premises installations using self-signed certificates (default: off) | — |

The API key is sent as the tax-api-key HTTP header with every request.

ngrok users: If your TaxMetall API service is exposed via ngrok and you do not have a custom domain, enable the Use ngrok Tunnel toggle in the credentials. This adds the ngrok-skip-browser-warning header to all requests, which is required to bypass the ngrok interstitial page.

Self-signed certificates: If your TaxMetall API service runs on-premises with a self-signed TLS certificate, enable Allow Self-Signed Certificates. Leave this off in all other cases — disabling certificate validation on untrusted networks exposes your API key to interception.

Nodes

TaxMetall

General-purpose ERP node for querying and creating records across all TaxMetall domains.

Resources and Operations

Article (Artikel)

| Operation | Description | Required Parameters | |---|---|---| | Search by article ID | Retrieve an article by its internal ID | Article ID | | Search by article number | Find an article by its exact number | Article number | | Search by name | Search articles by partial name match | Name | | Search by drawing number | Find articles by drawing/part number | Drawing number |

Customer (Kunde)

| Operation | Description | Required Parameters | |---|---|---| | Search by ID | Retrieve a customer by their customer number | Customer number | | Search by name | Find customers by partial name match | Name | | Search by order ID | Find the customer associated with an order | Order number |

Order (Auftrag)

| Operation | Description | Required Parameters | |---|---|---| | Get order status | Retrieve a full order including line items | Order number | | Search by date range | List all orders within a date range | Date from, Date to |

Offer (Angebot)

| Operation | Description | Required Parameters | |---|---|---| | Create | Create a new offer | Customer ID, Article ID | | Search by offer number | Retrieve an offer including line items | Offer number | | Search by customer | List all offers for a customer | Customer number | | Search by date range | List all offers within a date range | Date from, Date to |

Invoice (Rechnung)

| Operation | Description | Required Parameters | |---|---|---| | Search by invoice number | Retrieve an invoice including line items | Invoice number | | Search by customer | List all invoices for a customer | Customer number | | Search by date range | List all invoices within a date range | Date from, Date to |

Purchase Invoice (Eingangsrechnung)

| Operation | Description | Required Parameters | |---|---|---| | Search by ER number | Retrieve a purchase invoice including line items | ER number (+ optional supplier number) | | Search by supplier | List all purchase invoices for a supplier | Supplier number | | Search by date range | List all purchase invoices within a date range | Date from, Date to |

Delivery Note (Lieferschein)

| Operation | Description | Required Parameters | |---|---|---| | Search by delivery note number | Retrieve a delivery note including line items | Delivery note number | | Search by customer | List all delivery notes for a customer | Customer number | | Search by date range | List all delivery notes within a date range | Date from, Date to |

Supplier (Lieferant)

| Operation | Description | Required Parameters | |---|---|---| | Search by ID | Retrieve a supplier by their supplier number | Supplier number | | Search by name | Find suppliers by partial name match | Name | | Search by article | Find all suppliers linked to an article | Article number |

DMS

Uploads a file to the TaxDMS document management system (Vectotax Software GmbH). The file is transferred as a Base64-encoded payload together with structured metadata.

| Operation | Description | Required Parameters | |---|---|---| | Create File | Upload a binary file with metadata to TaxDMS | Data (JSON), File (Binary) |

Fields

| Field | Description | |---|---| | Data (JSON) | Metadata object passed to the DMS endpoint (structure defined by your TaxDMS configuration) | | File (Binary) | Name of the n8n binary property that holds the file to upload (e.g. data) |

Dunning (Mahnung)

| Operation | Description | Required Parameters | |---|---|---| | Search by customer | List all open dunning items for a customer | Customer number | | Search by due date range | List all open dunning items by due date | Date from, Date to |

Note: Dunning records are not independent documents in TaxMetall. They are a filtered view of the invoice table (open balance > 0, not a credit note, no dunning block).

Acquisition (Akquise)

| Operation | Description | Required Parameters | |---|---|---| | Create | Create a new acquisition/lead entry | Company name, email address | | Search by ID | Retrieve an acquisition entry by internal ID | Acquisition ID | | Search by name | Find acquisition entries by company or contact name | Name | | Search by date range | List acquisition entries by first contact date | Date from, Date to |

Statistic

Executes pre-configured SQL reports stored in TaxMetall and returns the results as a JSON array. This allows every custom report and Business Cockpit report defined in your TaxMetall installation to be used directly inside n8n workflows.

The node dynamically loads all available reports for the authenticated tenant and presents them in a dropdown. Each option shows the report name and the parameters it requires.

| Operation | Description | |---|---| | Execute | Run a report and return the results as a JSON array |

Fields

| Field | Type | Description | |---|---|---| | Statistic / Report | Dropdown | Select the report to execute — the description lists expected parameters | | Date From | Date | Start of the reporting period (SQL parameter: DatumVon) | | Date To | Date | End of the reporting period (SQL parameter: DatumBis) | | Comparison From | Date | Start of an optional comparison period (SQL parameter: VergleichVon) | | Comparison To | Date | End of an optional comparison period (SQL parameter: VergleichBis) | | Additional Parameters | Collection | Optional filter parameters depending on the report |

Additional parameters

| Field | SQL Name | Description | |---|---|---| | Article No. | Artikel | Filter by article number | | Article Group | ArtikelGruppe | Filter by article group | | Order No. | Auftrag | Filter by order number | | Order Type | AuftragsArt | Filter by order type code | | Business Area | GeschBereich | Filter by business area | | Customer No. | Kunden | Filter by customer number | | Warehouse | Lagerort | Filter by warehouse code | | Supplier No. | Lieferanten | Filter by supplier number | | Employee | Mitarbeiter | Filter by employee code | | Project No. | Projekt | Filter by project ID | | Purchase Order No. | Bestellung | Filter by purchase order number | | Value Range From | WertebereichVon | Numeric start value for range filters | | Value Range To | WertebereichBis | Numeric end value for range filters | | Variable 1 | Variable1 | Free text value |

Supported report types

| Type | Available | Description | |---|---|---| | Individual (Individuell) | Yes | Custom SQL reports defined by the tenant | | Business Cockpit (BC) | Yes | Reports from the Business Cockpit module | | Static (Statisch) | No | Hardcoded system reports — SQL is not stored in the database |

Compatibility

| Requirement | Version | |---|---| | n8n | >= 1.0.0 | | Node.js | >= 18 | | n8n Nodes API | 1 |

Resources

• Vectotax Software GmbH
• n8n community nodes documentation
• npm package
• Report an issue

License

MIT