Anmeldedaten

Die Anmeldedaten (Credentials) der SelectLine-Node bündeln drei Dinge: die Lizenz der Node, den Zugang zur slmobileApi und den Arbeitskontext (Mandant, Jahr, Sitzungsdauer). Sie werden in n8n einmal angelegt und von allen Nodes im Workflow gemeinsam genutzt.

Note

Die Anmeldedaten bestimmen nicht nur, wer sich anmeldet, sondern auch in welchem Mandanten gearbeitet wird und wie lange eine Sitzung auf dem SelectLine-Server offen bleibt. Beides hat spürbare Auswirkungen auf dem Server — siehe Sitzungs-Timeout.

Übersicht

Feld	Pflicht	Zweck
Lizenzschlüssel	ja	Lizenz für die Node selbst (cotec it-systeme)
Basis-URL	ja	Adresse der slmobileApi
Benutzername	ja	SelectLine-Benutzer
Kennwort	ja	Kennwort des Benutzers
App Key	ja	Anwendungskennung von SelectLine
Standard-Mandant (Datenbankname)	nein	Mandant, in dem gearbeitet wird
Standard-Jahr (Datenbankname)	nein	Geschäftsjahr für Buchhaltungs-Routen
WaWi-Benutzertoken	nein	zusätzliche Warenwirtschafts-Kennung
Sitzungs-Timeout (Minuten)	nein	automatisches Abmelden ungenutzter Sitzungen
Selbstsignierte Zertifikate zulassen	nein	Zertifikatsprüfung abschalten

Lizenzschlüssel

Dieses Feld hat nichts mit SelectLine zu tun. Es ist der Lizenzschlüssel für die Node selbst, den Sie von cotec it-systeme erhalten.

