cashmich

CashMich integration for n8n — triggers, actions, and search for debt collection automation

Package Information

Released: this month
Downloads: 9 weekly / 24 monthly
Latest Version: 1.0.2
Author: CashMich

Available Nodes

Documentation generating…

CashMich icon
CashMich
Forderungen erstellen, aktualisieren und suchen in CashMich
CashMich Trigger icon
CashMich Trigger
Startet den Workflow wenn ein CashMich-Event eintritt

Documentation

n8n-nodes-cashmich

CashMich Community Node für n8n — Forderungsmanagement automatisieren.

Funktionen

Trigger (Webhook)

Startet einen Workflow automatisch wenn in CashMich etwas passiert:

Event Beschreibung
Neue Forderung Forderung wurde erstellt
Forderung genehmigt Forderung wurde genehmigt und Zahlungsaufforderung versendet
Zahlung eingegangen Schuldner hat bezahlt
Auszahlung an Gläubiger Betrag wurde an den Gläubiger überwiesen
Status geändert (alle) Jeder Statuswechsel (genehmigt, abgelehnt, bezahlt, überwiesen, überfällig)

Webhooks werden automatisch erstellt und gelöscht wenn der Workflow aktiviert/deaktiviert wird. Alle Webhook-Nachrichten werden mit HMAC-SHA256 verifiziert.

Actions

Action Beschreibung
Create Neue Forderung erstellen
Update Bestehende Forderung aktualisieren
Find Forderung suchen (nach ID oder Suchbegriff)
Bulk Create Mehrere Forderungen auf einmal importieren (JSON)

Felder

Die Daten werden automatisch in ein flaches Format gebracht — kein verschachteltes Mapping nötig:

id, claimNumber, status, amount, currency, creditorName, creditorIban, creditorEmail, debtorName, debtorEmail, debtorAddress, debtorPhone, invoiceNumber, invoiceDate, dueDate, submittedAt, updatedAt

Installation

Über die n8n UI (empfohlen)

  1. In n8n: Settings → Community Nodes
  2. Install a community node klicken
  3. n8n-nodes-cashmich eingeben und installieren

Über die Kommandozeile

cd ~/.n8n/nodes
npm install n8n-nodes-cashmich

Danach n8n neu starten.

Einrichtung

1. API Key erstellen

  1. In CashMich einloggen: cashmich.com
  2. Einstellungen → API Keys öffnen
  3. Neuen API Key erstellen mit diesen Berechtigungen:
    • claims:read — Forderungen lesen (Pflicht)
    • webhooks:manage — Webhooks verwalten (Pflicht für Trigger)
    • claims:create — Forderungen erstellen (wenn Create/Bulk Create verwendet wird)
    • claims:update — Forderungen aktualisieren (wenn Update verwendet wird)
  4. API Key kopieren (wird nur einmal angezeigt!)

2. Credential in n8n anlegen

  1. In n8n: Credentials → New Credential
  2. CashMich API auswählen
  3. API Key einfügen
  4. Test klicken — bei Erfolg erscheint "Connection tested successfully"

3. Workflow erstellen

Beispiel: Neue Forderung → Slack-Nachricht

  1. CashMich Trigger als Start-Node hinzufügen
  2. Event: "Neue Forderung" auswählen
  3. Slack Node (oder Email, Google Sheets, etc.) anhängen
  4. Felder mappen: {{ $json.claimNumber }}, {{ $json.debtorName }}, {{ $json.amount }}
  5. Workflow aktivieren — fertig!

Workflow-Ideen

  • Neue Forderung → Slack/Teams — Team sofort benachrichtigen
  • Zahlung eingegangen → Google Sheet — Zahlungen automatisch tracken
  • Rechnung aus Buchhaltung → Forderung erstellen — ERP-Integration
  • Status geändert → E-Mail an Gläubiger — Kunden automatisch informieren
  • Bulk Import aus CSV → Forderungen erstellen — Monatliche Batch-Imports

Benötigte API-Berechtigungen

Funktion Berechtigungen
Trigger (Webhooks) claims:read, webhooks:manage
Create / Bulk Create claims:read, claims:create
Update claims:read, claims:update
Find claims:read
Alles zusammen claims:read, claims:create, claims:update, webhooks:manage

Sicherheit

  • HMAC-SHA256: Jede Webhook-Nachricht wird mit einem Secret signiert. Der Node verifiziert die Signatur automatisch — manipulierte Nachrichten werden abgelehnt.
  • Bearer Token: API-Kommunikation über HTTPS mit Bearer Token Authentication.
  • Timing-Safe Comparison: Signaturvergleich verwendet timingSafeEqual gegen Timing-Attacken.

Support

Lizenz

MIT

Discussion