n8n

Workflows mit vynst-Daten, Trigger auf Änderungen und Buchungszeiten, Schlösser aus n8n und fertige Vorlagen mit n8n-nodes-inwendo-erp.

Das Community-Paket n8n-nodes-inwendo-erp bringt drei Nodes nach n8n: inwendo ERP (Daten lesen und schreiben), inwendo ERP Trigger (Workflows starten) und inwendo ERP Lock Trigger (eigene Schlösser). Damit verbindet ihr vynst (inwendo ERP) mit über tausend anderen Diensten, etwa Slack, Teams, E-Mail, Google Sheets oder KI-Agenten.

Installation

In n8n Einstellungen → Community Nodes → Installieren, n8n-nodes-inwendo-erp eingeben und bestätigen. Selbst gehostet ohne Oberfläche:

cd ~/.n8n/nodes
npm install n8n-nodes-inwendo-erp

Nötig ist n8n 1.85 oder neuer, auch 2.x.

Zugangsdaten

Legt in n8n Zugangsdaten vom Typ inwendo ERP API an:

• ERP Host URL: https://eure-instanz.iw-erp.de
• API Token (JWT): ein langlebiger Token aus Einstellungen → API-Zugänge

n8n prüft den Token beim Speichern mit GET /api/base/api_access_token_test?mode=info. Jede Anfrage trägt X-IW-Trigger-Source: n8n, damit Änderungen eines Workflows nicht wieder dessen eigenen Trigger auslösen.

Daten lesen und schreiben

Der Node inwendo ERP kennt 23 Bereiche, darunter Firma, Person, Projekt, Ticket (mit SLA-Status), Zeiteintrag, Rechnung und Angebot (mit PDF), Buchung, Veranstaltung, Anmeldung, Ausleihe, Schicht, Ehrenamtsstunden und Helferdienste, Mitgliedschaftspausen, Mitgliederversammlung, Belegung, Zähler, Benachrichtigung (Push in die vynst App, E-Mail, SMS), Schloss, Webhook und freie API-Aufrufe.

• Get Many liest auf Wunsch alle Seiten.
• Update nutzt PATCH: Felder, die ihr nicht setzt, bleiben.
• Der Node ist als Werkzeug für KI-Agenten in n8n nutzbar.

Workflows starten

Der inwendo ERP Trigger startet bei Anlegen, Ändern oder Löschen einer Firma, Person, Buchung, Rechnung, Ticket, Ausleihe, Schicht, Ehrenamtsstunde und vielem mehr. Beim Aktivieren meldet er sich selbst bei vynst an (POST /api/n8n/webhook) und beim Deaktivieren wieder ab. Eingehende Aufrufe prüft er am Header X-IW-Webhook-Token.

Ein Ereignis sieht so aus:

{
  "iw_entity_class": "Inwendo\\CRMBundle\\Entity\\CRMCompany",
  "iw_entity_short_class": "CRMCompany",
  "iw_entity_id": "123",
  "iw_action": "update",
  "iw_dt": 1709500000,
  "data": { }
}

Buchungszeiten: Mit integration_booking_timed_events_enabled startet der Trigger auch vor einer Buchung, zu Beginn, zum Ende und nach dem Ende. So erinnert ihr Hausmeister oder schaltet Technik.

Türöffnungen und Check-ins: Mit integration_ha_access_events_enabled bringen Schloss-Protokoll und Check-ins eine Zusammenfassung mit:

{ "type": "access", "smart_lock_name": "Haupteingang", "action": "unlock",
  "success": true, "person_name": "Max Mustermann", "source": "app" }

Eigene Schlösser aus n8n

1. inwendo ERP Lock Trigger anlegen, Schlösser eintragen (Lock ID, Name in vynst, Öffnen-Knopf oder QR-Code in der App) und den Workflow aktivieren. Der Trigger meldet die Schlösser bei /api/n8n/smart_lock/register an.
2. In vynst die Smartlock-Verbindung vom Anbieter n8n öffnen, Geräte synchronisieren und Rechte vergeben.
3. Tippt jemand mit Recht auf Öffnen, bekommt der Workflow command (open oder lock), lock_id und lock_name und schaltet Relais oder Shelly.

Befehle sind mit HMAC-SHA256 signiert (X-IW-Signature) und werden nach 60 Sekunden oder bei Wiederholung abgelehnt. n8n muss per https öffentlich erreichbar sein.

Vorlagen

Zum Importieren unter Workflows → Import from File:

Funktionen hinter Schaltern

Ist eine Funktion in vynst aus, meldet der Node this function is switched off (ERP setting "<einstellung>"). Die wichtigsten Schalter:

API

Die Endpunkte unter /api/n8n/ stehen im Bereich Smart Home und Automationen. Quellcode und Vorlagen: github.com/inwendo/n8n-nodes-inwendo-erp.