Vor jeder Ausführung prüft die Node den Schlüssel gegen den Lizenzserver (https://license.cotec-it-systeme.de). Die Antwort ist digital signiert und wird lokal verifiziert — eine manipulierte oder gefälschte Antwort wird nicht akzeptiert. Das Ergebnis wird zwischengespeichert:

• gültig → eine Stunde lang keine erneute Prüfung
• ungültig / abgelaufen / widerrufen → Ausführung wird abgebrochen, erneute Prüfung nach 10 Minuten (ein neu ausgestellter Schlüssel greift also schnell)
• Lizenzserver nicht erreichbar → die Ausführung läuft weiter, es wird lediglich eine Warnung ins Ausführungsprotokoll geschrieben; erneuter Versuch nach 15 Minuten

Die Node blockiert also nur dann, wenn der Lizenzserver nachweislich und signiert „nein“ sagt — ein Netzwerkausfall legt Ihre Workflows nicht still.

Zur Sitzplatzzählung wird ein anonymer Fingerabdruck der Installation übertragen (SHA-256 aus Hostname und Basis-URL). Es werden keine personenbezogenen Daten und keine Inhalte aus Ihrem SelectLine übermittelt.

Fehlender Schlüssel

Ist das Feld leer, bricht die Ausführung mit „Kein Lizenzschlüssel hinterlegt“ ab. Der Verbindungstest der Anmeldedaten prüft die Lizenz nicht — ein erfolgreicher Test bedeutet nur, dass der SelectLine-Zugang stimmt.

Basis-URL

Basisadresse der slmobileApi, ohne abschließenden Schrägstrich. Jeder Aufruf wird daran angehängt (/Login, /Logout, /Users/Current, /Customers …).

https://slmobile.local.host/slmobileApi

Das Feld ist bewusst nicht vorbelegt — eine geratene Adresse würde entweder nicht funktionieren oder, schlimmer, auf einen fremden Server zeigen. Den für Sie gültigen Wert erfragen Sie bei Ihrem SelectLine-Administrator.

Benutzername, Kennwort und App Key

Diese drei Felder werden gemeinsam an POST /Login geschickt und ergeben ein Zugriffstoken, das die Node anschließend für alle weiteren Aufrufe verwendet.

• Benutzername / Kennwort — ein SelectLine-Benutzer mit den Rechten, die Ihre Workflows benötigen. Empfohlen wird ein eigener technischer Benutzer statt eines persönlichen Kontos.
• App Key — die von SelectLine vergebene Anwendungskennung. Sie identifiziert die Anwendung gegenüber der API, nicht den Benutzer. Ohne gültigen App Key schlägt die Anmeldung fehl, auch wenn Benutzername und Kennwort stimmen.

Benutzer und App Key bilden zusammen die Kennung, unter der die Node ihre Sitzung zwischenspeichert. Zwei Anmeldedaten-Sätze mit unterschiedlichem Benutzer oder App Key nutzen also getrennte Sitzungen.

Standard-Mandant, Standard-Jahr und WaWi-Benutzertoken

Eine SelectLine-Sitzung arbeitet immer in genau einem Mandanten. Diese drei Felder legen fest, in welchem — sie werden unmittelbar nach jeder Anmeldung per PUT /Users/Current gesetzt, noch bevor der erste fachliche Aufruf erfolgt.

Standard-Mandant (Datenbankname) — der Datenbankname des Mandanten (max. 14 Zeichen). Sie finden ihn über die Ressource Mandanten → Get Many im Feld Name. Bleibt das Feld leer, wird der Mandant verwendet, den der SelectLine-Server vorgibt.

Standard-Jahr (Datenbankname) — optionales Geschäftsjahr (max. 19 Zeichen), das zusammen mit dem Mandanten gesetzt wird. Buchhaltungs-Routen benötigen ein aktives Jahr — bleibt das Feld leer, schlagen sie unter Umständen fehl.

WaWi-Benutzertoken — optionale zusätzliche Warenwirtschafts-Kennung (2 Zeichen), die ebenfalls mit gesetzt wird.

Warum kein Auswahlfeld?

n8n erlaubt in Anmeldedaten keine Auswahllisten, die ihre Werte per API nachladen. Deshalb sind die drei Felder Freitext. Ermitteln Sie den Datenbanknamen einmalig über Mandanten → Get Many und tragen Sie ihn hier ein.

Fehlerbild

Lässt sich der Mandant nicht setzen (Tippfehler im Datenbanknamen, fehlende Berechtigung, kein gültiges Jahr), meldet die Node

Mandant/Jahr konnte für die Sitzung nicht gesetzt werden: …

und nicht etwa einen Anmeldefehler. Die halb eingerichtete Sitzung wird dabei sofort wieder abgemeldet — es bleibt nichts auf dem Server zurück.

Mandant im laufenden Workflow wechseln

Über Nutzer → Aktuellen Benutzer aktualisieren lässt sich der Mandant mitten im Workflow umstellen. Der Wechsel gilt ab diesem Punkt für den Rest derselben Workflow-Ausführung; parallel laufende Ausführungen und andere Workflows bleiben unberührt in ihrem eigenen Mandanten.

Sitzungs-Timeout (Minuten)

Standardwert: 15

Jede Anmeldung öffnet auf dem SelectLine-Server eine Sitzung — praktisch eine ERP-Instanz, die Arbeitsspeicher belegt. Diese Sitzungen laufen von selbst nicht ab: Sie verschwinden nur durch eine ausdrückliche Abmeldung oder wenn sie serverseitig gesammelt beendet werden.

Die Node geht deshalb sparsam damit um: Sie hält pro Anmeldedaten-Satz und Mandant genau eine Sitzung offen und verwendet sie über alle Ausführungen hinweg wieder. Melden sich mehrere Workflows gleichzeitig an, wird trotzdem nur eine einzige Sitzung geöffnet.

Dieses Feld bestimmt, nach welcher Zeit ungenutzte Sitzungen automatisch abgemeldet werden:

• 15 Minuten (Standard) — guter Kompromiss für die meisten Installationen.
• Höherer Wert — sinnvoll bei Workflows, die im festen Takt (z. B. stündlich) laufen und die Anmeldung einsparen sollen. Kostet dafür dauerhaft Arbeitsspeicher auf dem Server.
• 0 — schaltet das automatische Abmelden ab. Sitzungen bleiben dann offen, bis sie ausdrücklich über Konto → Abmelden beendet werden.

Caution

0 ohne ein abschließendes Konto → Abmelden im Workflow lässt Sitzungen auf dem SelectLine-Server dauerhaft liegen. Setzen Sie den Wert nur auf 0, wenn Sie die Abmeldung selbst steuern.

Für den geordneten Abschluss eines Workflows steht die Ressource Konto mit der Operation Abmelden bereit. Sie gibt die Sitzung sofort auf dem Server frei.

Selbstsignierte Zertifikate zulassen

Standardmäßig aus. Eingeschaltet akzeptiert die Node auch TLS-Zertifikate, die nicht überprüft werden können — gedacht für lokale Installationen mit selbst ausgestelltem Zertifikat.

Die Einstellung wirkt auf alle ausgehenden Verbindungen der Node: Anmeldung, Abmeldung, Mandantenwechsel, fachliche Aufrufe, PDF-Downloads und die Lizenzprüfung.

Caution

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.

Verbindungstest

Die Schaltfläche Test in den n8n-Anmeldedaten führt eine einzelne Anmeldung (POST /Login) mit Benutzername, Kennwort und App Key aus.

Sie prüft damit:

• ✅ ob die Basis-URL erreichbar ist
• ✅ ob Benutzername, Kennwort und App Key stimmen

Sie prüft nicht:

• ❌ den Lizenzschlüssel
• ❌ ob der Standard-Mandant und das Standard-Jahr gültig sind

Ein grüner Test bedeutet also „der SelectLine-Zugang stimmt“ — nicht „alles ist korrekt eingerichtet“. Führen Sie zusätzlich einmal eine echte Operation aus, etwa Mandanten → Get Many.