Fehlerbehebung

Die Meldungen sind nach dem sortiert, was Sie in n8n sehen. Wenn Ihre Meldung nicht dabei ist, stammt sie in aller Regel unverändert von der SelectLine-API und beschreibt ein fachliches Problem — fehlende Pflichtfelder, fehlende Rechte oder ein unbekannter Schlüssel.

Die Node erscheint nicht in der Node-Suche

Ursache: Die Installation ist nicht abgeschlossen oder wurde nicht übernommen.

Prüfen Sie:

Steht das Paket unter Einstellungen → Community Nodes in der Liste?
Läuft n8n in der Version 2.0 oder neuer?
Bei Docker: Ist /home/node/.n8n auf ein persistentes Volume gemountet? Ohne Volume ist die Installation nach einem Neuaufbau des Containers weg.
n8n einmal neu starten.

Details unter Installation.

„Kein Lizenzschlüssel hinterlegt“

Vollständig: Kein Lizenzschlüssel hinterlegt. Bitte tragen Sie Ihren SelectLine-Node-Lizenzschlüssel in den Anmeldedaten ein.

Ursache: Das Feld Lizenzschlüssel in den Anmeldedaten ist leer.

Abhilfe: Schlüssel eintragen. Er hat nichts mit Ihrem SelectLine-Zugang zu tun, sondern lizenziert die Node — zu beziehen bei cotec it-systeme GmbH. Siehe Anmeldedaten.

„Lizenzprüfung fehlgeschlagen“

Vollständig: SelectLine-Node: Lizenzprüfung fehlgeschlagen –

Ursache: Der Lizenzserver hat den Schlüssel abgelehnt. Der Grund steht in der Meldung — meist abgelaufen, widerrufen oder unbekannt.

Abhilfe: Wenden Sie sich mit dem genannten Grund an cotec it-systeme GmbH. Nach Ausstellung eines neuen Schlüssels greift dieser innerhalb weniger Minuten; ein Neustart von n8n ist nicht nötig.

„Mandant/Jahr konnte für die Sitzung nicht gesetzt werden“

Ursache: Anmeldung und Kennwort waren korrekt — nur ließ sich die Sitzung nicht auf den gewünschten Mandanten richten. Hinter dem Doppelpunkt steht die Originalmeldung von SelectLine.

Häufige Gründe:

Grund	Abhilfe
Datenbankname falsch geschrieben	über Mandanten → Mandanten abrufen prüfen, Feld `Name`
Anzeigename statt Datenbankname eingetragen	ebenso
Benutzer hat keine Rechte am Mandanten	Rechte in SelectLine prüfen
Jahr existiert nicht oder ist nicht aktiv	Feld Standard-Jahr korrigieren oder leeren

Details unter Mandanten und Sitzungen.

„Authentication failed“

Ursache: Die Anmeldung selbst ist gescheitert.

Prüfen Sie in dieser Reihenfolge:

Basis-URL — vollständig, ohne abschließenden Schrägstrich, mit dem Pfadteil der API (z. B. …/slmobileApi).
Benutzername und Kennwort — versuchsweise direkt in SelectLine anmelden.
App Key — ein falscher App Key lässt die Anmeldung scheitern, auch wenn Benutzer und Kennwort stimmen.
Erreichbarkeit — kann der Rechner, auf dem n8n läuft, die API überhaupt erreichen? Firewall und DNS beachten.

Der Test-Knopf in den Anmeldedaten prüft genau diese vier Punkte.

Zertifikatsfehler / SSL-Fehler

Ursache: Die API verwendet ein Zertifikat, das nicht überprüft werden kann — typisch bei lokalen Installationen mit selbst ausgestelltem Zertifikat.

Abhilfe: In den Anmeldedaten Selbstsignierte Zertifikate zulassen einschalten.

Es kommen nur 10 Datensätze zurück

Kein Fehler. Die SelectLine-API liefert standardmäßig 10 Einträge.

Abhilfe: Unter Listenoptionen das Feld Einträge setzen. 0 bedeutet „alle“ — die Node blättert dann selbstständig durch alle Seiten. Siehe Listen, Filter und Sortierung.

Ein Filter oder ein Feld bleibt wirkungslos

Ursache: Bei der JSON-Eingabe ein abweichend geschriebener Feldname. Die API ignoriert unbekannte Felder stillschweigend — es gibt keinen Fehler, der Wert kommt einfach nicht an.

Abhilfe: Schreibweise genau prüfen; die Feldnamen sind englisch und beginnen groß (Company, nicht company). Das vorbelegte JSON-Gerüst im Feld zeigt die erwarteten Namen. Siehe Eingabe: Felder oder JSON.

Die Ausführung dauert sehr lange

Häufigste Ursache: Einträge = 0 auf einem großen Bestand. Die Node lädt dann tatsächlich alles.

Abhilfe: Vorher eingrenzen — über Suchen nach, den Filter oder die ressourcen-eigenen Felder unter Zusätzliche Felder. Laden Sie nur, was Sie verarbeiten.

Zweite Ursache: Die Node läuft je eingehendem Item einmal. Kommen 1.000 Items an, erfolgen 1.000 Aufrufe. Prüfen Sie, ob eine Listen-Operation dasselbe in einem Aufruf erledigt.

Ein einzelner Datensatz bricht den ganzen Workflow ab

Ursache: Standardmäßig beendet n8n bei einem Fehler die gesamte Ausführung.

Abhilfe: In den Node-Einstellungen (Settings) On Error auf Continue (using error output) setzen. Die übrigen Items laufen weiter, das gescheiterte liefert die Fehlermeldung mitsamt itemIndex. Siehe Fehler und Wiederholungen.

Doppelte Datensätze nach einem Fehler

Ursache: Eine automatische Wiederholung (Retry On Fail) bei einer anlegen-Operation. Kam der erste Versuch beim Server an und nur die Antwort ging verloren, erzeugt die Wiederholung einen zweiten Datensatz.

Abhilfe: Wiederholungen bei anlegenden Operationen abschalten und stattdessen vorher prüfen, ob der Datensatz bereits existiert.

Der SelectLine-Server läuft voll

Ursache: Jede Anmeldung öffnet eine Sitzung, die Arbeitsspeicher belegt und nicht von selbst abläuft.

Prüfen Sie:

Steht das Sitzungs-Timeout auf 0? Dann werden Sitzungen nie automatisch beendet — das ist nur sinnvoll, wenn Sie selbst Konto → Abmelden aufrufen.
Gibt es sehr viele verschiedene Anmeldedaten-Sätze oder Mandanten? Jede Kombination hält eine eigene Sitzung.

Details unter Mandanten und Sitzungen.

Nichts hilft

Halten Sie für die Rückfrage bereit:

die vollständige Fehlermeldung aus der Ausführungsansicht,
Ressource und Operation, bei der sie auftritt,
ob es immer oder nur bei bestimmten Datensätzen passiert,
die n8n-Version und die Version der Node.

Damit lässt sich der Fall meist ohne weitere Nachfrage einordnen.