Skip to main content

n8n Community Node

Die Business OS n8n Community Node stellt die Banking API direkt in n8n als Node zur Verfügung — mit allen AIS und PIS Operationen.

Installation

n8n Self-Hosted

  1. Gehe zu Settings → Community Nodes
  2. Klicke auf Install a community node
  3. Gib ein: n8n-nodes-business-os
  4. Klicke Install

n8n Desktop

cd ~/.n8n
npm install n8n-nodes-business-os
Starte n8n neu.

Credentials einrichten

  1. Gehe zu Credentials → New Credential
  2. Suche nach Business OS API
  3. Gib deinen API Key ein (aus dem Dashboard)
  4. Wähle den API Typ:
    • Partner API — Regulierte Banken (Sparkasse, Volksbank, Deutsche Bank, etc.)
    • Open Banking API — Nicht-regulierte Anbieter (American Express, PayPal, etc.)
  5. Klicke Save

Verfügbare Operationen

Connection (Bankverbindungen)

OperationBeschreibung
List ConnectionsAlle Banking-Verbindungen auflisten
Get ConnectionDetails einer Verbindung abrufen
Delete ConnectionVerbindung löschen

Account (Konten)

OperationBeschreibung
List AccountsAlle Konten auflisten (optional gefiltert nach Connection)
Get AccountEinzelnes Konto abrufen

Transaction (Transaktionen)

OperationBeschreibung
List TransactionsTransaktionen einer Connection abrufen (optional gefiltert nach Account und Zeitraum)

Payment (Zahlungen)

OperationBeschreibung
Create PaymentSEPA-Zahlung initiieren
List PaymentsAlle Zahlungen auflisten
Get PaymentZahlungsdetails und Status abrufen

Webhook

OperationBeschreibung
Get Webhook URLAktuelle Webhook-URL abrufen
Set Webhook URLWebhook-URL setzen

Provider (Banken suchen)

OperationBeschreibung
Search ProvidersBanken nach Name suchen

Beispiel: SEPA-Zahlung initiieren

  1. Füge einen Business OS Node hinzu
  2. Wähle Resource: Payment
  3. Wähle Operation: Create Payment
  4. Fülle die Felder aus:
    • Provider Code: musterbank_oauth_client_de
    • Template: SEPA
    • Empfänger Name: Mustermann GmbH
    • Empfänger IBAN: DE27100777770209299700
    • Absender IBAN: DE89370400440532013000
    • Betrag: 100.00
    • End-to-End ID: RE-2026-001
  5. Führe den Node aus → Du erhältst eine Payment Widget URL
Der User muss die Widget-URL öffnen und die Zahlung per TAN autorisieren.

Beispiel: Kontostände abrufen

  1. Business OS Node → Resource: Account → Operation: List Accounts
  2. Optional: Connection ID setzen für eine bestimmte Bankverbindung
  3. Output enthält: Name, IBAN, Saldo, Währung, Kontoinhaber