n8n mit easycompliance verbinden

n8n ist eine Workflow-Automatisierung, die – selbst gehostet oder als n8n Cloud – hunderte Systeme per Drag-and-drop verbindet. easycompliance lässt sich darin ohne eigenen Programmcode auf zwei grundverschiedenen Wegen einbinden: Die REST-API übernimmt Einzelprüfungen und die Pflege Ihrer Monitoring-Liste in Echtzeit direkt aus dem Workflow – sie setzt einen API-Zugang voraus. Der automatische CSV-Import hält komplette Bestandslisten aktuell und kommt ganz ohne API-Anbindung aus. Ein spezieller n8n-Endpunkt ist nicht erforderlich – für die API gelten dieselbe URL und derselbe API-Key, die Sie vom Kundenservice erhalten.

Was Sie mit n8n automatisieren können

• Einzelprüfung im Prozess: Neue Kunden, Lieferanten oder Bewerber direkt bei der Anlage im CRM/ERP gegen Sanktions- und PEP-Listen prüfen (method=1).
• Monitoring pflegen: Geschäftspartner automatisch in die tägliche Listenprüfung aufnehmen (method=2) oder daraus entfernen (method=5) – Ihre Prüfliste bleibt ohne manuelle Pflege synchron zum Quellsystem.
• Treffer weiterverarbeiten: Die Treffer der letzten 24 Stunden abrufen (method=3) und z. B. an Ticketsystem, Slack oder E-Mail-Verteiler übergeben.
• CSV-Import automatisieren: Aus dem Quellsystem exportierte Bestandslisten per FTPS an easycompliance übertragen.

Welcher Weg passt zu Ihnen: CSV-Import oder API?

Die beiden Wege unterscheiden sich grundlegend – technisch wie preislich. Der CSV-Import per FTPS (Weg 2) benötigt keine API-Anbindung an easycompliance und verursacht damit auch keine API-Kosten: Sie übertragen Ihre Bestandsliste, der Import in das tägliche Monitoring läuft jede Nacht automatisch, Treffer meldet easycompliance per E-Mail. Die REST-API (Weg 1) setzt dagegen einen API-Zugang voraus, der als kostenpflichtiger Zusatz zum Tarif gebucht wird – dafür erhält Ihr Workflow das Prüfergebnis in Echtzeit zurück und kann es direkt weiterverarbeiten.

Kurz: Wer nur einen einfachen und kostengünstigen Weg sucht, seine Daten in das easycompliance-Monitoring zu importieren, fährt mit dem CSV-Import (Weg 2) gut. Wer die Sanktionslistenprüfung bidirektional im eigenen System abbilden oder z. B. bei der Neukundenanlage in Echtzeit prüfen will, setzt auf die REST-API (Weg 1).

Voraussetzungen

Für beide Wege benötigen Sie ein easycompliance-Konto (Tarife im Überblick, kostenfrei testen) sowie eine n8n-Installation (self-hosted) oder einen n8n-Cloud-Account. Nur für Weg 1 (REST-API) braucht es zusätzlich den kostenpflichtigen API-Zugang; die API-URL samt API-Key erhalten Sie vom Kundenservice. Für Weg 2 (CSV-Import) richtet der Kundenservice stattdessen Ihren FTPS-Zugang und die Autoimport-Konfiguration ein – ein API-Zugang ist dafür nicht nötig.

Weg 1: Prüfungen über die REST-API (HTTP-Request-Node)

Alle Funktionen der API-Dokumentation stehen in n8n über den Standard-Node HTTP Request zur Verfügung. Für Sanktionslisten- und PEP-Prüfung gibt es zwei getrennte API-Instanzen – legen Sie je Prüfung einen eigenen HTTP-Request-Node an.

Schritt 1: Request konfigurieren

Im HTTP-Request-Node wählen Sie Method: POST und tragen als URL die API-URL ein, die Ihnen der Kundenservice mitgeteilt hat. Aktivieren Sie Send Body und übergeben Sie die Parameter aus der Parameter-Übersicht wahlweise als Form Urlencoded oder als JSON – die API akzeptiert beide Body-Formate. Ein JSON-Body für eine Einzelprüfung sieht so aus:

{
    "api_key": "IHR-API-KEY",
    "method": 1,
    "accuracy": 90,
    "name": "NAME FÜR PRÜFUNG",
    "ref": "12345"
}

Schritt 2: API-Key als Credential hinterlegen

Speichern Sie den API-Key nicht als Klartext im Workflow (Workflows werden häufig exportiert oder geteilt), sondern als n8n-Credential. Zwei Varianten funktionieren mit easycompliance:

• Custom Auth (empfohlen): Credential-Typ Custom Auth anlegen und den Key als Body-Feld injizieren lassen – n8n ergänzt ihn dann bei jedem Request automatisch:

  {
      "body": {
          "api_key": "IHR-API-KEY"
      }
  }

• Header Auth: Credential-Typ Header Auth mit Name X-API-Key und Ihrem API-Key als Wert. Die API akzeptiert den Header als Alternative zum Body-Parameter api_key; ein im Body übermittelter Key hat Vorrang.

Schritt 3: Antworten auswerten

Die API antwortet mit JSON (bei method=1, 2 oder 3) bzw. plain text (method=4) und immer mit einem HTTP-Statuscode:

Setzen Sie im Node ein Timeout (Options → Timeout, z. B. 10 Sekunden), damit Ihr Workflow bei Netzwerkproblemen kontrolliert in den Fehlerpfad läuft, statt zu warten.

Monitoring-Liste per Workflow synchron halten

Mit method=2 wird der übergebene Name zusätzlich in Ihre tägliche Listenprüfung (Monitoring) aufgenommen, mit method=5 daraus entfernt – die Duplikaterkennung steuert der Parameter duplicate_by (name oder ref). Ein n8n-Workflow, der bei Neuanlage und Löschung im Quellsystem diese beiden Aufrufe ausführt, hält Ihre Prüfliste vollautomatisch aktuell. Das ist zugleich der empfohlene Weg für n8n Cloud, wo der FTPS-Upload aus Weg 2 nicht direkt möglich ist.

Weg 2: Automatischer CSV-Import per FTPS – ohne API-Zugang

Beim automatischen Datenimport laden Sie Ihre Bestandsliste als CSV-Datei auf unseren FTPS-Server; der Import läuft jede Nacht automatisch. Eine API-Anbindung ist dafür nicht erforderlich – der Weg steht damit auch ohne den kostenpflichtigen API-Zugang offen. Die Einrichtung (Zugangsdaten, Dateiname, Spaltenzuordnung) übernimmt der Kundenservice; den Aufbau der CSV-Datei beschreibt das Handbuch. Die Eckdaten:

Wichtig: FTPS im n8n-FTP-Node

Der eingebaute FTP-Node von n8n unterstützt nur FTP und SFTP – kein FTPS (Stand Juli 2026). Für den Upload zu easycompliance gibt es deshalb drei praxistaugliche Wege:

• n8n self-hosted – Execute-Command-Node mit curl: curl beherrscht explizites FTPS; --ssl-reqd erzwingt die TLS-Verschlüsselung:

  curl -T "/daten/Kundenliste.csv" --ssl-reqd \
       --user "kunde16000:IHR-FTPS-PASSWORT" \
       ftp://ftps.easycompliance.de/

  Ersetzen Sie Pfad, Benutzername (kunde<Kundennummer>) und Passwort durch Ihre Zugangsdaten. Schlägt die Zertifikatsprüfung in Ihrer Umgebung fehl, können Sie – wie beim WinSCP-Kit aus dem Handbuch – dem Serverzertifikat automatisch vertrauen (curl-Option --insecure): Die Übertragung bleibt TLS-verschlüsselt, verzichtet dann aber auf die Prüfung des Zertifikats.
• n8n Cloud: Dort steht der Execute-Command-Node nicht zur Verfügung. Pflegen Sie die Monitoring-Liste stattdessen über die REST-API (Weg 1, method=2/5) – fachlich das gleiche Ergebnis wie der CSV-Import.
• Upload außerhalb von n8n: Der zeitgesteuerte Upload mit dem vorkonfigurierten WinSCP-Kit läuft unabhängig von n8n – sinnvoll, wenn n8n nur die Datei-Erzeugung im Quellsystem anstößt.

Eigener easycompliance-Node für n8n

Der Community-Node n8n-nodes-easycompliance bündelt Einzelprüfung, Monitoring-Pflege und Datenstand-Abfrage für Sanktionslisten und PEP als vorkonfigurierte Operationen – ohne manuelle Request-Konfiguration. Selbst gehostete n8n-Installationen installieren ihn über Settings → Community Nodes mit dem Paketnamen n8n-nodes-easycompliance (veröffentlicht auf npm); der Quellcode ist auf GitHub einsehbar. Für n8n Cloud ist die Freischaltung als verifizierter Community-Node bei n8n beantragt und wartet derzeit auf Bestätigung – dort deckt bis dahin der HTTP-Request-Node (Weg 1) den vollen Funktionsumfang ab. Auch der Node nutzt die REST-API und benötigt deshalb den API-Zugang samt API-Key – Fragen dazu beantwortet der Kundenservice direkt im Chat.

Häufige Fragen zur n8n-Anbindung