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:

1. Steht das Paket unter Einstellungen → Community Nodes in der Liste?
2. Läuft n8n in der Version 2.0 oder neuer?
3. Bei Docker: Ist /home/node/.n8n auf ein persistentes Volume gemountet? Ohne Volume ist die Installation nach einem Neuaufbau des Containers weg.
4. 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.

Der Verbindungstest prüft die Lizenz nicht

Der Test-Knopf der Anmeldedaten prüft die Lizenz nicht. Ein grüner Test bei gleichzeitigem Lizenzfehler ist deshalb kein Widerspruch.

„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.

Ausfall des Lizenzservers hält den Workflow nicht an

Ist lediglich der Lizenzserver nicht erreichbar, läuft der Workflow trotzdem weiter — es erscheint nur eine Warnung im Ausführungsprotokoll. Ein Netzwerkausfall legt Ihre Abläufe also nicht still.

„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:

1. Basis-URL — vollständig, ohne abschließenden Schrägstrich, mit dem Pfadteil der API (z. B. …/slmobileApi).
2. Benutzername und Kennwort — versuchsweise direkt in SelectLine anmelden.
3. App Key — ein falscher App Key lässt die Anmeldung scheitern, auch wenn Benutzer und Kennwort stimmen.
4. 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.

Nur in kontrollierten Netzen vertretbar

Damit entfällt der Schutz gegen manipulierte Verbindungen. Nutzen Sie die Option nur in Netzen, denen Sie vertrauen — im Zweifel besser ein gültiges Zertifikat einrichten.

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.

Zweite Ursache: Bei einigen Ressourcen wertet die SelectLine-API die Listenoption gar nicht aus — der Suchbegriff oder Filter wird angenommen, das Ergebnis bleibt unverändert. Betroffen sind unter anderem Lager, Inventur, Produktion, Seriennummern und Mandanten.

Prüfen Sie: dieselbe Abfrage einmal mit und einmal ohne den Parameter ausführen. Kommt beides Mal dieselbe Anzahl Datensätze zurück, liegt es an der API.

Die geprüfte Liste der betroffenen Endpunkte samt Umgehungen steht unter Bekannte Einschränkungen der SelectLine-API. Diese Punkte kann nur SelectLine beheben; die Node hat keinen anderen Weg, die Parameter zu übermitteln. Melden Sie den Fall trotzdem bei uns — wir grenzen ihn ein und geben ihn, wenn er sich bestätigt, an SelectLine weiter.

„To access this route you have to select an active year first” (HTTP 424)

Ursache: Der Zugriff auf die Buchhaltung (/Accounting/…) setzt ein aktives Geschäftsjahr in der Sitzung voraus. Ohne Jahr weist die API jede dieser Abfragen ab.

Abhilfe: In den Anmeldedaten Standard-Jahr (Datenbankname) füllen. Den Namen liefert Mandanten → Get Many. Siehe Mandanten und Sitzungen.

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.